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

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

اس صفحہ پر

کنفیگریشن

فیلڈ

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

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

کوئری سٹرنگ

یہ ان کمپنیوں کو حاصل کرنے کے لیے ایک مثالی کوئری ہے جو پچھلے دن اپ ڈیٹ کی گئی تھیں:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

updated_at متغیر ایک فلٹر ہے جو Companies کوئری پر دستیاب ہے اور اسے متعدد بار استعمال کیا جا سکتا ہے یا دوسرے متغیر کے ساتھ ملایا جا سکتا ہے۔ scheduledAt Liquid متغیر ان ورک فلو پر دستیاب ہے جنہوں نے Scheduled time ٹرگر استعمال کیا۔ date_minus Liquid ٹیگ ایک خاص Flow ٹیگ ہے جو آپ کو تاریخ سے وقت منہا کرنے کی سہولت دیتا ہے۔

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

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

واپس کیا گیا ڈیٹا

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

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

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

{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}

ٹرگر

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