更新日期
1. 简介
1.1 功能概述
插件节点支持在流程中调用插件（包括自建插件和已安装的第三方插件），扩展流程功能。通过该节点，工作流可以获取插件返回的数据，并将其新增或更新至表单字段，从而实现系统与外部服务的高效交互。
1.2 应用场景
- 发票归集与版式文件下载： 使用插件自动从税务局接口获取发票全量信息并回填至表单，实现票据的自动化验真与归档。
- 电商平台订单数据同步：使用插件从电商平台（如淘宝、京东、Shopify）拉取订单信息更新至平台，方便执行后续生产发货等操作。
- 智能通知与消息触达： 调用“消息通知”插件，根据预设策略将关键信息精准推送给相关人员。
2. 功能说明
2.1 前置事件
2.1.1 安装或创建插件
插件节点需配合插件功能使用，在调用插件前必须确保插件已安装或创建完成，并处于启用状态，插件功能面向企业版及以上用户开放，在使用前请确保插件功能可用。更多内容详见：开放平台。
一、插件的安装步骤：
1）进入开放平台：登录网站后在企业工作台中找到“为您推荐”组件，选择“精选插件”，点击右下角的“进入开放平台”，即可进入英雄云插件页面。
2）在插件市场浏览安装插件：点击插件市场，选择对应插件，进入插件详情页，在详情页中点击“安装”即可安装插件。
二、创建自建插件
在英雄云平台中，用户可以根据自身需求基于API自建企业专属的插件，在应用中进行调用，实现与第三方平台的业务协作。关于自建插件的设置步骤，请参考文档：自建插件。
2.1.2 启用插件
只有处于启用状态的插件才可以在插件节点中使用。
有些插件在启用前需要先进行配置参数的填写：
2.1.3 创建流程
在应用管理后台的「工作流」页面中，点击已有工作流或者点击右上方「+工作流」按钮新建工作流，进入工作流编辑界面。
2.2 添加子流程节点
点击节点之间的「+」号，在弹出的菜单中选择「插件节点」添加到当前工作流。
点击「插件节点」唤起右侧节点配置窗口。
2.3 选择插件
可以执行插件下拉框，可查看所有处于启用状态的插件，直接选择目标插件即可。当插件较多时，可使用搜索栏可以快速定位插件。
2.4 设置数据源
选择好执行插件后，需要对数据源进行设置，数据源是指提供插件发送参数的表单数据，插件节点只支持使用单条数据的字段作为插件参数。插件节点中对数据源的设置包括：① 选择数据源；② 筛选数据源；③ 设置数据排序。
2.4.1 选择数据源
插件节点中支持四种方式选择数据源：
1）无：适用于插件不需要任何参数的情况，选择该选项时，不需要进行后续对数据源的设置。
2）从普通表单中获取：当选择“从普通表单中获取”时，点击下方下拉框，可以选择 应用内 及 跨应用 的表单。支持在输入框中输入关键词搜索相关表单，比如搜索与“发票”相关的表单。
3）从关联表单中获取：工作流中关联表单关系主要通过「选择数据」字段建立。
当选择“从关联表单中获取”时：
① 在第一个下拉框中选择流程历史节点作为被关联表单（包含「选择数据」字段），可选节点包括「当前发起的表单」、「新增数据」节点（仅限新增单条数据）以及「获取单条数据」节点；只支持使用单条记录作为数据
② 在第二个下拉框中，选择对应的「选择数据」字段。系统将自动获取该字段所指向的表单记录。
4）从子表中获取数据：支持获取子表单记录。其设置步骤为：
① 选择“从子表中获取数据”；
② 选择主表单：在第一个下拉框中选择流程历史节点作为主表单（包含「子表单」字段），可选节点包括「当前发起的表单」以及「获取单条数据」节点；
③ 选择子表单：在第二个下拉框中，选择对应的「子表单」字段。
① 选择“从子表中获取数据”；
② 选择主表单：在第一个下拉框中选择流程历史节点作为主表单（包含「子表单」字段），可选节点包括「当前发起的表单」以及「获取单条数据」节点；
③ 选择子表单：在第二个下拉框中，选择对应的「子表单」字段。
2.4.2 筛选数据源
在选定数据源后，可以配置筛选条件进行数据指定或过滤。主要步骤为：
1）设置整体条件关系：设置整体条件的逻辑关系为全部条件/条件组都满足还是只需要满足任一条件/条件组。
2）新增筛选条件：可以点击「添加过滤条件」选择对应字段设置单个筛选条件；或者点击「添加条件组」在整体组合逻辑下嵌套子条件组。
3）设置判断关系：支持“等于”、“不等于”、“等于任意一个”、“不等于任意一个”、“包含”、“不包含”、“为空”、“不为空”8种情况。
4）设置判断值：关于条件判断值的填充有以下五种方式。
- 值：使用自定义值填写，填写方式依据字段类型的不同而不同，比如日期字段可通过日历选择、下拉框使用下拉选择等；
- 字段：使用历史节点字段填入，下拉选择节点后，可展开查看其所有可选字段。支持选择的节点类型包括「表单触发」、「新增数据」、「获取单条数据」、「获取多条数据」，可选字段为类型相同字段；
- 公式：公式填写可以使用公式对工作流中所有字段值进行计算，公式的编辑与表单公式编辑类似，具体可参考：编辑公式 ；
- 参数：参数是指在子流程开始节点中设置的参数，只有在子流程中支持使用该填写方式，具体可参考：子流程触发节点 ；
- 空值：填充空值。
2.4.3 设置排序规则
若数据筛选后仍有多条满足条件的记录，节点会按设置好的排序规则获取第一条数据。
对于数据排序我们可以选择“不排序”、“升序”与“降序”，不同规则对应不同的排序方式。
- 不排序：对筛选后的数据不执行排序，选取查询到的第一条记录作为数据来源；
- 升序：选择表单中的具体字段作为排序字段，以该字段执行升序排序，选取第一条记录；
- 降序：选择表单中的具体字段作为排序字段，以该字段执行降序排序，选取第一条记录；
2.5 设置插件发送参数
对于有发送参数的插件，需要设置插件的发送参数。插件发送参数分必填参数和非必填参数，必填参数在参数名前会用星号标识，必填参数是发送请求时必须配置的，否则请求可能发送失败。
对于参数的填写，与表单前端事件配置类似，支持三种填充方式：
- 自定义：自定义值填充，可以输入固定的文本内容或数值；
- 字段值：下拉选择当前表单字段，填写表单时使用该字段内容进行填充；
- 组合：使用文字和当前表单字段值的组合进行填充，点击输入框后方的「+」可以在文本间插入表单字段。
2.6 返回参数设置
在「接收数据」栏，可以设置对插件返回数据的处理，可选方式有：① 无需处理；② 新增数据；③ 删除数据；④ 更新数据
2.6.1 无需处理
选择「无需处理」，将不会对插件返回数据执行任何处理。
2.6.2 新增数据
点击「新增数据」可以把插件返回数据作为记录添加到表单中，若返回的是数组结构，则支持在表单或者表单子表中新增多条记录。
操作步骤为：
1）选择操作表单：在操作表单下拉框中下拉选择应用内表单；
2）设置列表配置：对于返回的数组结构体，可以使用列表配置设置数组元素对应的填写表单（主表或子表），则返回的数据将会添加到对应的表单中。
设置步骤：
a. 点击下方「添加配置」按钮添加配置行；
b. 在“操作表单”下拉框中选择数组元素对应的填写表单，既可以选择主表也可以选择子表；
c. 在“插件数组”下拉框中选择插件返回数据中的对应数组结构。
3）数据填充：使用数组内属性填充新增表单中的字段值。
设置步骤：
a. 点击下方「新增」按钮添加字段；
b. 在“插件返回参数”列下拉框下拉选择需录入的返回数据；
c. 在“接收的表单字段”列下拉框下拉选择对应表单字段。
2.6.3 删除数据
删除数据指在收到插件返回消息后删除表单中的记录。
操作步骤：
1）选择操作表单；
2）点击「配置条件」弹出条件设置窗口；
3）在弹出的条件设置窗口中设置筛选条件。
则在收到插件返回消息后系统会删除对应的记录。
2.6.4 更新数据
更新数据是指使用返回的数据更新表单字段。
操作步骤：
1）选择数据节点：更新数据前需要使用对应的数据节点获取需要更新的表单记录，只支持选择含有单条数据的数据节点，即“新增数据”、“当前发起的表单”以及“获取单条数据”；
2）新增更新字段：点击数据填充表下方「新增」按钮添加更新字段设置行；
3）选择返回数据：在“插件返回参数”列下拉框下拉选择进行更新覆盖的返回数据；
4）选择接收的表单字段：在“接收的表单字段”列下拉框下拉选择对应表单字段。
3. 注意事项
1）插件节点中只能选择本企业安装或者自建的插件，需要插件可以到插件市场进行安装或者联系我们定制：400-920-4330 ；
2）插件节点中选择的插件必须是处于启用状态的插件；
3）插件的配置和调用需要用户有一定的软件知识，如遇困难，可联系平台工作人员协助。
如需获得更多帮助，请
联系我们
微信扫码
专业客服答疑
联系电话
400-920-4330
