模板变量

在文本内容中通过 {{ }} 语法引用消息中的数据，运行时自动替换为实际值。

基本语法

{{ msg.字段路径 }}

json

// payload
{
  "input": { "orderId": "ORD-001" },
  "output": {
    "title": "部署完成",
    "version": "1.2.0",
    "count": 5
  }
}

// 模板
{{msg.output.title}}：版本 {{msg.output.version}}，共处理 {{msg.output.count}} 条
订单号：{{msg.input.orderId}}

// 输出
部署完成：版本 1.2.0，共处理 5 条
订单号：ORD-001

当引用的字段是对象或数组时，自动转换为 JSON 字符串。

json

// payload
{
  "output": {
    "user": { "name": "张三", "age": 28 },
    "tags": ["紧急", "待审批"]
  }
}

// 模板
用户信息：{{msg.output.user}}
标签列表：{{msg.output.tags}}

// 输出
用户信息：{"name":"张三","age":28}
标签列表：["紧急","待审批"]

TIP

如需只取某个具体字段，建议直接引用完整路径：{{msg.output.user.name}}

当路径中某一层字段可能为 null 时，使用 ?. 代替 .，整个表达式安全返回空字符串。

WARNING

路径中间层为 null 时，必须使用 ?.，否则会报错并中断替换。

json

// payload（user 为 null）
{
  "output": {
    "title": "审批通知",
    "user": null,
    "extra": { "remark": "测试环境" }
  }
}

// 模板
标题：{{msg.output.title}}
申请人：{{msg.output.user?.name}}
备注：{{msg.output.extra?.remark}}
地址：{{msg.output?.address?.city?.name}}

// 输出
标题：审批通知
申请人：
备注：测试环境
地址：

WARNING