मेटा-ऑब्जेक्ट एंट्री पाएं.
आप वैकल्पिक क्वेरी के आधार पर अपने स्टोर से मेटा-ऑब्जेक्ट के लिए एंट्री की सूची फिर से पाने के लिए मेटा-ऑब्जेक्ट एंट्री पाएं कार्रवाई का उपयोग कर सकते हैं। अधिक जानकारी के लिए मेटा-ऑब्जेक्ट दस्तावेज़ देखें।
कॉन्फ़िगरेशन.
फ़ील्ड.
मेटा-ऑब्जेक्ट एंट्री पाएं कार्रवाई में मेटा-ऑब्जेक्ट परिभाषा को निर्दिष्ट करने के लिए एक ड्रॉपडाउन के साथ-साथ निम्नलिखित फ़ील्ड भी शामिल हैं, जिनका उपयोग क्वेरी बनाने के लिए किया जाता है:
| फ़ील्ड | विवरण |
|---|---|
| इसके अनुसार डेटा सॉर्ट करें | आवश्यक। वे पैरामीटर जिनके द्वारा सर्च क्वेरी से वापस मिला डेटा सॉर्ट किया जाता है। |
| परिणामों की अधिकतम संख्या | आवश्यक। आपके द्वारा चुनी गई सर्च क्वेरी से लौटाए जा सकने वाले परिणामों की अधिकतम संख्या। आप एक बार में 100 तक परिणाम लौटा सकते हैं। |
| क्वेरी. | ज़रूरी. सामान्य क्वेरी में से चुनें या अपनी क्वेरी बनाने के लिए उन्नत चुनें. |
क्वेरी स्ट्रिंग
अगर किसी ईमेल फ़ील्ड का मान किसी ऑर्डर पर दिए गए ईमेल पते से मेल खाता है, तो मेटा-ऑब्जेक्ट एंट्री पाने के लिए यह एक उदाहरण क्वेरी है:
{{fields.email}}:"{{order.email}}"यह उन मेटा-ऑब्जेक्ट एंट्री को पाने के लिए एक उदाहरण क्वेरी है जिन्हें पिछले दिन अपडेट किया गया था:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'updated_at वैरिएबल, मेटा-ऑब्जेक्ट क्वेरी पर उपलब्ध एक फ़िल्टर है और इसका इस्तेमाल कई बार किया जा सकता है या दूसरे वैरिएबल के साथ जोड़ा जा सकता है। scheduledAt लिक्विड वैरिएबल उन वर्कफ़्लो पर उपलब्ध है, जो शेड्यूल किए गए समय के ट्रिगर का इस्तेमाल करते हैं। date_minus Liquid टैग एक विशेष Flow टैग है, जो आपको किसी तारीख से समय घटाने की सुविधा देता है।
डेटा की क्वेरी करते समय, यह जानना मददगार होता है:
- उपलब्ध मेटा-ऑब्जेक्ट फ़िल्टर की सूची
- फ़ील्ड मान के अनुसार मेटा-ऑब्जेक्ट की क्वेरी करने के लिए यह ज़रूरी है कि मेटा-ऑब्जेक्ट में फ़िल्टरिंग सक्षम हो, जिसे Shopify एडमिन में कस्टम डेटा के विकल्पों में सक्षम किया जा सकता है।
- क्वेरी को एक निश्चित सिंटैक्स का पालन करना होगा
- क्वेरी फ़ील्ड के मान हमेशा डॉक्युमेंटेड नहीं होते हैं। कुछ मामलों में, ये मान API डॉक्स देखकर मिल सकते हैं। वैकल्पिक रूप से, जब आप एडमिन में फ़िल्टर करते हैं, तो आप अक्सर फ़ील्ड के मान URL में पा सकते हैं। उदाहरण के लिए, ऑर्डर क्वेरी के कुछ मान खोजने के लिए, एडमिन में ऑर्डर पेज को फ़िल्टर करें और फिर URL देखें।
- आप Shopify GraphiQL ऐप का इस्तेमाल करके अपने स्टोर में किसी क्वेरी को चला सकते हैं या उसकी जांच कर सकते हैं।
- ध्यान रखें कि आपकी क्वेरी के विफल होने पर क्या होता है। अक्सर API कोई भी परिणाम नहीं लौटाने के बजाय सभी परिणाम लौटाता है।
लौटाया गया डेटा
सभी डेटा पाएं कार्रवाइयां 0 और 100 के बीच संसाधनों की एक सूची लौटाती हैं। आपके उपयोग के आधार पर, आप इस डेटा का कई तरीकों से उपयोग करना चाह सकते हैं:
- अगर आपको सूची के हर आइटम को अलग-अलग प्रबंधित करना है, जैसे कि हर आइटम के लिए एक टैग जोड़ना, तो आप प्रत्येक के लिए कार्रवाई का उपयोग कर सकते हैं।
- अगर आपको डेटा एकत्र करने की ज़रूरत है, जैसे कि यह गिनना कि कितने परिणाम लौटाए गए थे, तो आप गिनती या जोड़ कार्रवाइयों का इस्तेमाल कर सकते हैं।
- अगर आपको सूची को आउटपुट करना है, जैसे कि सभी आइटम के साथ एक ईमेल भेजना, तो आप बाद की कार्रवाइयों में लौटाए गए डेटा का सीधे उपयोग कर सकते हैं।
इस कार्रवाई के बाद के चरणों में लौटाए गए डेटा को एक्सेस करने के लिए, मेटा-ऑब्जेक्ट एंट्री पाएं नामक वैरिएबल का उपयोग करें, जो मेटा-ऑब्जेक्ट एंट्री की एक सूची है। आप इस वैरिएबल का उपयोग स्थितियों और कार्रवाइयों दोनों में कर सकते हैं। उदाहरण के लिए, आप आंतरिक ईमेल भेजें कार्रवाई में मेटा-ऑब्जेक्ट एंट्री के लिए की-वैल्यू पेयर की सूची इस तरह भेज सकते हैं:
{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
{% for fields_item in getMetaobjectEntries_item.system.fields %}
{{fields_item.key}}:{{fields_item.value}}
{% endfor %}
{% endfor %}ट्रिगर
आप इस कार्रवाई का उपयोग किसी भी वर्कफ़्लो में कर सकते हैं, जिसमें शेड्यूल किया गया समय ट्रिगर भी शामिल है। शेड्यूल किया गया समय ट्रिगर का उपयोग करने वाले वर्कफ़्लो में, वर्कफ़्लो आपके द्वारा निर्दिष्ट समय पर शुरू होता है, न कि किसी इवेंट के परिणामस्वरूप। चूंकि आपके स्टोर में या किसी ऐप से कोई विशेष इवेंट नहीं है जो वर्कफ़्लो शुरू करता है, इसलिए कोई डेटा अपने-आप शामिल नहीं होता है।