Daten mit einer Ausgabevariable zwischen Schritten übergeben

In dieser Anleitung wird beschrieben, wie Sie eine Ausgabevariable erstellen.

Ausgabevariablen werden von Schritten zurückgegeben und können an einen anderen Schritt gesendet werden. Sie können beispielsweise eine E-Mail-Adresse an einen anderen Schritt übergeben, der sie verwendet, um den Empfänger einer E-Mail anzugeben.

Definieren Sie die Ausgabevariable an zwei Stellen: in der Manifestdatei des Add-ons und im Code mit einer Funktion, die die Ausgabevariable zurückgibt.

Im folgenden Beispiel wird ein berechnetes mathematisches Ergebnis aus drei Eingabevariablen zurückgegeben: zwei Zahlen und eine arithmetische Operation.

Ausgabevariable in der Manifestdatei definieren

Geben Sie in der Apps Script-Manifestdatei ein outputs[]-Array und eine onExecuteFunction an.

Jedes Element im outputs[]-Array hat die folgenden Eigenschaften:

  • id: Eindeutige ID für eine Ausgabevariable.
  • description: Eine Beschreibung der Ausgabevariable, die Endnutzern angezeigt wird.
  • cardinality: Anzahl der zulässigen Werte. Mögliche Werte sind:
    • SINGLE: Nur ein Wert ist zulässig.
  • dataType: Der Typ der akzeptierten Werte. dataType hat die Eigenschaft basicType, die den Datentyp definiert. Gültige Werte sind:
    • STRING: Ein alphanumerischer String.
    • INTEGER: Eine Zahl.
    • TIMESTAMP: Ein Zeitstempel im Format „Millisekunden seit der Unix-Epoche“. Beispiel: Der 27. November 2025, 16:49:02 Uhr UTC wird als 1764262142988 dargestellt.
    • BOOLEAN: Entweder „true“ oder „false“.
    • EMAIL_ADDRESS: Eine E-Mail-Adresse im Format dana@example.com.

Im folgenden Beispiel wird eine Ausgabevariable für einen Schritt mit einem Taschenrechner definiert. Die Ausgabevariable ist eine Ganzzahl.

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": "calculatorDemo",
          "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"
          }
        }
      ]
    }
  }
}

Ausgabevariable im Code definieren

Der Code des Schritts enthält eine Funktion namens onExecuteCalculate, die die in der Manifestdatei definierte onExecuteFunction ist. Sie führt arithmetische Operationen mit zwei vom Nutzer eingegebenen Werten aus und gibt das Ergebnis als Ausgabevariable mit einer Funktion namens outputVariables zurück.

Wenn Sie eine Ausgabevariable zurückgeben möchten, geben Sie JSON mit den folgenden Anforderungen zurück:

  • Die variableId jeder Ausgabevariable muss mit der id der entsprechenden Ausgabevariable in der Manifestdatei übereinstimmen.
  • Die variableData der Ausgabevariable muss mit dataType und cardinality der entsprechenden Ausgabevariable in der Manifestdatei übereinstimmen.

Im folgenden Beispiel wird eine Ausgabevariable zurückgegeben, die dem arithmetischen Wert zweier Eingabezahlen entspricht:

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 onExecuteCalculate(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;
  }
  const variableData = AddOnsResponseService.newVariableData()
    .addIntegerValue(calculatedValue);
  
  const workflowAction = AddOnsResponseService.newReturnOutputVariablesAction()
    .addVariableData("result", variableData);

  const hostAppAction = AddOnsResponseService.newHostAppAction()
    .setWorkflowAction(workflowAction);

  return AddOnsResponseService.newRenderActionBuilder()
    .setHostAppAction(hostAppAction)
    .build();
}