Get collection data

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

کنفیگریشن

فیلڈز

Get collection data ایکشن میں درج ذیل فیلڈز شامل ہیں۔

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

کیوری سٹرنگ

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

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

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

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

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

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

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

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

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

{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}

ٹرگرز

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

API حوالہ