搜索
更新人
更新时间 更新日期

1. 简介

1.1 功能概述

插件节点是一种流程处理节点,通过在流程中调用外部 插件 (包括自建插件和已安装的第三方插件),实现对流程数据的转换、加工、验证或通知,扩展工作流的功能边界。插件返回的信息可用于更新表单字段或新增数据记录,从而实现 系统与外部服务的高效交互

1.2 应用场景

  • 发票归集与版式文件下载:使用插件自动从税务局接口获取发票全量信息并回填至表单,实现票据的自动化验真与归档。
  • 电商平台订单数据同步:使用插件从电商平台(如淘宝、京东、Shopify)拉取订单信息更新至平台,方便执行后续生产发货等操作。
  • 智能通知与消息触达:调用消息通知插件,根据预设策略将关键信息精准推送给相关人员。

1.3 版本说明

插件节点所需的外部插件功能仅面向 企业版及以上用户 开放,使用前请确保插件功能已开通。更多内容详见:开放平台

1.4 前提条件

使用插件节点前,请确保满足以下条件:
  • 插件已安装或创建完成,并处于 启用状态 ,具体参见:插件管理 插件市场
  • 操作界面已进入工作流编辑页面,具体参见:工作流

2. 设置入口

操作路径:进入 工作流编辑页面 >> 点击画布中的「+」按钮 >> 选择「插件节点」。
演示图片:节点入口图片

3. 操作指南

3.1 节点说明

进入工作流编辑页面,点击「插件节点」,可唤起右侧配置窗口。窗口中可配置节点名称、执行插件、数据源、插件发送参数 返回参数处理方式
演示图片:节点说明图片

3.2 节点配置

插件节点的配置需按顺序完成以下五个核心步骤:选择执行插件 >> 选择数据源 >> 配置数据源筛选与排序 >> 设置插件发送参数 >> 设置返回参数处理方式。
3.2.1 选择执行插件
点击执行插件下拉框,可查看所有处于 启用 状态的插件,选择目标插件进行使用。当插件较多时,可使用 搜索功能 对插件进行快速定位。
演示图片:选择插件图片
3.2.2 设置数据源
选择好执行插件后,需要对 数据源 进行设置。插件节点只支持使用 单条数据 的字段作为插件参数。插件节点中对数据源的设置包括:选择数据源 >> 筛选数据源 >> 设置数据排序。
1)选择数据源:插件节点支持以下五种方式选择数据源。
  • :适用于插件不需要任何参数的情况。选择该选项时,不需要 进行后续对数据源的设置。
演示图片:选择数据源-无-图片
  • 从普通表单中获取:点击下方下拉框,可以选择 应用内 的表单,支持输入 关键词搜索 相关表单。
演示图片:普通表单获取数据源图片
  • 从数据节点中获取:点击下拉框,可选择 上游节点 作为数据源,可选节点包括「当前发起的表单」、「新增数据」节点(仅限新增单条数据)以及「获取单条数据」节点。
演示图片:数据节点获取数据源图片
  • 从关联表单中获取:工作流中关联表单关系主要通过「选择数据」字段建立。点击第一个下拉框可从中选择 被关联表单(包含「选择数据」字段),点击第二个下拉框可选择被关联表单中 对应的「选择数据」字段。系统将自动获取该字段所指向的表单记录。
演示图片:关联表单获取数据源图片
  • 从子表获取数据:该方式主要通过表单中的「子表单」字段实现。点击第一个下拉框,可选择应用中的任一表单作为 主表单(含「子表单」字段),点击第二个下拉框选择主表单下对应的「子表单」字段
演示图片:子表获取数据源图片
2)筛选数据源:在选定数据源后,可以配置筛选条件进行数据指定或过滤。
  • 确定 逻辑关系:选择同时满足 所有 条件/条件组或 任一 条件/条件组。
  • 添加 筛选字段:点击「添加过滤条件」,选择表单字段并设置筛选条件;点击「添加条件组」,可添加自定义条件组,实现更灵活的条件判断。
  • 设置 匹配规则:根据业务需求选择匹配规则,例如等于、不等于、包含、不包含、为空、不为空,或针对集合类的等于任意一个、不等于任意一个。
  • 填充 条件判断值,支持以下五种填充方式:
    • :填写自定义值,填写方式取决于字段类型。
    • 字段:从上游节点字段中选取。支持包括「表单触发」、「新增数据」、「获取单条数据」、「获取多条数据」等节点,且所选字段类型需与当前字段类型一致。
    • 公式:通过公式对工作流中的字段值进行计算。
    • 参数:使用子流程触发节点中配置的参数(仅子流程场景支持)。
    • 空值:直接填充空值。
  • 根据填充方式输入字段值。
演示图片:筛选数据源图片
3)设置排序规则:若数据筛选后仍有多条满足条件的记录,可以通过数据源表单中的日期时间字段进行数据排序,包括 不排序、升序、降序 三种排序规则。节点会按设置好的排序规则获取 第一条数据
演示图片:排序规则图片
3.2.3 设置插件发送参数
对于有发送参数的插件,需要设置插件的发送参数。插件发送参数分为 必填参数 非必填参数 。必填参数在参数名前会用 星号(*) 标识,必须配置,否则请求可能发送失败。
对于参数的填写,支持以下三种填充方式:
  • 组合:使用 自定义文字 当前表单字段值 的组合进行填充,点击输入框后方的「+」可以在文本间 插入表单字段
  • 自定义:自定义值填充,可以输入固定的文本内容或数值。
  • 字段值:下拉选择当前表单字段,填写表单时使用该 字段内容 进行填充。
演示图片:插入参数图片
3.2.4 设置返回参数处理方式
在「接收数据」栏,可以设置对插件返回数据的处理,有以下四种处理方式:
1)无需处理:选择「无需处理」,将不会对插件返回数据执行任何处理。
演示图片:无需处理图片
2)新增数据:点击「新增数据」可以把插件返回数据作为新记录添加到表单中。若返回的是 数组结构 ,则支持在表单或表单子表中 新增多条记录
  • 设置列表配置:某些插件会返回 数组结构,可以使用列表配置将插件返回的数组数据填写到目标表单中。
  • 配置步骤:点击「添加配置」按钮 >> 点击「操作表单」下拉框 >> 选择 目标表单 >> 点击「插件数组」下拉框 >> 选择插件返回的数组。
演示图片:新增数据-列表配置图片
  • 数据填充:使用数组内属性填充新增表单中的字段值。设置步骤:点击「新增」按钮 >> 选择插件中 需录入的返回数据 >> 选择 对应的表单字段
演示图片:新增数据-填充图片
3)删除数据:指在收到插件返回消息后,系统自动删除满足条件的表单记录。操作步骤:选择 操作表单 >> 点击「配置条件」按钮 >> 设置 筛选条件
演示图片:删除图片
4)更新数据:指使用返回的数据更新表单字段。操作步骤如下:选择 数据节点 >> 点击「新增」按钮 >> 选择插件中需录入的 返回数据 >> 选择表单中对应的 更新字段
演示图片:更新数据图片
注意 :选择数据节点只支持选择含有 单条数据 的数据节点,即「新增数据」(新增单条)、「当前发起的表单」以及「获取单条数据」节点。

4. 注意事项

  • 插件节点中只能选择 本企业已安装或自建的插件 。如需安装插件,可前往插件市场进行安装,或联系我们(400-920-4330)进行定制。
  • 插件节点中选择的插件必须是 处于启用状态 的插件,否则节点将无法执行。
  • 插件的配置和调用需要用户具备一定的软件知识。如遇困难,可联系平台工作人员协助。