进阶 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。
${
${
${
${
${workflow.input} 引用工作流的输出负载 –
${workflow.output} 引用工作流的输入参数 –
${workflow.input.
${workflow.output.
${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.
${workflow.variables.