آرٹیکل کا ڈیٹا حاصل کریں

جن ورک فلو میں بلاگ آرٹیکل کے ڈیٹا کی ضرورت ہوتی ہے، آپ اپنے Shopify سٹور سے آرٹیکل کی معلومات حاصل کرنے کے لیے آرٹیکل کا ڈیٹا حاصل کریں ایکشن کا استعمال کر سکتے ہیں۔

کنفیگریشن

فیلڈ

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

کوئری سٹرنگ

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

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

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

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

• آرٹیکل کے دستیاب فلٹر کی فہرست

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

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

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

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

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

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

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

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

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

ٹرگر

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

API کا حوالہ

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