插件节点 - 简道云

插件节点

1. 简介

插件节点，即在「智能助手Pro」中通过调用外部插件实现对数据的转换、加工、验证、通知等，还可存储插件的执行结果供后续节点调用。

插件节点适用于工作流中需要调用外部插件执行特定任务的场景，为工作流引入了灵活性和可扩展性。如：

以客户线索信息推送群消息为例，当「客户信息」表中新增客户资料时，自动向企业微信销售群推送消息：

新建智能助手Pro 后，将自动进入设计画布，配置好触发节点后，即可进行后续执行节点的配置。

点击安装插件节点模板，本文将按照模板中的示例表单进行讲解。

根据业务需求，在已有节点后添加一个插件节点：

当触发方式为「定时触发 >> 自定义时间」时，可选择插件读写表单，用于读取表单数据或将特定数据写入表单（仅支持选择当前应用内的表单）。

注：对于表单触发、根据表单日期时间触发、或插件无需读写表单的情况，无需进行该项配置，具体配置项仍以插件内容为主。

在下拉框中选择需要使用的插件，可选择在插件市场安装好的插件或自建插件，此处以「企业微信群机器人插件」插件为例：

选择好插件后，将自动展示该插件需要配置的请求参数，如企业微信群机器人插件需要配置对应群机器人的Webhook地址、消息模板等。如下图所示：

参数类型	说明
自定义	自定义输入固定值
字段值	选择前置节点上所存储数据的字段值，或如下值提交人提交时间数据链接应用/表单/数据 ID
组合	可自由组合文字、符号、前置节点中所存储的字段值和如下值应用/表单/表单字段/数据 ID 提交人的成员名称提交时间的时间戳数据链接的 URL 当次运行时间的时间戳（仅自定义时间触发时，可引用）开始时间的时间戳（仅定时触发时，可引用）结束时间/上次运行时间/下次运行时间的时间戳（仅重复触发时，可引用）插件读写表单的应用/表单/表单字段 ID（仅自定义时间触发，且选择了插件读写表单时，可引用）

注：

1）配置不同插件时，请求参数可配置的值不同，具体配置以插件内容为主；

2）选择前置节点上所存储数据的字段值和字段 ID 时，不支持选择子表单字段；

3）支持选择字段值和字段 ID 的前置节点包括：触发节点、计算节点、插件节点、查询单条数据节点、新增数据节点（单条数据）；

4）若插件节点在某条分支上，则不支持选择其他分支上的节点；若不在任意分支上，则不支持选择分支上的节点。

部分插件如银行卡姓名二元验证插件可返回执行结果。点击「添加」，并设置插件返回参数的数据类型，即可将插件的执行结果以字段的形式存储在当前插件节点中，便于后续节点调用。

注：

1）配置不同插件时，插件的返回参数不同，部分插件可能无执行结果，具体配置项以插件内容为主；

2）支持设置的数据类型包括：文本、数字、日期时间和数组。

插件的返回参数存储到字段后，该字段的功能触发、校验情况如下表：

如插件执行成功，在「执行日志 >> 节点执行详情」页中便可查看插件节点的处理时间和处理耗时等信息。

如插件执行失败，「智能助手Pro」将终止执行，并在执行日志中展示执行失败的报错。应用管理员/系统管理员/创建者可在「执行日志 >> 节点执行详情」处点击「重试」，以原设计版本、最新数据重新执行插件。

报错内容与失败原因的对应关系如下表所示：

目前已经上线的插件及其使说明参见：插件市场。