سبسکرپشن کنٹریکٹ کا ڈیٹا حاصل کریں

ایسے ورک فلوز میں جو سبسکرپشن کنٹریکٹ کا ڈیٹا استعمال کرتے ہیں، آپ اپنے سٹور سے سبسکرپشن کنٹریکٹ کی معلومات حاصل کرنے کے لیے Get subscription contract data ایکشن استعمال کر سکتے ہیں۔

اس صفحے پر

کنفیگریشن

فیلڈز

Get subscription contract data ایکشن میں درج ذیل فیلڈز شامل ہیں، جو کیوری بنانے کے لیے استعمال ہوتی ہیں:

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

کیوری سٹرنگ

یہ ACTIVE کے سٹیٹس والے سبسکرپشن کنٹریکٹس حاصل کرنے کے لیے ایک مثالی کیوری ہے:

status: ACTIVE

status متغیر ایک فلٹر ہے جو Subscription contracts query پر دستیاب ہے اور اسے متعدد بار استعمال کیا جا سکتا ہے۔

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

دستیاب فلٹرز کی فہرست
کیوریز کا ایک مخصوص سنٹیکس (syntax) کے مطابق ہونا ضروری ہے
کیوری فیلڈ کی ویلیوز ہمیشہ دستاویزی شکل میں نہیں ہوتیں۔ بعض صورتوں میں، یہ ویلیوز API docs کو دیکھ کر معلوم کی جا سکتی ہیں۔ متبادل کے طور پر، جب آپ فلٹر کرتے ہیں تو آپ اکثر ایڈمن میں URLs کے اندر فیلڈ ویلیوز تلاش کر سکتے ہیں۔ مثال کے طور پر، آرڈر کیوری کی کچھ ویلیوز تلاش کرنے کے لیے، ایڈمن میں Orders کے صفحے کو فلٹر کریں، اور پھر URL چیک کریں۔
آپ Shopify GraphiQL ایپ استعمال کر کے اپنی شاپ میں کیوری کو رن یا ٹیسٹ کر سکتے ہیں۔
اس بات کا خیال رکھیں کہ اگر آپ کی کیوری فیل ہو جائے تو کیا ہوتا ہے۔ اکثر API تمام نتائج لوٹا دے گی (کوئی نتیجہ نہ دینے کے بجائے)۔

لوٹایا گیا ڈیٹا

تمام Get data ایکشنز 0 اور 100 کے درمیان وسائل (resources) کی ایک فہرست لوٹاتے ہیں۔ آپ کے استعمال کے کیس کی بنیاد پر، آپ اس ڈیٹا کو مختلف طریقوں سے استعمال کرنا چاہیں گے:

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

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

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}

ٹرگرز

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