انوینٹری آئٹم کا ڈیٹا حاصل کریں

جن workflow کو انوینٹری آئٹم کے ڈیٹا کی ضرورت ہوتی ہے، آپ اپنے سٹور سے انوینٹری آئٹم کی معلومات حاصل کرنے کے لیے Get inventory item data ایکشن استعمال کر سکتے ہیں۔ انوینٹری آئٹم اصل سٹاک یونٹ کی نمائندگی کرتے ہیں جو پروڈکٹ ویرینٹ کے لیے ٹریک کیے جاتے ہیں۔

کنفیگریشن

فیلڈ

Get inventory item data ایکشن میں درج ذیل فیلڈ شامل ہیں:

Query string

ٹریک کیے گئے انوینٹری آئٹم حاصل کرنے کے لیے یہ ایک مثال query ہے:

tracked:true

tracked ویری ایبل ایک فلٹر ہے جو Inventory items query پر دستیاب ہے اور اسے متعدد بار استعمال کیا جا سکتا ہے یا دیگر ویری ایبل کے ساتھ ملایا جا سکتا ہے۔

ڈیٹا کی querying کرتے وقت، یہ جاننا مفید ہے:

• دستیاب انوینٹری آئٹم فلٹر کی فہرست

• Query کو ایک مخصوص syntax کی پیروی کرنی چاہیے

• Query فیلڈ کی ویلیو ہمیشہ دستاویزی شکل میں نہیں ہوتیں۔ کچھ صورتوں میں، API docs دیکھ کر ویلیو کو تلاش کیا جا سکتا ہے۔ متبادل کے طور پر، جب آپ فلٹر کرتے ہیں تو آپ اکثر admin میں URL میں فیلڈ کی ویلیو تلاش کر سکتے ہیں۔ مثال کے طور پر، کچھ آرڈر query کی ویلیو تلاش کرنے کے لیے، admin میں Orders کے صفحے کو فلٹر کریں، اور پھر URL چیک کریں۔

• آپ Shopify GraphiQL app کا استعمال کر کے اپنے سٹور میں query چلا یا ٹیسٹ کر سکتے ہیں۔

• اس بات کا دھیان رکھیں کہ اگر آپ کی query ناکام ہو جائے تو کیا ہوتا ہے۔ اکثر 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 دیکھیں۔