Shopify Flow میں استعمال ہونے والے API ڈیٹا کا پیش نظارہ کریں

زیادہ تر ورک فلو آپ کے سٹور سے ڈیٹا تک رسائی حاصل کرتے ہیں، تاکہ آپ اسے کنڈیشن اور ایکشن میں استعمال کر سکیں۔ Shopify Flow GraphQL Admin API کو کال کر کے سٹور کے ڈیٹا تک رسائی حاصل کرتا ہے، جس سے آپ کو API میں موجود تقریباً تمام فیلڈ تک رسائی مل جاتی ہے۔

جب آپ کوئی ورک فلو بناتے ہیں، تو اکثر آپ کا سامنا API پر مبنی فیلڈ کے ناموں اور تفصیلات سے ہوگا، لیکن آپ کو اس ڈیٹا کی ویلیو جاننے کی ضرورت پڑ سکتی ہے۔ مثال کے طور پر، آپ کسی ایسے آرڈر کے لیے ایپ کا نام جاننا چاہیں گے جو ڈرافٹ آرڈر سے بنایا گیا ہو۔ اس کے علاوہ، آپ یہ یقینی بنانا چاہیں گے کہ آپ کا ورک فلو وہ ڈیٹا آؤٹ پٹ کر رہا ہے جس کی آپ کو توقع ہے، یا اسی شکل میں جس کی آپ کو توقع ہے۔

ڈیٹا کی ویلیو کا جائزہ لینے کے لیے، آپ کے پاس Shopify Flow میں کئی آپشن موجود ہیں۔

اس صفحہ پر

Shopify ایڈمن میں فیلڈ تلاش کریں

زیادہ تر صورتوں میں، آپ Shopify ایڈمن میں دیکھ کر ڈیٹا تلاش کر سکتے ہیں۔ مثال کے طور پر، product.title پروڈکٹ کے صفحہ پر درج ہے۔

سیمپل ڈیٹا حاصل کریں

جب آپ کوئی ورک فلو بناتے ہیں، تو آپ Flow ایڈیٹر میں براہ راست سیمپل ڈیٹا حاصل کر سکتے ہیں۔ چونکہ Flow کا ڈیٹا ایونٹ سے آتا ہے، اس لیے درست سیمپل ڈیٹا حاصل کرنے کے لیے، آپ کو کسی متعلقہ ایونٹ کا انتخاب کر کے شروعات کرنی ہوگی:

Flow کے ایڈیٹر میں، ایک ایسا ایکشن کھولیں جہاں آپ ڈیٹا استعمال کرنا چاہتے ہیں اور ویری ایبل شامل کریں پر کلک کریں۔ متبادل کے طور پر، کسی کنڈیشن میں، کرائٹیریا شامل کریں پر کلک کریں۔
سیمپل ڈیٹا کنفیگر کریں پر کلک کریں۔
Flow ورک فلو کے ٹرگر کی بنیاد پر پچھلے ایونٹ دکھاتا ہے۔ حالیہ رن سے ایونٹ لانے کے لیے ایونٹ ریفریش کریں پر کلک کریں، یا لائیو ایونٹ سننا شروع کریں پر کلک کریں اور پھر ایڈمن یا متعلقہ ایپ (ایپ پر مبنی ٹرگرز کے لیے) میں دستی طور پر ایونٹ کو ٹرگر کریں۔
ایونٹ کے وقوع پذیر ہونے کے بعد، Flow ایونٹ کے بارے میں تفصیلات دکھائے گا۔ سیمپل ڈیٹا حاصل کرنے کے لیے وہ ایونٹ منتخب کریں جسے آپ استعمال کرنا چاہتے ہیں۔ یہ ٹرگر ایونٹ استعمال کریں پر کلک کریں۔
اب، جیسے ہی آپ ایونٹ براؤز کریں گے، ہر ویری ایبل کے لیے سیمپل ڈیٹا ظاہر ہونا چاہیے۔

حدود:

جگہ کی کمی کی وجہ سے، کسی فہرست میں موجود ڈیٹا کے لیے، Flow صرف فہرست کے پہلے آئٹم کا ڈیٹا دکھائے گا۔
Flow فی ورک فلو ایک وقت میں 5 ایونٹ تک اسٹور کرے گا۔
Flow کچھ ٹرگر، جیسے Scheduled time، Metaobject entry created، Customer joined segment، یا Customer left segment کے حالیہ رن سے ایونٹس فیچ نہیں کر سکتا۔

لائیو ورک فلو میں فیلڈ استعمال کریں

آپ Log output ایکشن کا استعمال کر کے ورک فلو میں فیلڈ کو بحفاظت استعمال کر سکتے ہیں۔ جب آپ کوئی ورک فلو رن کرتے ہیں، تو Log output ایکشن کسی بھی ویری ایبل اور ٹیکسٹ کا آؤٹ پٹ Run history پیج پر پرنٹ کرے گا۔ آپ نوٹیفکیشن ایکشن جیسے کہ Send internal email بھی استعمال کر سکتے ہیں۔

Log output استعمال کرنے کے اقدامات:

ایسا ٹرگر منتخب کریں جسے دستی طور پر ٹرگر کیا جا سکے۔
ورک فلو میں Log output ایکشن شامل کریں اور اسے ٹرگر سے کنیکٹ کریں۔
Log output کنفیگریشن میں، Output سیکشن میں ان ویری ایبل کو شامل کرنے کے لیے Add a variable پر کلک کریں جن کا آپ معائنہ کرنا چاہتے ہیں۔
مکمل ہونے پر، Turn on workflow پر کلک کریں۔
ورک فلو کو ٹرگر کریں، یا تو اسے دستی طور پر رن کر کے یا ٹرگر کو فائر کروا کر۔ مثال کے طور پر، اگر آپ Order created ٹرگر استعمال کر رہے ہیں، تو ایک ٹیسٹ آرڈر تخلیق کریں۔
ورک فلو کے رن ہونے کے بعد، ویری ایبل کے لیے ایکٹیویٹی لاگ چیک کریں۔

ریسورس JSON پیج سے رجوع کریں

Shopify ایڈمن میں زیادہ تر ریسورس پیج، جیسے Order، Product، یا Customer پیج، آپ کو وہ ڈیٹا دیکھنے کی اجازت دیتے ہیں جو پیج کو پیش کرتا ہے۔ یہ ڈیٹا بالکل اسی نام اور فارمیٹ کا نہیں ہے جو Shopify Flow استعمال کرتا ہے، لیکن قدریں اس سے مماثل ہیں جو GraphQL Admin API میں موجود ہے۔ ڈیٹا کا جائزہ لینے کے لیے، URL میں .json شامل کریں۔

مثال کے طور پر، Shopify ایڈمن میں Orders پیج پر جا کر اور کسی آرڈر پر کلک کر کے آرڈر پر جائیں۔ اپنے براؤزر کی ایڈریس بار میں پیج کے ایڈریس میں، ایڈریس کو اس سے تبدیل کریں:

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

درج ذیل میں:

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

GraphiQL یا کوئی تھرڈ پارٹی API ٹول استعمال کریں

آپ کسی تھرڈ پارٹی API ٹول جیسے Postman یا 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"
            }
          }
        }
      ]
    }
  }