Shopify Flow में इस्तेमाल किए गए API डेटा का प्रीव्यू

ज़्यादातर वर्कफ़्लो आपके स्टोर से डेटा एक्सेस करते हैं, ताकि आप इसे शर्तों और एक्शन में उपयोग कर सकें। Shopify Flow, GraphQL Admin API को कॉल करके स्टोर डेटा एक्सेस करता है, जिससे आपको API के लगभग सभी फ़ील्ड का एक्सेस मिलता है।

जब आप कोई वर्कफ़्लो बनाते हैं, तो आपको अक्सर API पर आधारित फ़ील्ड के नाम और विवरण मिलेंगे, लेकिन हो सकता है कि आपको उस डेटा के मान जानने की ज़रूरत हो. उदाहरण के लिए, हो सकता है कि आप किसी ऐसे ऑर्डर के लिए ऐप का नाम जानना चाहें, जो किसी ड्राफ़्ट ऑर्डर से बनाया गया था. इसके अलावा, हो सकता है कि आप यह सुनिश्चित करना चाहें कि आपका वर्कफ़्लो आपके अपेक्षित डेटा या अपेक्षित फ़ॉर्म में डेटा को आउटपुट करता है.

डेटा के मान की समीक्षा करने के लिए, Shopify Flow में आपके पास कई विकल्प हैं.

Shopify एडमिन में कोई फ़ील्ड ढूंढें

ज़्यादातर मामलों में, आप Shopify एडमिन में देखकर डेटा ढूंढ सकते हैं. उदाहरण के लिए, product.title, उत्पाद पेज पर सूचीबद्ध है.

सैंपल डेटा पाएं

जब आप कोई वर्कफ़्लो बनाते हैं, तो आप सीधे Flow एडिटर में सैंपल डेटा पा सकते हैं. चूंकि Flow का डेटा इवेंट से आता है, इसलिए सटीक सैंपल डेटा पाने के लिए, आपको पहले किसी प्रासंगिक इवेंट को चुनना होगा:

1. Flow के एडिटर में, एक ऐसी कार्रवाई खोलें जहां आप डेटा का इस्तेमाल करना चाहते हैं और कोई वैरिएबल जोड़ें पर क्लिक करें. वैकल्पिक रूप से, किसी स्थिति में, मानदंड जोड़ें पर क्लिक करें.
2. सैंपल डेटा कॉन्फ़िगर करें पर क्लिक करें.
3. Flow, वर्कफ़्लो के ट्रिगर के आधार पर पिछले इवेंट दिखाता है. हाल के रन से इवेंट फ़ेच करने के लिए इवेंट रीफ़्रेश करें पर क्लिक करें या लाइव इवेंट सुनना शुरू करें पर क्लिक करें और फिर एडमिन या संबंधित ऐप (ऐप-आधारित ट्रिगर के लिए) में इवेंट को मैन्युअल रूप से ट्रिगर करें.
4. इवेंट होने के बाद, Flow उस इवेंट के बारे में विवरण दिखाएगा. सैंपल डेटा पाने के लिए आप जिस इवेंट का इस्तेमाल करना चाहते हैं उसे चुनें. इस ट्रिगर इवेंट का इस्तेमाल करें पर क्लिक करें.
5. अब, जब आप इवेंट ब्राउज़ करते हैं, तो हर वैरिएबल के लिए सैंपल डेटा दिखना चाहिए.

सीमाएं:

• जगह की कमी के कारण, किसी सूची में डेटा के लिए, Flow केवल सूची में पहले आइटम का डेटा दिखाएगा.
• Flow, हर वर्कफ़्लो के लिए एक बार में 5 इवेंट तक स्टोर करेगा.
• Flow, कुछ ट्रिगर जैसे शेड्यूल किया गया समय, मेटा-ऑब्जेक्ट एंट्री बनाई गई, ग्राहक सेगमेंट में शामिल हुआ या ग्राहक ने सेगमेंट छोड़ा, के लिए हाल के रन से इवेंट फ़ेच नहीं कर सकता.

लाइव वर्कफ़्लो में फ़ील्ड का इस्तेमाल करें

आप लॉग आउटपुट कार्रवाई का इस्तेमाल करके किसी वर्कफ़्लो में फ़ील्ड का सुरक्षित रूप से इस्तेमाल कर सकते हैं. जब आप कोई वर्कफ़्लो चलाते हैं, तो लॉग आउटपुट कार्रवाई किसी भी वैरिएबल और टेक्स्ट के आउटपुट को रन इतिहास पेज पर प्रिंट कर देगी. आप आंतरिक ईमेल भेजें जैसी नोटिफ़िकेशन कार्रवाइयों का भी इस्तेमाल कर सकते हैं.

