字段变量
字段变量用于把表单数据插入消息正文和触发动作目标中,让同一个模板可以适用于多条记录。
工作方式
选择关联表单后,通过添加字段选择字段。编辑器会插入携带运行时路径的变量:
{{record.data.contractCode}}
{{record.system.createdAt}}
{{record.relations.customer.data.customerName}}
消息渲染时,变量会替换为对应记录中的字段值。使用通用输入变量而不是关联表单的模板使用 input 路径:
{{input.taskName}}
可使用位置
| 位置 | 说明 |
|---|---|
| 消息正文 | 在主要内容中插入动态值,通常作为属性行的值 |
| 触发动作 | 当跳转目标依赖记录数据时,生成动态地址 |
| 上下文变量 | 插入表单和运行时的值,例如 {{form.name}}、{{runtime.locale}}、{{runtime.timezone}} |
底部文案最多 16 个字符,建议写成“查看详情”这类固定短语,把动态值放到触发动作里。
字段选择
字段选择器展示当前关联表单中的字段。部分关联字段可以展开,继续选择关联数据中的字段。记录 ID、创建时间、审批状态等系统字段也在同一个选择器中,对应 {{record.system.*}} 路径。
API 名称
变量在运行时路径中使用字段 API 名称。模板开始使用后,应尽量保持字段 API 名称稳定。字段重命名或删除后,需要检查引用它的模板。
示例
| 示例 | 结果 |
|---|---|
{{record.data.customerName}} | 插入客户名称 |
{{record.data.contractCode}} | 插入合同编号 |
{{record.data.ownerName}} | 插入负责人名称 |
只有随记录变化的内容需要使用变量。固定文案直接写在模板中即可。