आउटपुट वैरिएबल की मदद से, एक चरण से दूसरे चरण के बीच डेटा पास करना

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

आउटपुट वैरिएबल, चरणों के हिसाब से मिलते हैं और इन्हें किसी दूसरे चरण में भेजा जा सकता है. उदाहरण के लिए, किसी ईमेल पते को दूसरे चरण में पास करें. इसका इस्तेमाल ईमेल पाने वाले व्यक्ति की जानकारी देने के लिए किया जाता है.

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

यहां दिए गए उदाहरण में, तीन इनपुट वैरिएबल से कैलकुलेट किया गया गणित का नतीजा दिखाया गया है. ये वैरिएबल दो संख्याएं और एक अंकगणितीय संक्रिया हैं.

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

Apps Script की मेनिफ़ेस्ट फ़ाइल में, outputs[] ऐरे और onExecuteFunction() तय करें.

outputs[] कलेक्शन में मौजूद हर आइटम में ये प्रॉपर्टी होती हैं:

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

कोड में आउटपुट वैरिएबल तय करना

स्टेप के कोड में onExecuteCalculate() नाम का एक फ़ंक्शन शामिल है. यह मेनिफ़ेस्ट में तय किया गया onExecuteFunction है. यह फ़ंक्शन, उपयोगकर्ता की ओर से डाली गई दो वैल्यू पर अंकगणितीय कार्रवाई करता है. साथ ही, outputVariables() नाम के फ़ंक्शन के साथ, नतीजे को आउटपुट वैरिएबल के तौर पर दिखाता है.

आउटपुट वैरिएबल दिखाने के लिए, इन ज़रूरी शर्तों के साथ JSON दिखाएं:

  • हर आउटपुट वैरिएबल का variableId, मेनिफ़ेस्ट फ़ाइल में मौजूद उससे जुड़े आउटपुट वैरिएबल के id से मेल खाना चाहिए.
  • आउटपुट वैरिएबल का variableData, मेनिफ़ेस्ट फ़ाइल में मौजूद आउटपुट वैरिएबल के dataType और cardinality से मेल खाना चाहिए.

यहां दिए गए उदाहरण में, एक आउटपुट वैरिएबल दिखाया गया है. यह दो इनपुट संख्याओं की अंकगणितीय वैल्यू है:

Apps Script

/**
 * Executes the calculation step based on the inputs from a flow event.
 *
 * This function retrieves input values and the operation from the flow event,
 * performs the calculation, and returns the result as an output variable.
 * The function logs the event for debugging purposes.
 */
function onExecuteCalculateFunction(event) {
  console.log("output: " + JSON.stringify(event));
  var calculatedValue = 0;
  var value1 = event.workflow.actionInvocation.inputs["value1"];
  var value2 = event.workflow.actionInvocation.inputs["value2"];
  var operation = event.workflow.actionInvocation.inputs["operation"].stringValues[0];

  if (operation == "+") {
    calculatedValue = value1 + value2;
  } else if (operation == "-") {
    calculatedValue = value1 - value2;
  } else if (operation == "x") {
    calculatedValue = value1 * value2;
  } else if (operation == "/") {
    calculatedValue = value1 / value2;
  }
  var renderAction = {
    "hostAppAction" : {
      "workflowAction" : {
        "returnOutputVariablesAction" : {
          "variableValues" : [
            {
              "variableId": "result",
              "integerValues": [
                calculatedValue
              ]
            }
          ]
        }
      }
    }
  };

  console.log("renderAction: " + JSON.stringify(renderAction));

  return renderAction;
}