इन्वेंट्री आइटम डेटा प्राप्त करें
उन वर्कफ़्लो में जिन्हें इन्वेंट्री आइटम डेटा की आवश्यकता होती है, आप अपने स्टोर से इन्वेंट्री आइटम की जानकारी प्राप्त करने के लिए Get inventory item data कार्रवाई का उपयोग कर सकते हैं। इन्वेंट्री आइटम उन वास्तविक स्टॉक यूनिट को दर्शाते हैं जिन्हें उत्पाद प्रकारों के लिए ट्रैक किया जाता है।
कॉन्फ़िगरेशन
फ़ील्ड
Get inventory item data कार्रवाई में निम्नलिखित फ़ील्ड शामिल हैं:
| फ़ील्ड | विवरण |
|---|---|
| इसके अनुसार डेटा को सॉर्ट करें | आवश्यक है। वे पैरामीटर जिनके द्वारा सर्च क्वेरी से प्राप्त डेटा को सॉर्ट किया जाता है। |
| परिणामों की अधिकतम संख्या | आवश्यक है। आपके द्वारा चुनी गई सर्च क्वेरी से प्राप्त होने वाले परिणामों की अधिकतम संख्या। आप एक बार में 100 तक परिणाम प्राप्त कर सकते हैं। |
| क्वेरी | आवश्यक है। सामान्य क्वेरी में से चुनें या अपनी खुद की क्वेरी बनाने के लिए एडवांस्ड चुनें। |
क्वेरी स्ट्रिंग
ट्रैक किए जाने वाले इन्वेंट्री आइटम प्राप्त करने के लिए यह एक उदाहरण क्वेरी है:
tracked:truetracked वेरिएबल, Inventory items query पर उपलब्ध एक फ़िल्टर है और इसका इस्तेमाल कई बार या अन्य वेरिएबल के साथ मिलाकर किया जा सकता है।
डेटा क्वेरी करते समय, यह जानना उपयोगी होता है:
क्वेरी को एक विशिष्ट सिंटैक्स का पालन करना चाहिए
क्वेरी फ़ील्ड वैल्यू हमेशा डॉक्यूमेंटेड नहीं होती हैं। कुछ मामलों में, API डॉक्स देखकर वैल्यू मिल सकती हैं। इसके अलावा, फ़िल्टर करते समय आप अक्सर एडमिन के URL में फ़ील्ड वैल्यू पा सकते हैं। उदाहरण के लिए, कुछ ऑर्डर क्वेरी वैल्यू खोजने के लिए, एडमिन में ऑर्डर पेज को फ़िल्टर करें और फिर URL देखें।
आप Shopify GraphiQL ऐप का उपयोग करके अपने शॉप में क्वेरी चला सकते हैं या टेस्ट कर सकते हैं।
ध्यान रखें कि यदि आपकी क्वेरी विफल हो जाती है, तो क्या होता है। अक्सर API (कुछ नहीं के बजाय) सभी परिणाम लौटाएगा।
लौटाया गया डेटा
सभी Get data कार्रवाइयां 0 से 100 रिसोर्स तक की सूची लौटाती हैं। आपके उपयोग के मामले के आधार पर, आप इस डेटा का अलग-अलग तरीकों से उपयोग कर सकते हैं:
- यदि आपको प्रत्येक सूची आइटम को व्यक्तिगत रूप से हैंडल करने की आवश्यकता है, जैसे कि प्रत्येक के लिए एक टैग जोड़ना, तो आप For each कार्रवाई का उपयोग कर सकते हैं।
- यदि आपको डेटा को एग्रीगेट करने की आवश्यकता है, जैसे यह गिनना कि कितने परिणाम वापस आए, तो आप Count या Sum कार्रवाइयों का उपयोग कर सकते हैं।
- अगर आपको लिस्ट आउटपुट करने की आवश्यकता है, जैसे कि सभी आइटम वाला ईमेल भेजना, तो आप बाद वाले एक्शन में सीधे रिटर्न किए गए डेटा का इस्तेमाल कर सकते हैं।
इस एक्शन के बाद वाले चरणों में रिटर्न किए गए डेटा को एक्सेस करने के लिए, Get inventory item data नामक वेरिएबल का इस्तेमाल करें, जो इन्वेंट्री आइटम की एक लिस्ट है। आप इस वेरिएबल का इस्तेमाल कंडीशन और एक्शन, दोनों में कर सकते हैं। उदाहरण के लिए, आप इन्वेंट्री आइटम की लिस्ट को Send internal email एक्शन में कुछ इस तरह भेज सकते हैं:
{% for single_inventory_item in getInventoryItemData %}
* SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}ट्रिगर
आप इस एक्शन का इस्तेमाल Scheduled time ट्रिगर सहित किसी भी वर्कफ़्लो में कर सकते हैं। Scheduled time ट्रिगर का इस्तेमाल करने वाले वर्कफ़्लो में, वर्कफ़्लो किसी इवेंट के परिणाम के बजाय आपके द्वारा निर्दिष्ट समय पर शुरू होता है। क्योंकि आपके स्टोर में या किसी ऐप से ऐसा कोई खास इवेंट नहीं है जो वर्कफ़्लो शुरू करता हो, इसलिए इसमें अपने-आप कोई डेटा शामिल नहीं होता है।
API रेफरेंस
इस एक्शन में इस्तेमाल किए गए API के बारे में ज़्यादा जानकारी के लिए, Inventory items query देखें।