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