আর্টিকেল ডেটা পান
যেসব ওয়ার্কফ্লোতে ব্লগ আর্টিকেল ডেটার প্রয়োজন হয়, সেগুলোতে আপনি আপনার Shopify স্টোর থেকে আর্টিকেলের তথ্য পুনরুদ্ধার করতে আর্টিকেল ডেটা পান অ্যাকশন ব্যবহার করতে পারেন।
কনফিগারেশন
ফিল্ড
আর্টিকেল ডেটা পান অ্যাকশনে নিচের ফিল্ডগুলো রয়েছে:
| ফিল্ড | বিবরণ |
|---|---|
| যেভাবে ডেটা সাজাবেন | প্রয়োজনীয়। সার্চ কোয়েরি দ্বারা রিটার্ন করা ডেটা যে প্যারামিটারের মাধ্যমে সাজানো হয়। |
| সর্বোচ্চ ফলাফলের সংখ্যা | প্রয়োজনীয়। আপনার নির্বাচন করা সার্চ কোয়েরি দ্বারা রিটার্ন করা ফলাফলের সর্বোচ্চ সংখ্যা। আপনি একবারে 100টি পর্যন্ত রিটার্ন করতে পারেন। |
| কোয়েরি | প্রয়োজনীয়। সাধারণ কোয়েরিগুলো থেকে বেছে নিন অথবা নিজের কোয়েরি তৈরি করতে অ্যাডভান্সড নির্বাচন করুন। |
কোয়েরি স্ট্রিং
গত এক দিনে প্রকাশ হওয়া আর্টিকেলগুলো পাওয়ার জন্য এটি একটি নমুনা কোয়েরি:
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 each অ্যাকশন ব্যবহার করতে পারেন।
- যদি আপনার ডেটা একত্রিত করার প্রয়োজন হয়, যেমন কতগুলো ফলাফল রিটার্ন করা হয়েছে তা গণনা করা, তাহলে আপনি Count বা Sum অ্যাকশন ব্যবহার করতে পারেন।
- যদি আপনাকে তালিকাটি আউটপুট করতে হয়, যেমন সব আইটেম দিয়ে একটি ইমেইল পাঠানো, তবে আপনি পরবর্তী অ্যাকশনগুলোতে সরাসরি রিটার্ন করা ডেটা ব্যবহার করতে পারেন।
এই অ্যাকশনের পরবর্তী ধাপে রিটার্ন করা ডেটা অ্যাক্সেস করতে, আর্টিকেল ডেটা পান নামের ভেরিয়েবলটি ব্যবহার করুন, যা হলো আর্টিকেলগুলোর একটি তালিকা। আপনি শর্ত এবং অ্যাকশন উভয় ক্ষেত্রেই এই ভেরিয়েবল ব্যবহার করতে পারেন। উদাহরণস্বরূপ, আপনি এমন একটি অভ্যন্তরীণ ইমেইল পাঠান অ্যাকশনে আর্টিকেলের তালিকা পাঠাতে পারেন:
{% for single_article in GetArticleData %}
* {{ single_article.title }}
{% endfor %}ট্রিগার
আপনি নির্ধারিত সময় ট্রিগারসহ যেকোনো ওয়ার্কফ্লোতে এই অ্যাকশনটি ব্যবহার করতে পারেন। নির্ধারিত সময় ট্রিগার ব্যবহার করা একটি ওয়ার্কফ্লোতে, ওয়ার্কফ্লোটি কোনো ইভেন্টের ফলে চালু হওয়ার পরিবর্তে আপনার নির্দিষ্ট করা সময়ে চালু হয়। যেহেতু আপনার স্টোরে বা কোনো অ্যাপ থেকে ওয়ার্কফ্লো চালু করার মতো নির্দিষ্ট কোনো ইভেন্ট নেই, তাই স্বয়ংক্রিয়ভাবে কোনো ডেটা অন্তর্ভুক্ত করা হয় না।
API রেফারেন্স
এই অ্যাকশনে ব্যবহার করা API সম্পর্কে আরও তথ্যের জন্য, আর্টিকেল কোয়েরি দেখুন।