출력 변수를 사용하여 단계 간 데이터 전달

이 가이드에서는 출력 변수를 만드는 방법을 설명합니다.

출력 변수는 단계별로 반환되며 다른 단계로 전송될 수 있습니다. 예를 들어 이메일 주소를 사용하여 이메일 수신자를 지정하는 다른 단계에 이메일 주소를 전달합니다.

출력 변수를 두 곳에 정의합니다. 부가기능의 매니페스트 파일과 출력 변수를 반환하는 함수가 있는 코드입니다.

다음 예에서는 두 개의 숫자와 하나의 산술 연산이라는 세 개의 입력 변수에서 계산된 수학적 결과를 반환합니다.

매니페스트 파일에서 출력 변수 정의

Apps Script 매니페스트 파일에서 outputs[] 배열과 onExecuteFunction()을 지정합니다.

outputs[] 배열의 각 항목에는 다음 속성이 있습니다.

  • id: 출력 변수의 고유 식별자입니다.
  • description: 최종 사용자에게 표시할 출력 변수에 대한 설명입니다.
  • cardinality: 허용되는 값의 수입니다. 가능한 값은 다음과 같습니다.
    • "SINGLE": 값은 하나만 허용됩니다.
  • dataType: 허용되는 값의 유형입니다. dataType에는 데이터 유형을 정의하는 basicType 속성이 있습니다. 유효한 값으로 다음이 포함되어 있습니다.
    • "STRING": 영숫자 문자열입니다.
    • "INTEGER": 숫자입니다.
    • "TIMESTAMP": ISO 8601 형식의 타임스탬프입니다. 예를 들어 ISO 8601에서 2025년 3월 15일은 2025-03-15로 표시됩니다.
    • "BOOLEAN": true 또는 false입니다.
    • "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"
          }
        }
      ]
    }
  }
}

코드에서 출력 변수 정의

이 단계의 코드에는 매니페스트에 정의된 onExecuteFunction인 onExecuteCalculate()라는 함수가 포함되어 있습니다. 사용자가 입력한 두 값에 대해 산술 연산을 실행하고 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;
}