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