একটি ইনপুট ভেরিয়েবল ব্যবহার করে তথ্য সংগ্রহ করুন

এই নির্দেশিকাটি ব্যাখ্যা করে কিভাবে একটি ইনপুট ভেরিয়েবল তৈরি করতে হয়।

ধাপগুলি চালানোর জন্য, নির্দিষ্ট তথ্যের প্রয়োজন হয়। উদাহরণস্বরূপ, একটি ইমেল পাঠানোর জন্য একটি ইমেল ঠিকানা প্রয়োজন। ধাপগুলি এই প্রয়োজনীয় তথ্য প্রদানের জন্য, ইনপুট ভেরিয়েবলগুলি সংজ্ঞায়িত করুন। একবার সংজ্ঞায়িত হয়ে গেলে, ব্যবহারকারী যখন ধাপটি সেট আপ করেন তখন ইনপুট ভেরিয়েবলগুলি সাধারণত একটি ধাপের কনফিগারেশন কার্ডে ব্যবহারকারী দ্বারা সেট করা হয়।

ইনপুট ভেরিয়েবল দুটি জায়গায় সংজ্ঞায়িত করুন: অ্যাড-অনের ম্যানিফেস্ট ফাইল, এবং একটি কনফিগারেশন কার্ড সহ কোডে যেখানে ব্যবহারকারীরা ইনপুট ভেরিয়েবলের জন্য মান লিখতে পারেন।

ম্যানিফেস্ট ফাইলে ইনপুট ভেরিয়েবল নির্ধারণ করুন

ম্যানিফেস্ট ফাইলে, inputs[] অ্যারের সাথে input ভেরিয়েবল নির্দিষ্ট করুন। inputs[] অ্যারের প্রতিটি আইটেমের নিম্নলিখিত বৈশিষ্ট্য রয়েছে:

  • id : একটি ইনপুট ভেরিয়েবলের জন্য অনন্য শনাক্তকারী। এই ইনপুট ভেরিয়েবলের সাথে একটি কনফিগারেশন কার্ড ইনপুট উপাদানকে সংযুক্ত করার জন্য, সংশ্লিষ্ট কার্ড উপাদানের নামের সাথে মিল থাকতে হবে।
  • description : শেষ ব্যবহারকারীদের দেখানোর জন্য ইনপুট ভেরিয়েবলের একটি বিবরণ।
  • cardinality : কতগুলি মান অনুমোদিত। সম্ভাব্য মানগুলি হল:
    • SINGLE : শুধুমাত্র একটি মান অনুমোদিত।
  • dataType : গৃহীত মানের ধরণ। dataType basicType বৈশিষ্ট্য থাকে যা ডেটার ধরণ নির্ধারণ করে। বৈধ মানগুলির মধ্যে রয়েছে:
    • STRING : একটি বর্ণসাংখ্যিক স্ট্রিং।
    • INTEGER : একটি সংখ্যা।
    • TIMESTAMP : ISO 8601 ফর্ম্যাটে একটি টাইমস্ট্যাম্প। উদাহরণস্বরূপ, ISO 8601-এ, ১৫ মার্চ, ২০২৫ কে ২০২৫-০৩-১৫ হিসাবে উপস্থাপন করা হয়েছে।
    • BOOLEAN : হয় সত্য অথবা মিথ্যা।
    • EMAIL_ADDRESS : dana@example.com ফর্ম্যাটে একটি ইমেল ঠিকানা।

নিম্নলিখিত উদাহরণটি একটি ক্যালকুলেটর ধাপের জন্য তিনটি ইনপুট ভেরিয়েবলকে সংজ্ঞায়িত করে। প্রথম দুটি ইনপুট ভেরিয়েবল হল পূর্ণসংখ্যা, এবং তৃতীয়টি হল একটি গাণিতিক ক্রিয়াকলাপ।

JSON সম্পর্কে 

{
  "timeZone": "America/Los_Angeles",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "addOns": {
    "common": {
      "name": "Calculator",
      "logoUrl": "https://www.gstatic.com/images/branding/productlogos/calculator_search/v1/web-24dp/logo_calculator_search_color_1x_web_24dp.png",
      "useLocaleFromApp": true
    },
    "flows": {
      "workflowElements": [
        {
          "id": "actionElement",
          "state": "ACTIVE",
          "name": "Calculate",
          "description": "Asks the user for two values and a math operation, then performs the math operation on the values and outputs the result.",
          "workflowAction": {
            "inputs": [
              {
                "id": "value1",
                "description": "value1",
                "cardinality": "SINGLE",
                "dataType": {
                  "basicType": "INTEGER"
                }
              },
              {
                "id": "value2",
                "description": "value2",
                "cardinality": "SINGLE",
                "dataType": {
                  "basicType": "INTEGER"
                }
              },
              {
                "id": "operation",
                "description": "operation",
                "cardinality": "SINGLE",
                "dataType": {
                  "basicType": "STRING"
                }
              }
            ],
            "outputs": [
              {
                "id": "result",
                "description": "Calculated result",
                "cardinality": "SINGLE",
                "dataType": {
                  "basicType": "INTEGER"
                }
              }
            ],
            "onConfigFunction": "onConfigCalculate",
            "onExecuteFunction": "onExecuteCalculate"
          }
        }
      ]
    }
  }
}

