কালেকশন ডেটা পান
যেসব ওয়ার্কফ্লোতে কালেকশন ডেটার প্রয়োজন হয়, সেগুলোতে আপনি আপনার স্টোর থেকে কালেকশনের তথ্য পুনরুদ্ধার করতে কালেকশন ডেটা পান অ্যাকশনটি ব্যবহার করতে পারেন।
কনফিগারেশন
ফিল্ড
কালেকশন ডেটা পান অ্যাকশনে নিম্নলিখিত ফিল্ডগুলো রয়েছে।
| ফিল্ড | বিবরণ |
|---|---|
| এর ভিত্তিতে ডেটা সাজান | আবশ্যক। সার্চ কোয়েরি দ্বারা ফেরত দেওয়া ডেটা যে প্যারামিটারের ভিত্তিতে সাজানো হয়। |
| ফলাফলের সর্বোচ্চ সংখ্যা | আবশ্যক। আপনার নির্বাচন করা সার্চ কোয়েরির মাধ্যমে ফেরত দেওয়া যেতে পারে এমন ফলাফলের সর্বোচ্চ পরিমাণ। আপনি একবারে 100 পর্যন্ত ফেরত পেতে পারেন। |
| কোয়েরি | আবশ্যক। সাধারণ কোয়েরিগুলো থেকে বেছে নিন বা নিজের তৈরি করতে অ্যাডভান্সড নির্বাচন করুন। |
কোয়েরি স্ট্রিং
গত দিনে আপডেট করা কালেকশন পাওয়ার জন্য এটি একটি উদাহরণ কোয়েরি:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'updated_at ভেরিয়েবলটি কালেকশন কোয়েরি-তে উপলভ্য একটি ফিল্টার এবং একাধিকবার ব্যবহার করা যেতে পারে বা অন্যান্য ভেরিয়েবলের সাথে একত্রিত করা যেতে পারে। scheduledAt Liquid ভেরিয়েবলটি সেইসব ওয়ার্কফ্লোতে উপলভ্য যা নির্ধারিত সময় ট্রিগার ব্যবহার করেছে। date_minus Liquid ট্যাগ হলো একটি বিশেষ Flow ট্যাগ যা আপনাকে কোনো তারিখ থেকে সময় বিয়োগ করতে দেয়।
ডেটা কোয়েরি করার সময়, এটি জানা সহায়ক:
- উপলভ্য কালেকশন ফিল্টারের তালিকা
- কোয়েরিগুলোকে অবশ্যই একটি নির্দিষ্ট সিনট্যাক্স অনুসরণ করতে হবে
- কোয়েরি ফিল্ডের মান সবসময় নথিভুক্ত থাকে না। কিছু ক্ষেত্রে, API ডক্স দেখে মানগুলো পাওয়া যেতে পারে। বিকল্পভাবে, ফিল্টার করার সময় আপনি অনেক ক্ষেত্রেই অ্যাডমিনের URL-গুলোতে ফিল্ডের মানগুলো খুঁজে পেতে পারেন। উদাহরণস্বরূপ, কিছু অর্ডার কোয়েরির মান খুঁজতে, অ্যাডমিনের অর্ডার পৃষ্ঠা ফিল্টার করুন এবং এরপর URL চেক করুন।
- আপনি Shopify GraphiQL অ্যাপ ব্যবহার করে আপনার শপে একটি কোয়েরি রান বা পরীক্ষা করতে পারেন।
- আপনার কোয়েরি ব্যর্থ হলে কী হবে সে সম্পর্কে সতর্ক থাকুন। প্রায়শই API (কোনো ফলাফল না দেখানোর পরিবর্তে) সমস্ত ফলাফল ফেরত দেবে।
ফেরত দেওয়া ডেটা
সমস্ত ডেটা পান অ্যাকশন 0 থেকে 100 টি রিসোর্সের একটি তালিকা ফেরত দেয়। আপনার ব্যবহারের ক্ষেত্রের উপর নির্ভর করে, আপনি এই ডেটা বিভিন্ন উপায়ে ব্যবহার করতে চাইতে পারেন:
- আপনার যদি প্রতিটি তালিকার আইটেম আলাদাভাবে পরিচালনা করার প্রয়োজন হয়, যেমন প্রতিটির জন্য একটি ট্যাগ যোগ করা, তাহলে আপনি For each অ্যাকশনটি ব্যবহার করতে পারেন।
- আপনার যদি ডেটা একত্রিত করার প্রয়োজন হয়, যেমন কতগুলো ফলাফল ফেরত দেওয়া হয়েছে তা গণনা করা, তাহলে আপনি Count বা Sum অ্যাকশন ব্যবহার করতে পারেন।
- আপনার যদি তালিকার আউটপুট প্রয়োজন হয়, যেমন সমস্ত আইটেম সহ একটি ইমেইল পাঠানো, তাহলে আপনি পরবর্তী অ্যাকশনগুলোতে সরাসরি ফেরত দেওয়া ডেটা ব্যবহার করতে পারেন।
এই অ্যাকশনের পরবর্তী ধাপগুলোতে ফেরত দেওয়া ডেটা অ্যাক্সেস করতে, কালেকশন ডেটা পান নামের ভেরিয়েবলটি ব্যবহার করুন, যা হলো কালেকশনের একটি তালিকা। আপনি শর্ত এবং অ্যাকশন উভয় ক্ষেত্রেই এই ভেরিয়েবলটি ব্যবহার করতে পারেন। উদাহরণস্বরূপ, আপনি নিচের মতো একটি অভ্যন্তরীণ ইমেইল পাঠান অ্যাকশনে কালেকশনের তালিকা পাঠাতে পারেন:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}ট্রিগার
আপনি যে কোনো ওয়ার্কফ্লোতে এই অ্যাকশন ব্যবহার করতে পারবেন, যার মধ্যে Scheduled time ট্রিগার অন্তর্ভুক্ত। Scheduled time ট্রিগার ব্যবহার করা ওয়ার্কফ্লো ইভেন্টের ফলে শুরু হওয়ার পরিবর্তে আপনার নির্দিষ্ট করা সময়ে শুরু হয়। আপনার স্টোর বা কোনো অ্যাপে যেহেতু কোনো নির্দিষ্ট ইভেন্ট নেই যা ওয়ার্কফ্লো শুরু করে, সেহেতু এতে স্বয়ংক্রিয়ভাবে কোনো ডেটা অন্তর্ভুক্ত হয় না।