4.11. 添加模板步骤
在流中,模板步骤从源获取数据并将其插入到您上传到 Fuse Online 的模板中定义的格式。模板步骤的好处是它会以您指定的一致格式提供数据输出。
在模板中,您可以定义占位符并指定静态文本。在创建流时,您可以添加模板步骤,将 source 字段映射到模板占位符,然后将模板内容映射到流中的下一步。当 Fuse Online 执行流时,它会将映射源字段中的值插入到模板实例中,并使结果可用于流中的下一步。
如果流包含模板步骤,则很可能是该流中唯一的模板步骤。但是,允许流中的多个模板步骤。
Fuse Online 支持以下模板: Freemarker、Melociti、Vel ociy.
先决条件
- 您必须创建或编辑流。
- 如果您要创建简单集成,那么它必须已经拥有它的启动和完成连接。
流程
- 在流视觉化中,点您要添加模板步骤的 。
- 单击 Template。此时会打开 Upload Template 页面。
- 指定模板类型,即 Freemarker、M Mustache 或 Velocity。
要定义模板,请执行以下操作之一:
- 将模板文件或包含您要修改的文本的文件拖放到模板编辑器中。
- 单击 浏览以上传,导航到文件并上传该文件。
- 在模板编辑器中,开始键入 以定义模板。
- 在模板编辑器中,确保模板对 Fuse Online 有效。此流程后,有效模板的示例为。Fuse Online 在一行的左侧显示 ,其中包含语法错误。将鼠标悬停在语法错误指示器上会显示关于如何解决错误的提示。
点 Done 将模板步骤添加到流中。
如果没有启用 Done 按钮,则至少有一个语法错误必须正确。
到模板步骤的输入必须采用 JSON 对象的形式。因此,您必须在模板步骤前添加数据映射步骤。
要在模板步骤前添加数据映射程序步骤:
- 在流视觉化中,点您刚刚添加的模板步骤前的 。
- 单击 Data Mapper。
在数据映射器中,将 source 字段映射到每个模板占位符字段。
例如,使用此流程后的示例模板,将 source 字段映射到每个模板字段:
-
time
-
name
-
text
-
- 在右上角,点 Done 将数据映射程序步骤添加到流中。
模板步骤的输出始终是一个 JSON 对象。因此,您必须在模板步骤后添加数据映射程序步骤。
在模板步骤后添加数据映射程序步骤:
- 在流视觉化中,点您刚刚添加的模板步骤后立即使用 。
- 单击 Data Mapper。
- 在数据映射器中,将模板的 消息字段 映射,该字段始终包含将源字段插入到模板中的结果到目标字段。例如,假设 Gmail 连接在流中下一步,您想要发送模板步骤的结果作为 Gmail 消息的内容。为此,您要将 message source 字段映射到 文本 目标字段。
- 在右上角,单击 Done。
模板示例
Mustache 模板示例:
At {{time}}, {{name}} tweeted: {{text}}
FreeMarker 和 Velocity 支持这个示例模板:
At ${time}, ${name} tweeted: ${text}
velocity 还支持没有大括号的语法,如下例所示:
At $time, $name tweeted: $text
占位符不能包含 .
(句点)。
其他资源
有关映射字段的详情,请参阅 将集成数据映射到下一连接的字段。