आर्टिकल डेटा प्राप्त करें
ऐसे वर्कफ़्लो जिनमें ब्लॉग आर्टिकल डेटा की ज़रूरत होती है, आप अपने Shopify स्टोर से आर्टिकल की जानकारी वापस पाने के लिए आर्टिकल डेटा प्राप्त करें एक्शन का इस्तेमाल कर सकते हैं।
कॉन्फ़िगरेशन
फ़ील्ड
आर्टिकल डेटा प्राप्त करें एक्शन में निम्नलिखित फ़ील्ड शामिल हैं:
| फ़ील्ड | विवरण |
|---|---|
| डेटा को इससे सॉर्ट करें | ज़रूरी है। वे पैरामीटर जिनके द्वारा सर्च क्वेरी से लौटाया गया डेटा सॉर्ट किया जाता है। |
| नतीजों की अधिकतम संख्या | ज़रूरी है। आपके द्वारा चुनी गई सर्च क्वेरी से लौटाए जा सकने वाले नतीजों की अधिकतम संख्या। आप एक बार में 100 तक नतीजे लौटा सकते हैं। |
| क्वेरी | ज़रूरी है। सामान्य क्वेरी में से चुनें या अपनी खुद की क्वेरी बनाने के लिए एडवांस्ड चुनें। |
क्वेरी स्ट्रिंग
पिछले दिन प्रकाशित हुए आर्टिकल प्राप्त करने के लिए यह एक उदाहरण क्वेरी है:
published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'published_at वैरिएबल, आर्टिकल क्वेरी पर उपलब्ध एक फ़िल्टर है और इसका इस्तेमाल कई बार या अन्य वैरिएबल के साथ मिलाकर किया जा सकता है। scheduledAt लिक्विड वैरिएबल उन वर्कफ़्लो पर उपलब्ध है जो शेड्यूल किया गया समय ट्रिगर का इस्तेमाल करते हैं। date_minus लिक्विड टैग एक खास Flow टैग है जो आपको तारीख से समय घटाने की सुविधा देता है।
डेटा की क्वेरी करते समय, यह जानना उपयोगी है:
क्वेरी को एक तय सिंटैक्स का पालन करना चाहिए
क्वेरी फ़ील्ड की वैल्यू हमेशा प्रलेखित (documented) नहीं होती हैं। कुछ मामलों में, API दस्तावेज़ देखकर वैल्यू खोजी जा सकती हैं। इसके अलावा, फ़िल्टर करते समय आपको अक्सर एडमिन में URL के अंदर फ़ील्ड वैल्यू मिल सकती हैं। उदाहरण के लिए, कुछ ऑर्डर क्वेरी वैल्यू खोजने के लिए, एडमिन में ऑर्डर पेज को फ़िल्टर करें और फिर URL देखें।
आप Shopify GraphiQL ऐप का इस्तेमाल करके अपने शॉप में क्वेरी को चला सकते हैं या टेस्ट कर सकते हैं।
अगर आपकी क्वेरी विफल हो जाती है, तो ध्यान रखें कि क्या होता है। अक्सर API (शून्य के बजाय) सभी नतीजे लौटाता है।
लौटाया गया डेटा
सभी डेटा प्राप्त करें एक्शन 0 और 100 संसाधनों के बीच की सूची लौटाते हैं। आपके उपयोग के मामले (use case) के आधार पर, आप इस डेटा का अलग-अलग तरीकों से इस्तेमाल करना चाह सकते हैं:
- अगर आपको सूची के हर आइटम को अलग से हैंडल करने की ज़रूरत है, जैसे कि हर एक के लिए टैग जोड़ना, तो आप For each एक्शन का इस्तेमाल कर सकते हैं।
- अगर आपको डेटा एग्रीगेट करने की ज़रूरत है, जैसे कि कितने नतीजे लौटाए गए, इसकी गिनती करना, तो आप Count या Sum एक्शन का इस्तेमाल कर सकते हैं।
- अगर आपको सूची को आउटपुट करने की ज़रूरत है, जैसे कि सभी आइटम के साथ ईमेल भेजना, तो आप बाद के एक्शन में सीधे लौटाए गए डेटा का इस्तेमाल कर सकते हैं।
इस एक्शन के बाद के चरणों में लौटाए गए डेटा तक पहुंचने के लिए, आर्टिकल डेटा प्राप्त करें (Get article data) नाम के वैरिएबल का उपयोग करें, जो आर्टिकल की एक सूची है। आप इस वैरिएबल का इस्तेमाल शर्तों और एक्शन, दोनों में कर सकते हैं। उदाहरण के लिए, आप इसके जैसे किसी आंतरिक ईमेल भेजें (Send internal email) एक्शन में आर्टिकल की सूची भेज सकते हैं:
{% for single_article in GetArticleData %}
* {{ single_article.title }}
{% endfor %}ट्रिगर
आप इस एक्शन का इस्तेमाल शेड्यूल किया गया समय ट्रिगर सहित किसी भी वर्कफ़्लो में कर सकते हैं। शेड्यूल किया गया समय ट्रिगर का इस्तेमाल करने वाले वर्कफ़्लो में, वर्कफ़्लो किसी इवेंट के परिणाम के बजाय आपके द्वारा निर्दिष्ट समय पर शुरू होता है। क्योंकि आपके स्टोर में या किसी ऐप से ऐसा कोई विशिष्ट इवेंट नहीं है जो वर्कफ़्लो शुरू करता है, इसलिए कोई भी डेटा ऑटोमैटिक तौर पर शामिल नहीं होता है।
API संदर्भ
इस एक्शन में इस्तेमाल किए गए API के बारे में अधिक जानकारी के लिए, आर्टिकल क्वेरी देखें।