一篇关于流程表单初体验

有小伙伴在星球上催了好几次了，今天松哥就来和大家聊一聊流程中的表单。,整体上来说，我们可以将表单分为三种不同的类型：,动态表单：这种表单定义方式我们可以配置表单中每一个字段的可读性、可写性、是否必填等信息，不过不能定义完整的表单页面。,外置表单：外置表单我们只需要定义一下表单的 key，至于这个 key 对应的表单是什么样子，则由开发者自己去维护。,内置表单：这是内置的表单定义以及渲染引擎，松哥在之前的一个不用写代码的案例，来看看Flowable到底给我们提供了哪些功能？一文中所使用的表单，就是这种。,另外小伙伴们需要注意，Flowable 中有很多不同类型的节点，但是只有开始节点和任务节点是支持表单定义的，其他节点均不支持表单定义。,今天我们就先来看看动态表单的玩法。,假设我有如下一个请假流程：,,在第一个任务节点中，需要填写请假的基本信息，那么我们选中该节点，然后点击动态表单属性，如下图：,,然后就可以开启动态表单属性的配置了：,,我这里一共配置了四个属性，这些属性的含义应该都好理解，我就不一一赘述了。,接下来我们来下载这个流程图。,流程的 XML 文件下载下来之后，我们可以在看到在 UserTask 节点中多了 flowable:formProperty 标签，现在，如果我想将 UserTask 节点中的动态表单属性拷贝到启动节点中，直接拷贝即可，如下：,可以看到，在 startEvent​ 和第一个 userTask​ 中都有 flowable:formProperty 标签。,接下来，按照我们之前所讲的，我们来部署一下这个流程。部署完成之后，我们可以通过如下方式来查询流程中的动态表单信息：,小伙伴们可以看到，这个查询是通过流程定义查询的，所以这里查询到的信息，其实也是和流程实例无关的。只是单纯的查看一下启动节点上有哪些动态表单需要输入，以及这些动态表单的类型。最终输出日志如下：,,动态表单，其实跟普通的变量有点像，启动的时候我们可以通过表单服务类来启动，代码如下：,小伙伴们看到，我们这里通过 formService.submitStartFormData 方法来启动流程实例，启动的时候，传入了 vars 变量。,流程实例启动成功之后，我们在 ACT_RU_VARIABLE 表中就可以看到这些动态表单的信息。,,从这里可以看到我们刚刚存入的数据。,现在我们的流程走到了 提交请假申请​ 这一步了，我们在绘制流程图的时候，提交请假申请​ 这个 UserTask 中也是有动态表单的，前面启动流程时传递的动态表单信息，现在已经传到 提交请假申请 这一步了，我们可以通过如下方式来进行查询：,小伙伴们看到，调用 formService.getTaskFormData 方法传入 TaskId 即可进行查询。这个时候查询出来的内容就有值了：,,可能有的小伙伴会说，这跟用变量有啥区别呀，用变量不也是这样吗？,变量是散的，而表单是整的。,在上面的代码中，一个方法就可以提取出来所有的表单信息了，然后就遍历就行了。,另外还需要注意，如果 提交请假申请​ 中的动态表单和启动节点的动态表单不一致的话，提交请假申请 节点中有哪些动态表单，就能拿到哪些数据，其他的数据就不能通过表单拿到。,以上面的案例来说，startEvent 中有 startTime、endTime、reason 以及 days 四个动态表单属性，如果 提交请假申请 中只有 reason 和 days 两个动态表单属性的话，那么就只能获取这两个动态表单属性，其他的动态表单属性则可以通过变量去获取。,对于 UserTask 上的表单，我们首先可以通过如下方式来提交表单数据：,这个方法只是保存动态表单变量，并不会完成当前 Task。,如果想在提交表单变量的同时顺便完成当前 UserTask，方式如下：,该方法在提交表单变量的同时，还会顺便 complete 当前 UserTask。,好啦，这就是关于动态表单松哥和大家介绍的内容啦～,动态表单用法简单，很多小伙伴想不明白为什么要用表单，用变量不行吗？技术上来说，变量当然可以，但是变量是一个一个的，是零散的，而表单是整的，整存整取的。