فلفلمنٹ آرڈر کا ڈیٹا حاصل کریں
آپ اپنے سٹور سے فلفلمنٹ آرڈر کی معلومات حاصل کرنے کے لیے Get fulfillment order data ایکشن استعمال کر سکتے ہیں۔
کنفیگریشن
فیلڈ
Get fulfillment order data ایکشن میں درج ذیل فیلڈ شامل ہیں، جو کیوری بنانے کے لیے استعمال ہوتی ہیں:
| فیلڈ | تفصیل |
|---|---|
| اس لحاظ سے ڈیٹا ترتیب دیں | درکار ہے۔ وہ پیرامیٹرز جن کے ذریعے سرچ کیوری سے حاصل ہونے والے ڈیٹا کو ترتیب دیا جاتا ہے۔ |
| نتائج کی زیادہ سے زیادہ تعداد | درکار ہے۔ آپ کی منتخب کردہ سرچ کیوری کے ذریعے موصول ہونے والے نتائج کی زیادہ سے زیادہ تعداد۔ آپ ایک وقت میں 100 تک نتائج حاصل کر سکتے ہیں۔ |
| کیوری | درکار ہے۔ عام کیوری سے انتخاب کریں یا اپنی کیوری بنانے کے لیے Advanced کو منتخب کریں۔ |
کیوری سٹرنگ
یہ ان فلفلمنٹ آرڈر کو حاصل کرنے کی ایک مثالی کیوری ہے جو فی الحال ہولڈ پر ہیں:
status:ON_HOLDstatus ویری ایبل ایک فلٹر ہے جو Fulfillment Orders کیوری پر دستیاب ہے اور اسے متعدد بار استعمال کیا جا سکتا ہے یا دیگر ویری ایبل کے ساتھ ملایا جا سکتا ہے۔
ڈیٹا کی کیوری کرتے وقت، یہ جاننا مفید ہے:
- دستیاب فلفلمنٹ آرڈر فلٹر کی فہرست
- کیوری کے لیے مخصوص سنٹیکس کی پیروی کرنا لازمی ہے
- کیوری فیلڈ کی ویلیوز ہمیشہ دستاویزی شکل میں نہیں ہوتیں۔ بعض صورتوں میں، یہ ویلیوز API docs کو دیکھ کر معلوم کی جا سکتی ہیں۔ متبادل کے طور پر، جب آپ فلٹر کرتے ہیں تو آپ اکثر ایڈمن میں URL کے اندر فیلڈ کی ویلیوز تلاش کر سکتے ہیں۔ مثال کے طور پر، آرڈر کیوری کی کچھ ویلیوز تلاش کرنے کے لیے، ایڈمن میں Orders صفحہ کو فلٹر کریں، اور پھر URL چیک کریں۔
- آپ Shopify GraphiQL ایپ استعمال کر کے اپنی شاپ میں کیوری رن یا ٹیسٹ کر سکتے ہیں۔
- اس بات کا دھیان رکھیں کہ اگر آپ کی کیوری ناکام ہو جائے تو کیا ہوتا ہے۔ اکثر API تمام نتائج واپس کر دے گی (بجائے اس کے کہ کوئی بھی نتیجہ نہ آئے)۔
واپس کردہ ڈیٹا
تمام Get data ایکشن 0 اور 100 کے درمیان وسائل (resources) کی ایک فہرست واپس کرتے ہیں۔ اپنے استعمال کے لحاظ سے، آپ اس ڈیٹا کو مختلف طریقوں سے استعمال کر سکتے ہیں:
- اگر آپ کو فہرست کے ہر آئٹم کو انفرادی طور پر ہینڈل کرنے کی ضرورت ہے، جیسے کہ ہر ایک کے لیے ٹیگ شامل کرنا، تو آپ For each ایکشن استعمال کر سکتے ہیں۔
- اگر آپ کو ڈیٹا اکٹھا کرنے کی ضرورت ہے، جیسے کہ یہ گننا کہ کتنے نتائج واپس کیے گئے، تو آپ Count یا Sum ایکشن استعمال کر سکتے ہیں۔
- اگر آپ کو فہرست آؤٹ پٹ کرنے کی ضرورت ہے، جیسے کہ تمام آئٹم کے ساتھ ای میل بھیجنا، تو آپ واپس کردہ ڈیٹا کو براہ راست بعد کے ایکشن میں استعمال کر سکتے ہیں۔
اس ایکشن کے بعد آنے والے اقدامات میں واپس کردہ ڈیٹا تک رسائی حاصل کرنے کے لیے، Get fulfillment order data نامی ویری ایبل استعمال کریں، جو کہ فلفلمنٹ آرڈر کی ایک فہرست ہے۔ آپ اس ویری ایبل کو شرائط (conditions) اور ایکشن دونوں میں استعمال کر سکتے ہیں۔ مثال کے طور پر، آپ فلفلمنٹ آرڈر کی فہرست کو Send internal email ایکشن میں اس طرح بھیج سکتے ہیں:
{% for fulfillment_order in GetFulfillmentOrderData %}
* Order: {{ fulfillment_order.order.name }} Location: {{ fulfillment_order.assignedLocation.name }}
{% endfor %}ٹرگر
آپ اس ایکشن کو کسی بھی ورک فلو میں استعمال کر سکتے ہیں، بشمول Scheduled time ٹرگر۔ Scheduled time ٹرگر کا استعمال کرنے والے ورک فلو میں، ورک فلو کسی ایونٹ کے نتیجے کی بجائے آپ کے بتائے گئے وقت پر شروع ہوتا ہے۔ چونکہ آپ کے سٹور میں یا کسی ایپ سے ایسا کوئی مخصوص ایونٹ نہیں ہوتا جو ورک فلو کو شروع کرے، اس لیے اس میں کوئی بھی ڈیٹا خودکار طور پر شامل نہیں ہوتا۔
API کی تفصیلات
ٹیمپلیٹ
ہولڈ پر موجود فلفلمنٹ آرڈر کی فہرست کے ساتھ روزانہ ای میل کی سمری بھیجیں
ہر روز، یہ ورک فلو ہولڈ پر موجود تمام فلفلمنٹ آرڈر (ایک وقت میں 100 تک) کی کیوری کرے گا۔ یہ آرڈر کے نام اور تفویض کردہ فلفلمنٹ لوکیشن کے ساتھ ایک ای میل سمری بھیجے گا۔ ٹیمپلیٹ دیکھیں