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