使用版本更新及管理步驟

發布新版步驟時,系統不會自動更新包含該步驟的現有使用者流程。發布步驟後,如要繼續支援先前的行為,請使用版本進行變更。

您應使用版本記錄的變更包括:

  • 新增必填欄位
  • 淘汰輸入或輸出欄位
  • 變更資料類型,例如字串、浮點數或整數
  • 修改步驟的基本行為

如要實作版本控管,請在步驟的資訊清單檔案中指定 current_versionmin_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
  }
}