버전으로 단계 업데이트 및 관리

단계를 새 버전으로 게시해도 해당 단계를 포함하는 기존 사용자 흐름은 자동으로 업데이트되지 않습니다. 단계를 게시한 후 이전 동작에 대한 지원을 유지하려면 변경사항에 버전을 사용하세요.

버전을 사용해야 하는 변경사항은 다음과 같습니다.

  • 새 필수 필드 추가
  • 입력 또는 출력 필드 지원 중단
  • 문자열, 부동 소수점, 정수와 같은 데이터 유형 변경
  • 단계의 기본 동작 수정

버전 관리를 구현하려면 단계의 매니페스트 파일에서 current_version 및 min_version을 지정하세요.

  • current_version: 현재 활성 배포의 버전 번호입니다.
  • min_version: 지원되는 가장 오래된 단계 버전입니다.

다음 매니페스트 예시에서는 단계의 버전을 정의하는 방법을 보여줍니다.

JSON

...
"flows": {
     "workflowElements": [
       {
         "id": "...",
         "state": "...",
         "name": "...",
         "description": "...",
         "version" : {
           "current_version": 3,
           "min_version" : 1
         },
...

실행 중에 이벤트 객체에서 버전 번호를 가져와 각 버전에 맞게 맞춤 동작을 정의할 수 있습니다.

Apps Script

/**
 * Executes the step and handles different versions.
 * @param {Object} event The event object from the workflow.
 */
function onExecute(event) {
  // Get the version ID from the execution metadata.
  const versionId = event.workflow.executionMetadata.versionId;

  // Implement different behavior based on the version.
  if (versionId < 2) {
    // Handle earlier versions
  } else {
    // Handle current and newer versions
  }
}