পেজ ডেটা পান
পেজ ডেটার প্রয়োজন হয় এমন ওয়ার্কফ্লোতে, আপনার স্টোর থেকে পেজের তথ্য পুনরুদ্ধার করতে পেজ ডেটা পান অ্যাকশনটি ব্যবহার করতে পারেন। পেজ হলো আপনার অনলাইন স্টোরের এমন ওয়েব পেজ যেখানে খুব কমই পরিবর্তিত হয় এমন তথ্য থাকে, যেমন- ‘আমাদের সম্পর্কে’ পেজ বা যোগাযোগের পেজ।
কনফিগারেশন
ফিল্ড
পেজ ডেটা পান অ্যাকশনে নিম্নলিখিত ফিল্ডগুলো রয়েছে:
| ফিল্ড | বিবরণ |
|---|---|
| ডেটা সর্ট করুন | প্রয়োজনীয়। যে প্যারামিটারগুলোর মাধ্যমে সার্চ কোয়েরি দ্বারা রিটার্ন করা ডেটা সর্ট করা হয়। |
| সর্বোচ্চ ফলাফলের সংখ্যা | প্রয়োজনীয়। আপনার নির্বাচিত সার্চ কোয়েরি দ্বারা রিটার্ন করা ফলাফলের সর্বোচ্চ পরিমাণ। আপনি একবারে সর্বোচ্চ 100টি রিটার্ন করতে পারবেন। |
| কোয়েরি | প্রয়োজনীয়। সাধারণ কোয়েরিগুলো থেকে বেছে নিন অথবা নিজের মতো তৈরি করতে Advanced নির্বাচন করুন। |
কোয়েরি স্ট্রিং
প্রকাশিত পেজগুলো পাওয়ার জন্য এটি একটি উদাহরণ কোয়েরি:
published_status:publishedpublished_status ভ্যারিয়েবলটি পেজ কোয়েরি-তে উপলব্ধ একটি ফিল্টার এবং এটি একাধিকবার ব্যবহার করা যেতে পারে বা অন্য ভ্যারিয়েবলগুলোর সাথে একত্রিত করা যেতে পারে।
ডেটা কোয়েরি করার সময়, যা জানা সহায়ক:
কোয়েরিগুলোতে একটি নির্দিষ্ট সিনট্যাক্স অনুসরণ করতে হবে
কোয়েরি ফিল্ডের ভ্যালুগুলো সবসময় ডকুমেন্টেড থাকে না। কিছু ক্ষেত্রে, API ডক্স দেখে ভ্যালুগুলো খুঁজে পাওয়া যায়। বিকল্পভাবে, ফিল্টার করার সময় আপনি প্রায়শই অ্যাডমিনের URL-গুলোতে ফিল্ডের ভ্যালু খুঁজে পেতে পারেন। উদাহরণস্বরূপ, কিছু অর্ডার কোয়েরির ভ্যালু খুঁজতে, অ্যাডমিনের অর্ডার পেজ ফিল্টার করুন এবং এরপর URLটি চেক করুন।
আপনি Shopify GraphiQL অ্যাপ ব্যবহার করে আপনার শপে একটি কোয়েরি রান করতে বা পরীক্ষা করতে পারেন।
আপনার কোয়েরি ব্যর্থ হলে কী হয় সে সম্পর্কে সতর্ক থাকুন। প্রায়শই API সবগুলো ফলাফল রিটার্ন করবে (একটিও না করার পরিবর্তে)।
রিটার্ন করা ডেটা
সকল ডেটা পান অ্যাকশন 0 থেকে 100টি রিসোর্সের একটি তালিকা রিটার্ন করে। আপনার ব্যবহারের ক্ষেত্রের উপর নির্ভর করে, আপনি এই ডেটা বিভিন্নভাবে ব্যবহার করতে চাইতে পারেন:
- আপনার যদি তালিকার প্রতিটি আইটেম আলাদাভাবে পরিচালনা করার প্রয়োজন হয়, যেমন প্রত্যেকটিতে একটি ট্যাগ যোগ করা, তবে আপনি For each অ্যাকশনটি ব্যবহার করতে পারেন।
- আপনার যদি ডেটা একত্রিত করার প্রয়োজন হয়, যেমন কতগুলো ফলাফল রিটার্ন করা হয়েছে তা গণনা করা, তবে আপনি Count বা Sum অ্যাকশনগুলো ব্যবহার করতে পারেন।
- আপনার যদি তালিকাটি আউটপুট হিসেবে প্রয়োজন হয়, যেমন সমস্ত আইটেম সহ একটি ইমেইল পাঠানো, তবে আপনি পরবর্তী অ্যাকশনগুলোতে সরাসরি রিটার্ন করা ডেটা ব্যবহার করতে পারেন।
এই অ্যাকশনের পরবর্তী ধাপে রিটার্ন করা ডেটা অ্যাক্সেস করতে, পেজ ডেটা পান নামের ভ্যারিয়েবলটি ব্যবহার করুন, যা মূলত পেজগুলোর একটি তালিকা। আপনি শর্ত এবং অ্যাকশন উভয় ক্ষেত্রেই এই ভ্যারিয়েবলটি ব্যবহার করতে পারেন। উদাহরণস্বরূপ, আপনি এর মতো একটি ইন্টারনাল ইমেইল পাঠান অ্যাকশনে পেজের তালিকা পাঠাতে পারেন:
{% for single_page in getPageData %}
* {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}ট্রিগার
আপনি নির্ধারিত সময় ট্রিগার সহ যেকোনো ওয়ার্কফ্লোতে এই অ্যাকশনটি ব্যবহার করতে পারেন। নির্ধারিত সময় ট্রিগার ব্যবহার করা ওয়ার্কফ্লোতে, কোনো ইভেন্টের ফলাফল হিসেবে শুরু হওয়ার পরিবর্তে আপনার নির্দিষ্ট করা সময়ে ওয়ার্কফ্লো শুরু হয়। যেহেতু আপনার স্টোরে বা কোনো অ্যাপ থেকে ওয়ার্কফ্লো শুরু করার মতো কোনো নির্দিষ্ট ইভেন্ট নেই, তাই স্বয়ংক্রিয়ভাবে কোনো ডেটা অন্তর্ভুক্ত হয় না।
API রেফারেন্স
এই অ্যাকশনে ব্যবহৃত API সম্পর্কে আরও তথ্যের জন্য, পেজ কোয়েরি দেখুন।