কোডে ইনপুট ভেরিয়েবল সংজ্ঞায়িত করুন

ধাপের কোডটিতে onConfigFunction() নামক একটি ফাংশন রয়েছে যা একটি কনফিগারেশন কার্ড প্রদান করে যা ম্যানিফেস্ট ফাইলের inputs[] অ্যারেতে সংজ্ঞায়িত প্রতিটি ইনপুট ভেরিয়েবলের জন্য একটি ইনপুট কার্ড উইজেট সংজ্ঞায়িত করে।

কনফিগারেশন কার্ডে সংজ্ঞায়িত ইনপুট উইজেটগুলির নিম্নলিখিত প্রয়োজনীয়তা রয়েছে:

  • প্রতিটি ইনপুট উইজেটের name অবশ্যই ম্যানিফেস্ট ফাইলে থাকা সংশ্লিষ্ট ইনপুট ভেরিয়েবলের id সাথে মিলতে হবে।
  • ইনপুট উইজেটের কার্ডিনালিটি অবশ্যই ম্যানিফেস্ট ফাইলের ইনপুট ভেরিয়েবলের cardinality সাথে মিলবে।
  • ইনপুট উইজেটের ডেটা টাইপ অবশ্যই ম্যানিফেস্ট ফাইলের ইনপুট ভ্যারিয়েবলের dataType সাথে মিলবে। যদি ইনপুট ভ্যারিয়েবলে পূর্ণসংখ্যার dataType থাকে, তাহলে এটি কোনও স্ট্রিং ধরে রাখতে পারবে না।

কার্ড ইন্টারফেস তৈরিতে সহায়তার জন্য, এই বিকল্পগুলির মধ্যে একটি দেখুন:

নিম্নলিখিত উদাহরণটি ম্যানিফেস্ট ফাইলে ইনপুট ভেরিয়েবল নির্ধারণ করুন -এ সংজ্ঞায়িত প্রতিটি ইনপুট উইজেটের জন্য একটি কনফিগারেশন কার্ড প্রদান করে।

অ্যাপস স্ক্রিপ্ট 

/**
 * Generates and displays a configuration card for the sample calculation step.
 *
 * This function creates a card with input fields for two values and a drop-down
 * for selecting an arithmetic operation. The card also includes a "Save"
 * button to save the step configuration for the workflow.
 *
 * The input fields are configured to let the user select outputs from previous
 * workflow steps as input values using the `hostAppDataSource` property.
 */
function onConfigFunction() {
  var card = {
    "sections": [
      {
        "header": "Step example: Calculate",
        "widgets": [
          {
            "textInput": {
              "name": "value1", // "name" must match an "id" in the manifest file's inputs[] array.
              "label": "First value",
              "hostAppDataSource" : {
                "workflowDataSource" : {
                  "includeVariables" : true
                }
              }
            }
          },
          {
            "selectionInput": {
              "name": "operation", // "name" must match an "id" in the manifest file's inputs[] array.
              "label": "Operation",
              "type": "DROPDOWN",
              "items": [
                {
                  "text": "+",
                  "value": "+",
                },
                {
                  "text": "-",
                  "value": "-",
                },
                {
                  "text": "x",
                  "value": "x",
                },
                {
                  "text": "/",
                  "value": "/",
                }
              ]
            }
          },
          {
            "textInput": {
              "name": "value2", // "name" must match an "id" in the manifest file's inputs[] array.
              "label": "Second value",
              "hostAppDataSource" : {
                "workflowDataSource" : {
                  "includeVariables" : true
                }
              }
            }
          }
        ]
      }
    ]
  };
  return {
    "action": {
      "navigations": [{
        "push_card": card
      }]
    }
  };
}

ইনপুট ভেরিয়েবল যাচাই করুন

সর্বোত্তম অনুশীলন হিসেবে, ব্যবহারকারী একটি উপযুক্ত মান প্রবেশ করান তা যাচাই করুন। একটি ইনপুট ভেরিয়েবল যাচাই করুন দেখুন।