پیج کا ڈیٹا حاصل کریں

ایسے ورک فلو جن میں پیج کے ڈیٹا کی ضرورت ہوتی ہے، آپ اپنے سٹور سے پیج کی معلومات بازیافت کرنے کے لیے پیج کا ڈیٹا حاصل کریں ایکشن استعمال کر سکتے ہیں۔ آپ کے آن لائن سٹور پر پیج ایسے ویب پیج ہوتے ہیں جن میں ایسی معلومات ہوتی ہے جو شاذ و نادر ہی تبدیل ہوتی ہے، جیسے کہ ہمارے بارے میں (About Us) پیج یا رابطہ کریں (Contact) کا پیج۔

کنفیگریشن

فیلڈ

پیج کا ڈیٹا حاصل کریں ایکشن میں درج ذیل فیلڈ شامل ہیں:

کوئری سٹرنگ

شائع شدہ پیج حاصل کرنے کے لیے یہ ایک مثال کی کوئری ہے:

published_status:published

published_status متغیر ایک فلٹر ہے جو پیج کوئری پر دستیاب ہے اور اسے متعدد بار استعمال کیا جا سکتا ہے یا دیگر متغیرات کے ساتھ ملایا جا سکتا ہے۔

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

• دستیاب پیج فلٹر کی فہرست

• کوئری کا ایک مخصوص سنٹیکس پر مبنی ہونا ضروری ہے

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

• آپ Shopify GraphiQL ایپ استعمال کر کے اپنے شاپ میں کوئری چلا سکتے ہیں یا ٹیسٹ کر سکتے ہیں۔

• اس بات کا خیال رکھیں کہ اگر آپ کی کوئری ناکام ہو جاتی ہے تو کیا ہوتا ہے۔ اکثر API تمام نتائج واپس کر دے گا (بجائے اس کے کہ کوئی نتیجہ نہ دے)۔

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

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

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

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

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

ٹرگر

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

API کا حوالہ

اس ایکشن میں استعمال ہونے والے API کے بارے میں مزید معلومات کے لیے، پیج کوئری دیکھیں۔