इनपुट वैरिएबल की मदद से डेटा इकट्ठा करना

इस गाइड में, इनपुट वैरिएबल बनाने का तरीका बताया गया है.

इन चरणों को पूरा करने के लिए, कुछ जानकारी की ज़रूरत होती है. उदाहरण के लिए, ईमेल भेजने के लिए ईमेल पते की ज़रूरत होती है. इस ज़रूरी जानकारी को देने के लिए, इनपुट वैरिएबल तय करें. इनपुट वैरिएबल तय करने के बाद, आम तौर पर उपयोगकर्ता इन्हें चरण के कॉन्फ़िगरेशन कार्ड पर सेट करता है. ऐसा तब होता है, जब उपयोगकर्ता चरण को सेट अप कर रहा होता है.

इनपुट वैरिएबल को दो जगहों पर तय करें: ऐड-ऑन की मेनिफ़ेस्ट फ़ाइल में और कॉन्फ़िगरेशन कार्ड के साथ कोड में. कॉन्फ़िगरेशन कार्ड में, उपयोगकर्ता इनपुट वैरिएबल के लिए वैल्यू डाल सकते हैं.

मेनिफ़ेस्ट फ़ाइल में इनपुट वैरिएबल तय करना

मेनिफ़ेस्ट फ़ाइल में, inputs[] ऐरे का इस्तेमाल करके इनपुट वैरिएबल तय करें. inputs[] कलेक्शन में मौजूद हर आइटम में ये प्रॉपर्टी होती हैं:

  • id: इनपुट वैरिएबल के लिए यूनीक आइडेंटिफ़ायर. इस विकल्प की मदद से, एजेंट को कॉन्फ़िगरेशन कार्ड के इनपुट एलिमेंट को इस इनपुट वैरिएबल से जोड़ने की अनुमति मिलती है. इसकी वैल्यू, कार्ड के संबंधित एलिमेंट के नाम से मेल खानी चाहिए.
  • description: इनपुट वैरिएबल के बारे में जानकारी, जिसे उपयोगकर्ताओं को दिखाया जाएगा.
  • cardinality: कितनी वैल्यू इस्तेमाल की जा सकती हैं. इन वैल्यू का इस्तेमाल किया जा सकता है:
    • SINGLE: सिर्फ़ एक वैल्यू इस्तेमाल की जा सकती है.
  • dataType: स्वीकार की जाने वाली वैल्यू का टाइप. dataType में basicType प्रॉपर्टी होती है, जो डेटा के टाइप के बारे में बताती है. मान्य वैल्यू में ये शामिल हैं:
    • STRING: अक्षर और अंक वाली स्ट्रिंग.
    • INTEGER: कोई संख्या.
    • TIMESTAMP: "Unix epoch के बाद के मिलीसेकंड" फ़ॉर्मैट में टाइमस्टैंप. उदाहरण के लिए, 27 नवंबर, 2025 को शाम 4:49:02 बजे यूटीसी को 1764262142988 के तौर पर दिखाया गया है.
    • 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 है, तो इसमें स्ट्रिंग नहीं हो सकती.

कार्ड इंटरफ़ेस बनाने में मदद पाने के लिए, इनमें से कोई एक विकल्प देखें:

यहां दिए गए उदाहरण में, मेनिफ़ेस्ट फ़ाइल में इनपुट वैरिएबल तय करें में तय किए गए हर इनपुट विजेट के लिए, कॉन्फ़िगरेशन कार्ड दिखाया गया है.

Apps Script

/**
* 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 input fields are configured to let the user select outputs from previous
* workflow steps as input values using the `hostAppDataSource` property.
*/
function onConfigCalculate() {
  const firstInput = CardService.newTextInput()
    .setFieldName("value1") // "FieldName" must match an "id" in the manifest file's inputs[] array.
    .setTitle("First Value")
    .setHostAppDataSource(
      CardService.newHostAppDataSource()
        .setWorkflowDataSource(
          CardService.newWorkflowDataSource()
            .setIncludeVariables(true)
        )
    );

  const secondInput = CardService.newTextInput()
    .setFieldName("value2") // "FieldName" must match an "id" in the manifest file's inputs[] array.
    .setTitle("Second Value")
    .setHostAppDataSource(
      CardService.newHostAppDataSource()
        .setWorkflowDataSource(
          CardService.newWorkflowDataSource()
            .setIncludeVariables(true)
        )
    );

  const selectionInput = CardService.newSelectionInput()
    .setTitle("operation")
    .setFieldName("operation") // "FieldName" must match an "id" in the manifest file's inputs[] array.
    .setType(CardService.SelectionInputType.DROPDOWN)
    .addItem("+", "+", false)
    .addItem("-", "-", true)
    .addItem("x", "x", false)
    .addItem("/", "/", false);

  const sections = CardService.newCardSection()
    .setHeader("Action_sample: Calculate")
    .setId("section_1")
    .addWidget(firstInput)
    .addWidget(selectionInput)
    .addWidget(secondInput)

  let card = CardService.newCardBuilder()
    .addSection(sections)
    .build();

  return card;
}

इनपुट वैरिएबल की पुष्टि करना

सबसे सही तरीके के तौर पर, पुष्टि करें कि उपयोगकर्ता ने सही वैल्यू डाली है. इनपुट वैरिएबल की पुष्टि करना लेख पढ़ें.