插件节点

注:新增的插件节点功能仅支持新版流程,老用户(2022 年 10 月 12 日以前注册的用户)需迁移后才可使用,后续简道云将逐步为老用户安排迁移工作。

1. 简介

1.1 功能简介

插件节点一种流程处理节点,可通过调取外部插件实现对流程数据的转换、加工、验证、通知等,进而达到流程的自动化管理。

1.2 应用场景

  • 活动报名时,报名人填写报名信息后,可先流转至插件节点对报名人的姓名、手机号码、身份证号等进行验证,验证成功后再由负责人审核;
  • 报销审批时,报销发票上传后,可先经由插件节点对发票进行验真、识别等,插件审核完成后再流转至财务负责人处理;
  • 设备维修时,接收到客户订单后,通过流程表发起派单流程并分配给维修师傅,此时可通过插件节点对维修师傅进行语音、短信提醒等。

1.3 预期效果

以活动报名的场景为例,发起流程时填写报名信息,然后流转至插件节点验证姓名和手机号码的一致性,验证通过后,再由审核人员审批,效果如下:

1.4 版本说明

本功能为付费高级功能,需简道云标准版及以上版本可用。

2. 设置步骤

以活动报名场景中验证手机号姓名为例:

2.1 表单搭建

新建「报名表」表单,字段设置如下所示:

字段名称

字段类型

报名活动

下拉框

参加时间

下拉框

所在企业

单行文本

姓名

手机号

校验状态

校验结果

审批结果

单选按钮组

2.2 设置入口

进入「流程设定」,在工具栏中选择「插件节点」,将其拖动至流程图中,通过流程连接线将全部流程节点串联起来:

注:插件节点至少需要有一条流入线和一条流出线。

2.3 插件节点配置

1)选中插件节点,在「节点属性 >> 节点名称」处设置节点名称为「插件-手机号姓名验证」,然后点击「插件配置」:

2)进入插件配置页面,在下拉框中选择要使用的插件,可选择在 插件市场 安装好的插件或 自建插件,此处以「手机号姓名二元验证」插件为例:

3)选择好插件后,将自动展示该插件需要配置的请求参数,如手机号姓名二元验证插件中的手机号码姓名,请求参数可配置的值包括如下三种:

  • 自定义:自定义输入固定值
  • 字段值:选择表单中的字段值
  • 组合:可添加如下值的组合作为请求参数
    • 表单字段的文本或 ID
    • 提交人的成员名称
    • 提交时间的时间戳
    • 数据链接的 URL
    • 应用/表单/数据 ID

4)点击「添加」,设置插件的返回参数的存储关系,将返回值存储到表单已有字段中,如手机号姓名二元验证插件中的校验状态校验结果,设置完成点击「确定」。

注:配置不同插件时会有不同的配置内容,具体配置项以插件内容为主。

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

功能/校验

处理规则

触发数据工厂延时计算

触发

触发表单日期时间提醒

触发

触发聚合表计算

触发

触发 Webhook 数据推送

触发

触发智能助手

触发

重复值校验、表单校验、必填校验

不校验

聚合表校验

不校验

触发联动、公式、默认值获取

不触发

2.4 插件执行

2.4.1 执行成功

如插件执行成功,流程将继续流转,在流程动态中可以查看插件节点的处理时间和处理耗时等信息,并可以根据设置存储返回参数,效果如下:

2.4.2 执行失败

如插件执行失败,流程将停留在该插件节点,并在流程动态中展示执行失败的报错。应用管理员/系统管理员/创建者可在流程动态处点击「重试」,以原流程版本、最新数据重新执行插件。

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

报错内容

失败原因

插件已停用

插件停用

插件已卸载

插件卸载

付费版本过期

版本到期

云币余额不足

云币余额不足

未开启云币支付

未开启云币支付

执行超时

插件执行过程失败-超时

同步数据量超过 50000 条

插件执行过程失败-数据量超出

ErrorMesssage(插件报错,内容不定)

插件执行过程失败-外部错误&插件代码错误

未知错误

插件执行过程失败-其他错误

3. 注意事项

1)激活流程时,不显示插件节点。

2)流程处于插件节点时,不支持手动结束流程、调整节点负责人、催办。

3)如流程中包含插件节点,执行 流程回退 时不能回退至插件节点,否则将出现报错。

Copyright(C)2023 HFBangFu Inc. All Rights Reserved 皖ICP备12017563号-5