Skip to content

第三方表单集成

概述

在表单使用第三方表单引擎或第三方表单页面时,与流程引擎的集成实现方案。

如果表单使用的HTML或AI生成的,可以参考AI表单集成工作流,采用AI编程工具0编码集成。

img.png

更新内容

集成前需要先更新以下内容:

点击查看详情
  1. 自定义表单:URL 去掉 FTL 校验(不再提示「请输入正确格式的 ftl 模板路径」)。详见 自定义表单管理

  2. V8.2.3 REST 接口:创建或打开流程实例时,返回绑定的自定义表单的表单 URL 和库表名称。详见 创建实例打开流程

集成步骤

1、自定义表单

在流程菜单中新增自定义表单,用于流程设计使用。

进入菜单「流程管理 → 自定义表单」,新建表单:

字段说明
名称可与业务系统表单名保持一致
URL能代表表单页面的值,比如表单 ID 或者表单的 URL 都可,用于打开流程时,知道打开哪个业务页面
分类可为空,也可输入新分类后回车
数据源需要获取业务表单的字段,用于流程节点设置字段权限使用;如果是第三方数据库,可参考 如何配置第三方数据源 配置业务数据库信息
数据表选择表单对应的数据表

先点击「导入」,再点击「保存」,提示保存成功即可。

说明

如果是为了快速测试,也可以选择 system 数据源后,任选一张表使用。

2、流程建模

新建流程时,在表单设置中,增加自定义表单,允许选择多个表单:

在流程节点上设置不同身份的字段权限:

支持四种类型设置:

3、发起流程

根据流程 ID 调用流程创建,在业务系统里常见的两种申请入口:

  • 申请入口 1:业务系统配置固定位置,指定 flowId,用户点击时根据 flowId 创建流程
  • 申请入口 2:获取启动新工作列表,展示用户,用户选择其一时,根据 flowId 创建流程

用户在前端点击后,取到 flowId,进入后台指定流程创建,根据流程创建返回的表单 URL、表单字段权限、操作按钮,跳转前端页面。

用户填写信息后,可点击提交等操作。

创建返回值示例:

相关接口说明请参考 创建实例

4、提交流程(暂存、退回、拿回等流程操作)

用户在前台点击操作按钮时,获取表单字段值及操作按钮信息提交后台,在后台自行存储业务数据(也需要存实例 ID:workId),然后再调用流程操作(提交、退回等)。

根据返回值判断是否需要返回前台让用户选择节点或选择办理人,前台选择后再次提交后台,直到返回成功。

下一个办理人就可以在待办中查收办理。

相关接口说明请参考 流程操作说明

5、获取待办

调用待办接口,展示待办列表。

用户办理点击某一条时,根据待办里的 workId、trackId、subjection,调用打开接口,获取到表单 URL、表单字段权限、操作按钮,跳转前端页面(与流程创建接口返回值一样),前台跳转页面并做页面渲染。

用户即可查看表单信息及点击提交、退回等操作。

相关接口说明请参考 待办列表打开流程