使用版本更新和管理步骤

发布新版步骤后,包含该步骤的现有用户流程不会自动更新。发布某个步骤后,为了保持对之前行为的支持,请使用版本来处理更改。

您应使用版本控制的更改包括:

  • 添加新的必填字段
  • 弃用输入或输出字段
  • 更改数据类型,例如字符串、浮点数或整数
  • 修改步骤的基本行为

如需实现版本控制,请在相应步骤的清单文件中指定 current_versionmin_version

  • current_version:当前有效部署的版本号。
  • min_version:相应步骤支持的最旧版本。

以下清单示例展示了如何为步骤定义版本:

JSON

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

在执行期间,您可以从事件对象中检索版本号,并为每个版本定义自定义行为。

Apps 脚本

/**
 * 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
  }
}