पेज डेटा प्राप्त करें

जिन वर्कफ़्लो में पेज डेटा की आवश्यकता होती है, उनमें आप अपने स्टोर से पेज की जानकारी प्राप्त करने के लिए Get page data एक्शन का इस्तेमाल कर सकते हैं। पेज आपके ऑनलाइन स्टोर पर ऐसे वेब पेज होते हैं जिनमें वह जानकारी होती है जो शायद ही कभी बदलती है, जैसे कि हमारे बारे में पेज या संपर्क पेज।

नोट

यह एक प्रकार का Get data एक्शन है। Scheduled time ट्रिगर और For each लूप के साथ इस प्रकार के एक्शन का इस्तेमाल करने का तरीका समझने के लिए, Schedules, get data, and looping workflows in Shopify Flow देखें।

कॉन्फ़िगरेशन

फ़ील्ड

Get page data एक्शन में निम्नलिखित फ़ील्ड शामिल हैं:

Get data एक्शन में इस्तेमाल की गई फ़ील्ड।

फ़ील्ड	विवरण
डेटा को इसके अनुसार सॉर्ट करें	ज़रूरी है। वे पैरामीटर जिनके द्वारा सर्च क्वेरी से रिटर्न किए गए डेटा को सॉर्ट किया जाता है।
परिणामों की अधिकतम संख्या	ज़रूरी है। आपके द्वारा चुनी गई सर्च क्वेरी से रिटर्न किए जा सकने वाले परिणामों की अधिकतम संख्या। आप एक बार में 100 तक रिटर्न कर सकते हैं।
क्वेरी	ज़रूरी है। सामान्य क्वेरी में से चुनें या अपनी खुद की क्वेरी बनाने के लिए Advanced चुनें।

क्वेरी स्ट्रिंग

पब्लिश किए गए पेज प्राप्त करने के लिए यह एक उदाहरण क्वेरी है:

published_status:published

published_status वेरिएबल Pages query पर उपलब्ध एक फ़िल्टर है और इसका इस्तेमाल कई बार किया जा सकता है या अन्य वेरिएबल के साथ जोड़ा जा सकता है।

डेटा को क्वेरी करते समय, यह जानना मददगार होता है:

• उपलब्ध पेज फ़िल्टर की लिस्ट

• क्वेरी को एक निश्चित सिंटैक्स का पालन करना चाहिए

• क्वेरी फ़ील्ड वैल्यू हमेशा डॉक्यूमेंट नहीं होती हैं। कुछ मामलों में, API डॉक्स देखकर वैल्यू पाई जा सकती हैं। इसके अलावा, जब आप फ़िल्टर करते हैं, तो अक्सर एडमिन के URL में फ़ील्ड वैल्यू मिल सकती हैं। उदाहरण के लिए, कुछ ऑर्डर क्वेरी वैल्यू खोजने के लिए, एडमिन में ऑर्डर पेज को फ़िल्टर करें और फिर URL चेक करें।

• आप Shopify GraphiQL ऐप का इस्तेमाल करके अपने शॉप में क्वेरी चला सकते हैं या टेस्ट कर सकते हैं।

• ध्यान रखें कि अगर आपकी क्वेरी विफल हो जाती है, तो क्या होता है। अक्सर API (कुछ नहीं के बजाय) सभी परिणाम रिटर्न करेगा।

रिटर्न किया गया डेटा

सभी Get data एक्शन 0 से 100 तक रिसोर्स की लिस्ट रिटर्न करते हैं। अपने उपयोग के मामले के आधार पर, आप इस डेटा का इस्तेमाल अलग-अलग तरीकों से करना चाह सकते हैं:

• अगर आपको हर लिस्ट आइटम को अलग-अलग हैंडल करने की आवश्यकता है, जैसे कि प्रत्येक के लिए टैग जोड़ना, तो आप For each एक्शन का इस्तेमाल कर सकते हैं।
• अगर आपको डेटा एग्रीगेट करने की आवश्यकता है, जैसे कि कितने परिणाम रिटर्न किए गए यह गिनना, तो आप Count या Sum एक्शन का इस्तेमाल कर सकते हैं।
• अगर आपको लिस्ट आउटपुट करने की आवश्यकता है, जैसे कि सभी आइटम वाला ईमेल भेजना, तो आप बाद वाले एक्शन में सीधे रिटर्न किए गए डेटा का इस्तेमाल कर सकते हैं।

इस एक्शन के बाद वाले चरणों में रिटर्न किए गए डेटा को एक्सेस करने के लिए, Get page data नामक वेरिएबल का इस्तेमाल करें, जो पेज की एक लिस्ट है। आप इस वेरिएबल का इस्तेमाल कंडीशन और एक्शन, दोनों में कर सकते हैं। उदाहरण के लिए, आप पेज की लिस्ट को Send internal email एक्शन में कुछ इस तरह भेज सकते हैं:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

नोट

अगर एक ही वर्कफ़्लो में Get data एक्शन का कई बार इस्तेमाल किया जाता है, तो वेरिएबल नाम में एक नंबर जुड़ जाता है। उदाहरण के लिए, एक वर्कफ़्लो जिसमें Get order data एक्शन का इस्तेमाल दो बार किया जाता है, उसमें रिटर्न किए गए डेटा का पहला वेरिएबल getOrderData होता है और दूसरा वेरिएबल getOrderData1 होता है। इस नाम को कस्टमाइज़ नहीं किया जा सकता।

ट्रिगर

आप इस एक्शन का इस्तेमाल Scheduled time ट्रिगर सहित किसी भी वर्कफ़्लो में कर सकते हैं। Scheduled time ट्रिगर का इस्तेमाल करने वाले वर्कफ़्लो में, वर्कफ़्लो किसी इवेंट के परिणाम के बजाय आपके द्वारा निर्दिष्ट समय पर शुरू होता है। क्योंकि आपके स्टोर में या किसी ऐप से ऐसा कोई खास इवेंट नहीं है जो वर्कफ़्लो शुरू करता हो, इसलिए इसमें अपने-आप कोई डेटा शामिल नहीं होता है।

API रेफरेंस

इस एक्शन में इस्तेमाल किए गए API के बारे में ज़्यादा जानकारी के लिए, Pages query देखें।