Update 任务

Update 任务用于更新 Wait 任务的状态。可以通过两种方式更新任务状态：

使用工作流 ID 和引用名称 - 通过指定工作流执行 ID 和任务的引用名称来更新任务状态。
使用任务执行 ID - 通过指定任务的执行 ID 来更新任务状态。

只有当工作流处于"RUNNING"状态时才能更新 Wait 任务，并且调用用户或应用程序必须具有更新该任务的权限。

:::note 在非 Wait 信号场景中使用 Update 任务可能会导致意外的副作用，因为它不是为这些用例设计的。 :::

任务参数

为 Update 任务配置以下参数。

参数	描述	必填/可选
inputParameters.status	要更新到的任务状态。支持的值：`IN_PROGRESSFAILEDFAILED_WITH_TERMINAL_ERRORCOMPLETED`可以作为变量传递。	必填
inputParameters.workflowId	包含要更新任务的工作流执行 ID。可以作为变量传递。默认值为 `${workflow.workflowId}`。	如果使用 `workflowId` 和 `taskRefName` 更新则为必填
inputParameters.taskRefName	要更新任务的引用名称。可以作为变量传递。	如果使用 `workflowId` 和 `taskRefName` 更新则为必填
inputParameters.taskId	要更新任务的执行 ID。可以作为变量传递。	如果使用 `taskId` 更新则为必填
inputParameters.taskOutput	将作为新任务输出更新的键值映射。支持字符串、数字、布尔值、null 和对象/数组。	可选
inputParameters.mergeOutput	确定输出是否与现有任务输出合并。默认值为 `false`。接受的值：`true` - 此任务生成的输出（taskOutput）将与现有任务输出合并`false` - 输出不会合并	可选

任务配置

以下是 Update 任务的任务配置示例。

使用 workflowId 和 taskRefName

{
  "name": "update_task",
  "taskReferenceName": "update_task_ref",
  "inputParameters": {
    "status": "COMPLETED",
    "mergeOutput": true,
    "workflowId": "${workflow.workflowId}",
    "taskRefName": "${workflow.input.taskRefName}",
    "taskOutput": {
      "key": "value"
    }
  },
  "type": "UPDATE_TASK"
}

使用 taskId

{
  "name": "update_task",
  "taskReferenceName": "update_task_ref",
  "inputParameters": {
    "status": "COMPLETED",
    "mergeOutput": false,
    "taskId": "taskID" // 硬编码值或作为变量传递
  },
  "type": "UPDATE_TASK"
}

任务输出

Update 任务将返回以下参数。

参数	描述
updatedTaskId	更新后任务的执行 ID
taskOutput	如果在输入参数中定义，则为任务的新输出

在 UI 中添加 Update 任务

添加 Update 任务的步骤：

在工作流中，选择 (+) 图标并添加 Update 任务。
选择更新任务所需的方法：使用 WorkflowId + Task Ref Name 或 Task ID。
根据选择的方法输入 Workflow ID 和 Task reference name，或 Task ID。
选择所需的 Task status。
（可选）如果需要，启用 Merge Output。
（可选）添加任何 Task output 参数。

Update 任务 ​

任务参数 ​

任务配置 ​

使用 workflowId 和 taskRefName ​

使用 taskId ​

任务输出 ​