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

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

کنفیگریشن

فیلڈ

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

کیوری سٹرنگ

پچھلے دن اپ ڈیٹ ہونے والے کسٹمر کا ڈیٹا حاصل کرنے کے لیے یہ ایک مثالی کیوری ہے:

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

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

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

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

حاصل کردہ ڈیٹا

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

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

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

{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}

ٹرگرز

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

API کی تفصیلات

• Customer ریسورس
• Customer کیوری فلٹرز

ٹیمپلیٹس

کسٹمر میٹا فیلڈ کو تمام کسٹمرز کے لیے ٹیگز میں تبدیل کریں

یہ ورک فلو آپ کے تمام کسٹمرز پر میٹا فیلڈ کی ویلیو کی بنیاد پر ٹیگز بیک فل (backfill) کر دے گا۔ یہ ہر گھنٹے چلتا ہے اور زیادہ سے زیادہ ایسے 100 کسٹمرز حاصل کرتا ہے جن پر "processed" کا ٹیگ موجود نہ ہو۔ ہر کسٹمر کے لیے، یہ custom.test میٹا فیلڈ کی ویلیو دیکھتا ہے اور اسے بطور ٹیگ شامل کرتا ہے۔ یہ ورک فلو ایک "processed" ٹیگ بھی شامل کرتا ہے تاکہ یہ ورک فلو کے اگلے شیڈول شدہ رن میں ظاہر نہ ہو۔ اس ورک فلو کو استعمال کرنے کے لیے، آپ کو میٹا فیلڈ کی نیم سپیس (namespace) اور کلید (key) کو تبدیل کرنا ہو گا تاکہ وہ آپ کے سٹور میں موجود میٹا فیلڈ سے مماثل ہو سکے۔ ٹیمپلیٹ دیکھیں

غیر فعال کسٹمرز کو حذف کریں

ایسے کسٹمرز کو حذف کریں جو 5 سال سے زیادہ پرانے ہیں اور انہوں نے کبھی آرڈر نہیں دیا ہے۔ ٹیمپلیٹ دیکھیں