সাহায্য
লগ ইন করুন

Shopify Flow-তে ব্যবহৃত API ডেটার প্রিভিউ দেখুন

বেশিরভাগ ওয়ার্কফ্লো আপনার স্টোর থেকে ডেটা অ্যাক্সেস করে, যেন আপনি শর্ত ও অ্যাকশনে তা ব্যবহার করতে পারেন। Shopify Flow GraphQL Admin API-তে কল করে স্টোরের ডেটা অ্যাক্সেস করে, যার ফলে আপনি API-এর প্রায় সমস্ত ফিল্ড অ্যাক্সেস করতে পারেন।

আপনি যখন কোনো ওয়ার্কফ্লো তৈরি করবেন, তখন প্রায়শই API-এর উপর ভিত্তি করে ফিল্ডের নাম এবং বিবরণ দেখতে পাবেন, তবে আপনার সেই ডেটার ভ্যালু জানার প্রয়োজন হতে পারে। উদাহরণস্বরূপ, একটি ড্রাফট অর্ডার থেকে তৈরি করা অর্ডারের জন্য আপনি অ্যাপের নামটি জানতে চাইতে পারেন। এছাড়া, আপনি হয়তো নিশ্চিত করতে চাইবেন যে আপনার ওয়ার্কফ্লো আপনার প্রত্যাশিত ডেটা বা প্রত্যাশিত ফর্মে আউটপুট দেয় কি না।

ডেটার ভ্যালুগুলো রিভিউ করতে, Shopify Flow-তে আপনার কাছে বেশ কয়েকটি বিকল্প রয়েছে।

এই পেজে

Shopify অ্যাডমিন-এ একটি ফিল্ড খুঁজুন

বেশিরভাগ ক্ষেত্রে, আপনি Shopify অ্যাডমিন-এ খুঁজলে ডেটা পেতে পারেন। উদাহরণস্বরূপ, product.title Product পেজে তালিকাভুক্ত আছে।

নমুনা ডেটা পান

আপনি যখন কোনো ওয়ার্কফ্লো তৈরি করেন, তখন সরাসরি Flow এডিটরে নমুনা ডেটা পেতে পারেন। যেহেতু Flow-এর ডেটা ইভেন্ট থেকে আসে, তাই সঠিক নমুনা ডেটা পেতে আপনাকে অবশ্যই একটি প্রাসঙ্গিক ইভেন্ট বেছে নিয়ে শুরু করতে হবে:

  1. Flow-এর এডিটরে, আপনি যে অ্যাকশনে ডেটা ব্যবহার করতে চান তা খুলুন এবং Add a variable-এ ক্লিক করুন। বিকল্পভাবে, কোনো শর্তে, Add criteria-এ ক্লিক করুন।
  2. Configure sample data-এ ক্লিক করুন।
  3. Flow ওয়ার্কফ্লোর ট্রিগারের উপর ভিত্তি করে আগের ইভেন্টগুলো দেখায়। সাম্প্রতিক রান থেকে ইভেন্ট আনতে Refresh events-এ ক্লিক করুন বা Start listening for live events-এ ক্লিক করুন এবং তারপর ম্যানুয়ালি অ্যাডমিন বা সংশ্লিষ্ট অ্যাপে (অ্যাপ-ভিত্তিক ট্রিগারগুলোর জন্য) ইভেন্টটি ট্রিগার করুন।
  4. ইভেন্টটি হওয়ার পরে, Flow ইভেন্ট সম্পর্কে বিস্তারিত বিবরণ দেখাবে। নমুনা ডেটা পেতে আপনি যে ইভেন্টটি ব্যবহার করতে চান সেটি বেছে নিন। Use this trigger event-এ ক্লিক করুন।
  5. এখন, আপনি ইভেন্টগুলো ব্রাউজ করার সময়, প্রতিটি ভেরিয়েবলের জন্য নমুনা ডেটা দেখা যাবে।

সীমাবদ্ধতাগুলো:

  • জায়গার সীমাবদ্ধতার কারণে, লিস্টের ডেটার ক্ষেত্রে Flow শুধুমাত্র লিস্টের প্রথম আইটেম থেকে ডেটা দেখাবে।
  • Flow প্রতি ওয়ার্কফ্লোতে একবারে 5টি পর্যন্ত ইভেন্ট স্টোর করবে।
  • Flow কিছু ট্রিগারের জন্য সাম্প্রতিক রানগুলো থেকে ইভেন্ট আনতে পারে না, যেমন Scheduled time, Metaobject entry created, Customer joined segment বা Customer left segment।

লাইভ ওয়ার্কফ্লোতে ফিল্ডটি ব্যবহার করুন

আপনি Log output অ্যাকশনটি কাজে লাগিয়ে ওয়ার্কফ্লোতে নিরাপদে ফিল্ডগুলো ব্যবহার করতে পারেন। আপনি যখন কোনো ওয়ার্কফ্লো রান করাবেন, তখন Log output অ্যাকশনটি Run history পেজে যেকোনো ভেরিয়েবল এবং টেক্সটের আউটপুট প্রিন্ট করবে। আপনি Send internal email-এর মতো নোটিফিকেশন অ্যাকশনগুলোও ব্যবহার করতে পারেন।

