Get metaobject entries

آپ اختیاری کوئری کی بنیاد پر اپنے سٹور سے میٹا آبجیکٹ کے لیے اینٹری کی فہرست حاصل کرنے کے لیے Get metaobject entries ایکشن کا استعمال کر سکتے ہیں۔ مزید معلومات کے لیے میٹا آبجیکٹ کی دستاویزات دیکھیں۔

اس صفحے پر

کنفیگریشن

فیلڈ

Get metaobject entries ایکشن میں میٹا آبجیکٹ کی تعریف متعین کرنے کے لیے ایک ڈراپ ڈاؤن اور درج ذیل فیلڈ شامل ہیں، جو کوئری بنانے کے لیے استعمال ہوتی ہیں:

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

کوئری سٹرنگ

اگر email فیلڈ کی ویلیو آرڈر پر موجود ای میل ایڈریس سے میل کھاتی ہو، تو میٹا آبجیکٹ کی اینٹری حاصل کرنے کے لیے یہ ایک کوئری کی مثال ہے:

{{fields.email}}:"{{order.email}}"

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

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

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

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

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

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

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

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

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

{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
  {% for fields_item in getMetaobjectEntries_item.system.fields %}
    {{fields_item.key}}:{{fields_item.value}}
  {% endfor %}
{% endfor %}

ٹریگرز

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