Springboot +Flowable，流程表单应用之外置表单（JSON形式）（二）

一.简介

整体上来说，我们可以将Flowable 的表单分为三种不同的类型：

动态表单
这种表单定义方式我们可以配置表单中每一个字段的可读性、可写性、是否必填等信息，不过不能定义完整的表单页面。
外置表单
外置表单我们只需要定义一下表单的 key，至于这个 key 对应的表单是什么样子，则由开发者自己去维护。
内置表单
这是内置的表单定义以及渲染引擎，

另外需要注意的，Flowable 中有很多不同类型的节点，但是只有开始节点和任务节点是支持表单定义的，其他节点均不支持表单定义。

在前面的案例中，定义的表单使用了 HTML，实际上这个表单不仅可以使用 HTML，也可以使用 JSON 来定义表单。

二.默认规则

使用 JSON 来定义 Flowable 表单，可以利用 Spring Boot 中的默认机制，即将表单文件置于 classpath:forms 目录下，那么在系统启动的时候，表单文件就会被自动部署。并且默认情况下，表单文件的后缀是 .form。

不过对于默认的表单文件位置和表单文件后缀，也可以通过在 application.properties 配置文件中添加如下内容进行修改，代码如下：

# 默认的表单文件后缀
flowable.form.resource-suffixes=**.form
# 默认的表单文件位置
flowable.form.resource-location=classpath*:/forms/

三.创建表单

还是以请假请求为例，创建一个表单文件，文件名为 application_form.form，代码如下：

{"key": "application_form.form","name": "经理审批表单","fields": [{"id": "days","name": "请假天数","type": "string","required": true,"placeholder": "empty"},{"id": "reason","name": "请假原因","type": "string","required": true,"placeholder": "empty"},{"id": "startTime","name": "开始时间","type": "date","required": true,"placeholder": "empty"},{"id": "endTime","name": "结束时间","type": "date","required": true,"placeholder": "empty"}]
}

这个 key 就是表单的唯一标识符，当有多个表单的时候，这个该值不可以重复，name 是表单是名称，fields 则定义了具体的字段，这里一共有四个。

在每一个 filed 的定义中，id 表示字段名，name 则是字段的中文名称，type 表示字段的类型，require 则表示这个字段是否是必填字段，placeholder 不用多说，跟我们日常使用的 input 标签中的 placeholder 的含义一致。

现在就创建好了。

注意：
由于 .form 文件，在 IDEA 中，默认会被当成 Swing 里边的 form 去处理，所以需要提前先用其他的编辑器写好 .form 文件，然后再拷贝到 IDEA 中即可。

四.创建流程

接下来创建一个流程图，流程中引用这个表单。流程图如下：
在这里插入图片描述
在流程图的三个 UserTask 中，分别通过如下方式去配置表单的标识：

最后下载这个流程图，将之放在 Spring Boot 项目的 classpath:/processes/ 目录下，这样当项目启动的时候，这个流程图会被自动部署。

五.测试

接下来，启动 Spring Boot 项目，启动之后，流程和表单都会被自动部署好，执行如下代码启动一个流程实例：

@Test
void contextLoads() {runtimeService.startProcessInstanceByKey("askforleave");
}

流程启动成功之后，进入到提交请假申请环节，该环节有一个表单需要填写，可以先通过如下代码来查看需要填写的表单内容：

@Test
void test01() {Task task = taskService.createTaskQuery().singleResult();FormInfo formInfo = taskService.getTaskFormModel(task.getId());SimpleFormModel formModel = (SimpleFormModel) formInfo.getFormModel();System.out.println("formInfo.getId() = " + formInfo.getId());System.out.println("formInfo.getName() = " + formInfo.getName());System.out.println("formInfo.getKey() = " + formInfo.getKey());List<FormField> fields = formModel.getFields();for (FormField field : fields) {System.out.println("field.getId() = " + field.getId());System.out.println("field.getName() = " + field.getName());System.out.println("field.getValue() = " + field.getValue());System.out.println("field.getType() = " + field.getType());System.out.println("===============");}
}

打印出来的内容如下：

formInfo.getId() = a5b1306a-5ab0-11ed-b35b-acde48001122
formInfo.getName() = 经理审批表单
formInfo.getKey() = application_form.form
field.getId() = days
field.getName() = 请假天数
field.getValue() = null
field.getType() = text
===============
field.getId() = reason
field.getName() = 请假原因
field.getValue() = null
field.getType() = text
===============
field.getId() = startTime
field.getName() = 开始时间
field.getValue() = null
field.getType() = date
===============
field.getId() = endTime
field.getName() = 结束时间
field.getValue() = null
field.getType() = date

打印出来的 value 都是 null，这是因为还没有填写表单。接下来先来完成提交请假申请这一任务，代码如下：

@Test
void test02() {Task task = taskService.createTaskQuery().singleResult();Map<String, Object> vars = new HashMap<>();vars.put("days", 10);vars.put("reason", "玩一下");vars.put("startTime", "2022-10-10");vars.put("endTime", "2022-11-10");taskService.complete(task.getId(),vars);
}

完成之后，此时任务进入到组长审批这一环节，现在再去执行 test01 方法，此时查询的就是组长审批这个任务的表单信息，打印出来日志如下：

formInfo.getId() = a5b1306a-5ab0-11ed-b35b-acde48001122
formInfo.getName() = 经理审批表单
formInfo.getKey() = application_form.form
field.getId() = days
field.getName() = 请假天数
field.getValue() = 10
field.getType() = text
===============
field.getId() = reason
field.getName() = 请假原因
field.getValue() = 玩一下
field.getType() = text
===============
field.getId() = startTime
field.getName() = 开始时间
field.getValue() = 2022-10-10
field.getType() = date
===============
field.getId() = endTime
field.getName() = 结束时间
field.getValue() = 2022-11-10
field.getType() = date

此时都有对应的 value 了。