进阶 docs.conductor-oss.org 2026-10-18 06:22:09 · 25 阅读

第3章 任务输入(Task Inputs)

连接任务输入 作为硬编码值 – "taskInputA": true 作为对工作流输入、工作流变量或先前任务输入/输出的动态引用 – "taskInputA": "${workflow.input.someValue}" 动态引用的语法 所有动态引用均采用以下表达式格式: "${type.jsonpath}" 这些动态引用采用点号表示法(dot-notation),遵循 JSONPath 语法。 组件 | 描述 ---|--- ${...} | 根标记,表示该变量将在运行时被动态替换。 | type | 引用类型。支持的取值:workflow—引用当前工作流实例。workflow.input—引用工作流的输入参数。workflow.output—引用工作流的输出参数。workflow.variables—引用通过 Set Variable 任务设置的工作流变量。taskReferenceName—通过引用名称引用当前工作流实例中的某个任务(例如 "http_ref")。taskReferenceName.input—引用该任务的输入参数。taskReferenceName.output—引用该任务的输出参数。 | jsonpath | 采用点号表示法的 JSONPath 表达式。 | 示例表达式 以下是你可使用的一组(非穷尽的)动态引用: 引用任务的输入负载 –
${.input} 引用任务的输出负载 –
${.output} 引用任务的输入参数 –
${.input.} 引用任务的输出参数 –
${.output.} 引用工作流的输入负载 –
${workflow.input} 引用工作流的输出负载 –
${workflow.output} 引用工作流的输入参数 –
${workflow.input.} 引用工作流的输出参数 –
${workflow.output.} 引用工作流的当前状态(RUNNING, PAUSED, TIMED_OUT, TERMINATED, FAILED, 或 COMPLETED) –
${workflow.status} 引用工作流的(执行)ID –
${workflow.workflowId} (用于子工作流) 引用父工作流的(执行)ID –
${workflow.parentWorkflowId} (用于子工作流) 引用父工作流中 Sub Workflow 任务的任务执行 ID –
${workflow.parentWorkflowTaskId} 引用工作流的名称 –
${workflow.workflowType} 引用 workflow 的版本:
${workflow.version} 引用 workflow 执行的开始时间:
${workflow.createTime} 引用 workflow 的关联 ID(correlation ID):
${workflow.correlationId} 引用 workflow 执行时被调用的域名:
${workflow.taskToDomain.} 引用通过 Set Variable task 创建的 workflow 变量:
${workflow.variables.} 示例 以下是在工作流中使用动态引用的几个例子。 引用工作流输入 给定如下工作流输入: { "userID": 1, "userName": "SAMPLE", "userDetails": { "country": "nestedValue", "age": 50 } } 你可以在其他位置使用以下表达式引用这些工作流输入: { "user": "${workflow.input.userName}", "userAge": "${workflow.input.userDetails.age}" } 运行时,参数将变为: { "user": "SAMPLE", "userAge": 50 } 引用其他任务输出 如果前一个任务 previousTaskReference 产生了以下输出: { "taxZone": "A", "productDetails": { "nestedKey1": "outputValue-1", "nestedKey2": "outputValue-2" } } 你可以在其他位置使用以下表达式引用这些任务输出: { "nextTaskInput1": "${previousTaskReference.output.taxZone}", "nextTaskInput2": "${previousTaskReference.output.productDetails.nestedKey1}" } 运行时,参数将变为: { "nextTaskInput1": "A", "nextTaskInput2": "outputValue-1" } 引用工作流变量 如果通过 Set Variable 任务设置了工作流变量: { "name": "Ipsum" } 则可以在同一工作流中使用以下表达式引用该变量: { "user": "${workflow.variables.name}" } 注意:工作流变量不能跨工作流引用,即使是父工作流和子工作流之间也不行。 在父工作流和子工作流之间引用数据 要将参数从父工作流传递到其子工作流,必须将这些参数声明为 Sub Workflow 任务的输入参数。如有需要,可以在子工作流定义内部使用 Set Variable 任务将这些输入设置为工作流变量。 // 包含任务配置的父工作流定义 { "createTime": 1733980872607, "updateTime": 0, "name": "testParent", "description": "workflow with subworkflow", "version": 1, "tasks": [ { "name": "get_item", "taskReferenceName": "get_item_ref", "inputParameters": { "uri": "https://example.com/api", "method": "GET", "accept": "application/json", "contentType": "application/json", "encode": true }, "type": "HTTP", }, { "name": "sub_workflow", "taskReferenceName": "sub_workflow_ref", "inputParameters": { "user": "${workflow.variables.name}", "item": "${previous_task_ref.output.item[0]}" }, "type": "SUB_WORKFLOW", "subWorkflowParam": { "name": "testSub", "version": 1 } } ], "inputParameters": [], "outputParameters": {} } 要将参数从子工作流传递回其父工作流,必须在子工作流定义中将其作为输出参数传递。 // 子工作流定义 { "createTime": 1726651838873, "updateTime": 1733983507294, "name": "testSub", "description": "subworkflow for parent workflow", "version": 1, "tasks": [ { "name": "get-user", "taskReferenceName": "get-user_ref", "inputParameters": { "uri": "https://example.com/api", "method": "GET", "accept": "application/json", "contentType": "application/json", "encode": true }, "type": "HTTP", }, { "name": "send-notification", "taskReferenceName": "send-notification_ref", "inputParameters": { "uri": "https://example.com/api", "method": "GET", "accept": "application/json", "contentType": "application/json", "encode": true }, "type": "HTTP", } ], "inputParameters": [], "outputParameters": { "location": "${get-user_ref.output.response.body.results[0].location.country}", "isNotif": "${send-notification_ref.output}" } } 在父工作流中,可以使用 `${.output.}` 格式的表达式引用这些子工作流输出。 故障排除 您可以通过检查 UI 中任务执行的输入/输出值来验证数据是否传递正确。常见错误包括: 如果引用表达式格式不正确,被引用的参数值可能会变为错误数据或 null。 如果被引用的值(如任务输出)在引用时尚未解析,则被引用的参数值将为 null。

评论 (0)