लॉग आउटपुट का इस्तेमाल करने के चरण:

1. एक ऐसा ट्रिगर चुनें, जिसे मैन्युअल रूप से ट्रिगर किया जा सकता हो.
2. वर्कफ़्लो में लॉग आउटपुट कार्रवाई जोड़ें और इसे ट्रिगर से कनेक्ट करें.
3. लॉग आउटपुट कॉन्फ़िगरेशन में, जिन वैरिएबल का आप निरीक्षण करना चाहते हैं, उन्हें आउटपुट सेक्शन में जोड़ने के लिए कोई वैरिएबल जोड़ें पर क्लिक करें.
4. जब हो जाए, तो वर्कफ़्लो चालू करें पर क्लिक करें.
5. वर्कफ़्लो को या तो मैन्युअल रूप से चलाकर या ट्रिगर को शुरू करके ट्रिगर करें. उदाहरण के लिए, अगर आप ऑर्डर बनाया गया ट्रिगर का इस्तेमाल कर रहे हैं, तो एक टेस्ट ऑर्डर बनाएं.
6. वर्कफ़्लो चलने के बाद, वैरिएबल के लिए एक्टिविटी लॉग देखें.

संसाधन JSON पेज देखें

Shopify एडमिन में ज़्यादातर संसाधन पेज, जैसे कि ऑर्डर, उत्पाद या ग्राहक पेज, आपको उस डेटा को देखने की अनुमति देते हैं जो पेज को सर्व करता है. यह डेटा ठीक वैसा ही नामकरण और फ़ॉर्मैट नहीं है जिसका इस्तेमाल Shopify Flow करता है, लेकिन मान GraphQL Admin API में जो है उससे मेल खाते हैं. डेटा की समीक्षा करने के लिए, URL में .json जोड़ें.

उदाहरण के लिए, Shopify एडमिन में ऑर्डर पेज पर जाकर और किसी ऑर्डर पर क्लिक करके उस ऑर्डर पर नेविगेट करें. अपने ब्राउज़र के एड्रेस बार में पेज के पते में, पते को इससे बदलें:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234

निम्नलिखित में:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json

GraphiQL या किसी थर्ड-पार्टी API टूल का इस्तेमाल करें

आप Postman जैसे किसी थर्ड-पार्टी API टूल या Shopify द्वारा दिए गए फ़्री टूल GraphiQL का इस्तेमाल करके सीधे API से क्वेरी कर सकते हैं. यह विकल्प सबसे सटीक नतीजे देता है, लेकिन इसके लिए GraphQL क्वेरी बनाने की कुछ जानकारी होना ज़रूरी है.

GraphiQL के लिए, Shopify जेनेरिक डेटा के साथ वेब-आधारित GraphiQL एक्सप्लोरर और GraphiQL ऐप दोनों ऑफ़र करता है. GraphiQL के साथ, आप एक ऐसी GraphQL क्वेरी बना सकते हैं जो Shopify Flow में फ़ील्ड नामों से बिल्कुल मेल खाती है. अगर आप ऐप का इस्तेमाल करते हैं तो मान आपके स्टोर से भी बिल्कुल मेल खाते हैं.

इस टूल का इस्तेमाल करके, आप अपने असली दुकान के डेटा के साथ यह तय कर सकते हैं कि Shopify Flow ठीक किस डेटा का इस्तेमाल करता है. उदाहरण के लिए, आप नीचे दी गई क्वेरी बनाते हैं:

{
  orders(first:5, reverse:true) {
    nodes {
      createdAt
      app {
        name
      }
      channelInformation {
        app {
          title
        }
      }
    }
  }
}

नीचे दिए गए नतीजों में, वैरिएबल order / app / name ऑर्डर के लिए ऐप का नाम दिखाता है. इस मामले में, ऑर्डर ड्राफ़्ट ऑर्डर ऐप से बनाया गया था, इसलिए मान Draft Orders है. चैनल की जानकारी सिर्फ़ Point of Sale ऐप के लिए उपलब्ध है.

{
  "data": {
    "orders": {
      "nodes": [
        {
          "createdAt": "2023-04-10T12:32:41Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-04-10T12:29:12Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:23:10Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:20:53Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T15:45:15Z",
          "app": {
            "name": "Point of Sale"
          },
          "channelInformation": {
            "app": {
              "title": "Point of Sale"
            }
          }
        }
      ]
    }
  }