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