插件节点
注:新增的插件节点功能仅支持新版流程,老用户(2022 年 10 月 12 日以前注册的用户)需迁移后才可使用,后续简道云将逐步为老用户安排迁移工作。
1. 简介
1.1 功能简介
插件节点一种流程处理节点,可通过调取外部插件实现对流程数据的转换、加工、验证、通知等,进而达到流程的自动化管理。
1.2 应用场景
- 活动报名时,报名人填写报名信息后,可先流转至插件节点对报名人的姓名、手机号码、身份证号等进行验证,验证成功后再由负责人审核;
- 报销审批时,报销发票上传后,可先经由插件节点对发票进行验真、识别等,插件审核完成后再流转至财务负责人处理;
- 设备维修时,接收到客户订单后,通过流程表发起派单流程并分配给维修师傅,此时可通过插件节点对维修师傅进行语音、短信提醒等。
1.3 预期效果
以活动报名的场景为例,发起流程时填写报名信息,然后流转至插件节点验证姓名和手机号码的一致性,验证通过后,再由审核人员审批,效果如下:
1.4 版本说明
本功能为付费高级功能,需简道云标准版及以上版本可用(试用版可进行试用)。详情参见:官网定价。
注:每天、每个企业可触发插件的次数上限为 2 万次。
2. 设置步骤
以活动报名场景中验证手机号姓名为例:
2.1 表单搭建
新建「报名表」表单,字段设置如下所示:
字段名称 | 字段类型 |
报名活动 | 下拉框 |
参加时间 | 下拉框 |
所在企业 | 单行文本 |
姓名 | |
手机号 | |
校验状态 | |
校验结果 | |
审批结果 | 单选按钮组 |
2.2 设置入口
进入「流程设定」,在工具栏中选择「插件节点」,将其拖动至流程图中,通过流程连接线将全部流程节点串联起来:
注:插件节点至少需要有一条流入线和一条流出线。
2.3 插件节点配置
1)选中插件节点,在「节点属性 >> 节点名称」处设置节点名称为「插件-手机号姓名验证」,然后点击「插件配置」:
3)选择好插件后,将自动展示该插件需要配置的请求参数,如手机号姓名二元验证插件中的手机号码和姓名,请求参数可配置的值包括如下三种:
- 自定义:自定义输入固定值
- 字段值:选择表单中的字段值
- 组合:可添加如下值的组合作为请求参数
- 表单字段的文本或 ID
- 提交人的成员名称
- 提交时间的时间戳
- 数据链接的 URL
- 应用/表单/数据 ID
4)点击「添加」,设置插件的返回参数的存储关系,将返回值存储到表单已有字段中,如手机号姓名二元验证插件中的校验状态和校验结果,设置完成点击「确定」。
注:配置不同插件时会有不同的配置内容,具体配置项以插件内容为主。
插件的返回参数存储到字段后,该字段的功能触发、校验情况如下表:
功能/校验 | 处理规则 |
触发数据工厂延时计算 | 触发 |
触发表单日期时间提醒 | 触发 |
触发聚合表计算 | 触发 |
触发 Webhook 数据推送 | 触发 |
触发智能助手 | 触发 |
重复值校验、表单校验、必填校验 | 不校验 |
聚合表校验 | 不校验 |
触发联动、公式、默认值获取 | 不触发 |
2.4 插件执行
2.4.1 执行成功
如插件执行成功,流程将继续流转,在流程动态中可以查看插件节点的处理时间和处理耗时等信息,并可以根据设置存储返回参数,效果如下:
2.4.2 执行失败
如插件执行失败,流程将停留在该插件节点,并在流程动态中展示执行失败的报错。应用管理员/系统管理员/创建者可在流程动态处点击「重试」,以原流程版本、最新数据重新执行插件。
报错内容与失败原因的对应关系如下表所示:
报错内容 | 失败原因 |
插件已停用 | 插件停用 |
插件已卸载 | 插件卸载 |
付费版本过期 | 版本到期 |
云币余额不足 | 云币余额不足 |
未开启云币支付 | 未开启云币支付 |
执行超时 | 插件执行过程失败-超时 |
同步数据量超过 50000 条 | 插件执行过程失败-数据量超出 |
ErrorMesssage(插件报错,内容不定) | 插件执行过程失败-外部错误&插件代码错误 |
未知错误 | 插件执行过程失败-其他错误 |
3. 注意事项
1)激活流程时,不显示插件节点。
2)流程处于插件节点时,不支持手动结束流程、调整节点负责人、催办。
3)如流程中包含插件节点,执行 流程回退 时不能回退至插件节点,否则将出现报错。
4)插件节点属于系统自动流转的节点,在流程设定时禁止插件节点成环、插件节点与异步子流程成环。
5)若流程表单的流程设定为「流程发起节点 >> 插件流程 >> 剩余节点」,通过数据管理、智能助手、数据工厂或 API 导入发起流程 时,或者是通过父流程发起该流程时,所有流程都会停留在发起节点。