Log output ব্যবহার করার ধাপ:

  1. এমন একটি ট্রিগার বেছে নিন যা ম্যানুয়ালি ট্রিগার করা যায়।
  2. ওয়ার্কফ্লোতে একটি Log output অ্যাকশন যোগ করুন এবং সেটিকে ট্রিগারের সাথে কানেক্ট করুন।
  3. Log output কনফিগারেশনে, Output সেকশনে আপনার পরীক্ষা করার ভেরিয়েবলগুলো যোগ করতে Add a variable-এ ক্লিক করুন।
  4. সম্পন্ন হলে, Turn on workflow-এ ক্লিক করুন।
  5. হয় এটি ম্যানুয়ালি রান করিয়ে বা ট্রিগারটি ফায়ার করার মাধ্যমে ওয়ার্কফ্লোটি ট্রিগার করুন। উদাহরণস্বরূপ, আপনি যদি Order created ট্রিগারটি ব্যবহার করেন, তাহলে একটি পরীক্ষামূলক অর্ডার তৈরি করুন।
  6. ওয়ার্কফ্লোটি রান করার পরে, ভেরিয়েবলগুলোর জন্য অ্যাক্টিভিটি লগ চেক করুন।

রিসোর্স JSON পেজ দেখুন

Shopify অ্যাডমিনের বেশিরভাগ রিসোর্স পেজ, যেমন Order, Product বা Customer পেজ, আপনাকে পেজটিতে থাকা ডেটা দেখার সুবিধা দেয়। এই ডেটাগুলো ঠিক Shopify Flow-এর ব্যবহার করা একই নাম এবং ফর্ম্যাটের হয় না, তবে ভ্যালুগুলো GraphQL Admin API-তে যা থাকে তার সাথে মিলে যায়। ডেটা রিভিউ করতে, URL-এ .json যোগ করুন।

উদাহরণস্বরূপ, Shopify অ্যাডমিন থেকে Orders পেজে গিয়ে একটি অর্ডারে ক্লিক করে অর্ডারটিতে নেভিগেট করুন। আপনার ব্রাউজারের অ্যাড্রেস বারে থাকা পেজটির ঠিকানাকে এখান থেকে পরিবর্তন করুন:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234

নিচে দেওয়া ঠিকানায়:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json

GraphiQL বা তৃতীয়-পক্ষের API টুল ব্যবহার করুন

Postman বা বিনামূল্যের Shopify-প্রদত্ত টুল, GraphiQL-এর মতো তৃতীয়-পক্ষের API টুল ব্যবহার করে আপনি সরাসরি API-কে কোয়েরি করতে পারেন। এই বিকল্পটি সবচেয়ে নির্ভুল ফলাফল দেয়, তবে এর জন্য GraphQL কোয়েরি তৈরি করার বিষয়ে কিছুটা পরিচিতি প্রয়োজন।

GraphiQL-এর জন্য, Shopify জেনেরিক ডেটা সহ একটি ওয়েব-ভিত্তিক GraphiQL এক্সপ্লোরার এবং GraphiQL অ্যাপ উভয়ই অফার করে। GraphiQL-এর মাধ্যমে, আপনি একটি GraphQL কোয়েরি তৈরি করতে পারেন যা হুবহু Shopify Flow-এর ফিল্ডের নামগুলোর সাথে মিলে যায়। আপনি যদি অ্যাপটি ব্যবহার করেন তবে ভ্যালুগুলোও ঠিক আপনার স্টোরের সাথে মিলে যাবে।

এই টুলটি ব্যবহার করে, আপনি আপনার আসল শপের ডেটা দিয়ে ঠিক নির্ধারণ করতে পারবেন যে Shopify Flow কোন ডেটা ব্যবহার করে। উদাহরণস্বরূপ, আপনি নিচের কোয়েরিটি তৈরি করলেন:

{
  orders(first:5, reverse:true) {
    nodes {
      createdAt
      app {
        name
      }
      channelInformation {
        app {
          title
        }
      }
    }
  }
}

নিচের ফলাফলে, order / app / name ভেরিয়েবলটি অর্ডারের জন্য অ্যাপের নাম দেখায়। এক্ষেত্রে, ড্রাফট অর্ডার অ্যাপ থেকে অর্ডার তৈরি করা হয়েছিল, তাই ভ্যালুটি হল Draft Orders। চ্যানেলের তথ্য শুধুমাত্র Point of Sale অ্যাপের জন্য পাওয়া যায়।

{
  "data": {
    "orders": {
      "nodes": [
        {
          "createdAt": "2023-04-10T12:32:41Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-04-10T12:29:12Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:23:10Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:20:53Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T15:45:15Z",
          "app": {
            "name": "Point of Sale"
          },
          "channelInformation": {
            "app": {
              "title": "Point of Sale"
            }
          }
        }
      ]
    }
  }