مقام کا ڈیٹا حاصل کریں

جن ورک فلو میں مقام کے ڈیٹا کی ضرورت ہوتی ہے، ان میں آپ اپنے Shopify سٹور سے مقام کی معلومات حاصل کرنے کے لیے Get location data ایکشن استعمال کر سکتے ہیں۔ Locations کوئی بھی ایسی جگہ ہوتی ہے جہاں آپ انوینٹری سٹور کرتے ہیں، پروڈکٹ فروخت کرتے ہیں، یا آرڈر شپ کرتے یا ان کی تکمیل کرتے ہیں۔

کنفیگریشن

فیلڈ

Get location data ایکشن درج ذیل فیلڈ پر مشتمل ہے۔

کیوری سٹرنگ

ان سٹور پک اپ کو فعال رکھنے والے مقامات حاصل کرنے کے لیے یہ ایک مثالی کیوری ہے:

pickup_in_store:enabled

pickup_in_store متغیر ایک فلٹر ہے جو Locations query پر دستیاب ہے اور اسے متعدد بار استعمال کیا جا سکتا ہے یا دیگر متغیرات کے ساتھ ملایا جا سکتا ہے۔

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

• دستیاب لوکیشن فلٹر کی فہرست

• کیوری کے لیے ایک مخصوص سنٹیکس کی پیروی کرنا لازمی ہے

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

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

• اس بات کا خیال رکھیں کہ اگر آپ کی کیوری ناکام ہو جاتی ہے تو کیا ہوتا ہے۔ اکثر API تمام نتائج واپس کر دے گی (کسی کے بھی نہ ہونے کی بجائے)۔

موصول ہونے والا ڈیٹا

تمام Get data ایکشن 0 اور 100 کے درمیان وسائل کی ایک فہرست واپس کرتے ہیں۔ اپنے استعمال کی صورت کے لحاظ سے، آپ اس ڈیٹا کو مختلف طریقوں سے استعمال کرنا چاہ سکتے ہیں:

• اگر آپ کو فہرست کے ہر آئٹم کو انفرادی طور پر ہینڈل کرنے کی ضرورت ہے، جیسے کہ ہر ایک کے لیے ٹیگ شامل کرنا، تو آپ For each ایکشن استعمال کر سکتے ہیں۔
• اگر آپ کو ڈیٹا کو یکجا کرنے کی ضرورت ہے، جیسے کہ کتنے نتائج موصول ہوئے اس کی گنتی کرنا، تو آپ Count یا Sum ایکشن استعمال کر سکتے ہیں۔
• اگر آپ کو فہرست آؤٹ پٹ کرنے کی ضرورت ہے، جیسے کہ تمام آئٹم کے ساتھ ایک ای میل بھیجنا، تو آپ موصول ہونے والے ڈیٹا کو براہ راست بعد کے ایکشن میں استعمال کر سکتے ہیں۔

اس ایکشن کے بعد آنے والے مراحل میں موصول ہونے والے ڈیٹا تک رسائی حاصل کرنے کے لیے، Get location data نامی متغیر استعمال کریں، جو مقامات کی ایک فہرست ہے۔ آپ اس متغیر کو شرائط اور ایکشن دونوں میں استعمال کر سکتے ہیں۔ مثال کے طور پر، آپ مقامات کی فہرست کو اس جیسی Send internal email ایکشن میں بھیج سکتے ہیں:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

ٹرگر

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

API کا حوالہ

اس ایکشن میں استعمال ہونے والی API کے بارے میں مزید معلومات کے لیے، Locations query دیکھیں۔