请假要组长和经理同时审批该怎么办？来看看工作流中的会签功能！

今天松哥和小伙伴们介绍一下 Spring Security 中另外一个好玩的会签功能。,会签的意思就是，在一个流程中的某一个 Task 上，这个 Task 需要多个用户审批，当多个用户全部审批通过，或者多个用户中的某几个用户审批通过，就算通过。这就是我们说的 Flowable 中的会签功能！,例如我们之前的请假流程，假设这个请假流程需要组长和经理都审批了，才算审批通过，那么我们就需要设置这个 Task 是会签节点。,以我们之前的请假流程为例，我和大家演示一下我们这次要实现的效果。,首先员工提交请假申请，可以提交给多个审批人：,,提交成功之后，员工的历史请假列表中，可以看到刚刚提交的请假申请，但是选择的三个审批人都是灰色的，表示三个人都还没有审批。,,接下来，以 javaboy 的身份登录到系统中，就可以看到刚刚用户提交的请假申请，然后进行审批。,,审批完成后，以 zhangsan 的身份登录到系统中，就可以看到 javaboy 已经完成审批了，等三个人都完成审批之后，这个请假流程的状态也就会变成已通过，要是三个人中有一个人点击了拒绝，那么这个请假流程的状态就会变为已拒绝。,,好啦，这就是我们本文要实现的一个功能。本文也是基于之前的文章完成，如果小伙伴们还没看过松哥之前发的关于 Flowable 流程引擎的文章，可以在公众号江南一点雨上先翻一下。,首先我们来画一下这个请假流程图，这个流程图基本上还是和之前的一样，如下图：,,这跟我们之前的流程图有两个不一样的地方：,首先就是最最核心的的这个批准或者拒绝的节点，这个节点下面多个三个竖线，这三个竖线的意思就是多个用户审批时是并发执行的，相互之间没有先后顺序，还有一种是三个横线，三个横线的意思是多个用户顺序执行。当然，这里不是说流程图上多三个竖线就行了，还需要稍微配置一下，如下：,,这里配置的属性主要有五个：,多实例类型：这个选项主要有两个，分别是 Parallel 和 Sequential，表示并发执行还是顺序执行，选择是 Parallel 就是多个用户并发执行，相互之间没有先后顺序，选择 Sequential 则是顺序执行，多个用户之间有先后顺序。,集合（多实例）：这个地方我配置了一个 ${userTasks}，这个表示当流程执行到这个节点的时候，我会传进来一个变量，这个变量的名字是 userTasks，这个变量中包含了所有要审批这个 Task 的用户名。,元素变量（多实例）：由于上面的是一个集合，这里配置的则是集合中每一个元素的变量名，这就类似于 Java 里增强 for 循环的变量名。,完成条件（多实例）：这里我配置的值是${nrOfCompletedInstances== nrOfInstances}，涉及到两个变量，nrOfCompletedInstances 这个表示已经完成审批的实例个数，nrOfInstances 则表示总共的实例个数，也就是当完成审批的实例个数等于总的实例个数的时候，这个节点就算执行完了，换句话说，也就是 zhangsan 将请假申请提交给 javaboy 和 lisi，必须这两个人都审批了，这个节点才算执行完。另外这里还有一个内置的变量可用就是 nrOfActiveInstances 表示未完成审批的实例个数，只不过在本案例中没有用到这个内置变量。,分配用户：这个是说这个 Task 的执行人，当然就是我们前面配置的 userTask，也就是从集合中拿出来的每一个元素的变量名。,去掉了审批通过之后的 UserTask。,在之前的请假流程图中，当请假审批通过之后，发送了请假通过通知之后，还会进入到一个 UserTask 流程中，这里为了方便，我把这个流程删掉了。,好啦，这就是新流程图和以前旧流程图之间的一个区别，现在我们来看下这个流程图对应的 XML 文件：,这个流程图也没有啥特别值得说的地方，基本上前面该说的都说了，小伙伴们可以自行结合流程图对比看下这个 XML 文件。,接下来我们看下前端如何提交请假申请：,先来看页面：,,对应的 HTML 如下：,跟之前不同的是，这里的下拉框是多选的，当用户提交请假申请的时候，可以选择多个审批人，多个审批人的值将保存在 afl.approveUsers 变量中。,再来看提交请假方法：,这个方法其实没啥好说的，唯一需要和小伙伴们强调的是请求的参数，来看下：,,我们来看下我这里提交的三个请求参数：,我们再来看看服务端如何处理这个请假请求，我这里跟大家展示最核心的流程处理代码，文末可以下载完整代码。,可以看到，从前端一共传递过来三个参数，但是执行这个流程需要四个参数，其中一个 name 表示当前登录的用户名，也就是这个请假是谁发起的。另外三个参数就是前端传来的参数。,接下来我们来看看服务端如何返回待审批数据，也就是下面这张图要展示的数据：,,这个整体上分了两步：,最后将组装好的 list 弄成一个 JSON 返回即可。,我们再来看看服务端批准或者拒绝请假流程的代码：,批准或者拒绝，最主要的参数就是 approved，true 表示批准，false 表示拒绝。,另一方面，由于现在是会签，我们需要知道目前谁已经审批了，谁还没审批，所以这里额外多加了一个参数 approveUser#XXX，表示审批这个节点的用户名（也就是当前登录用户）。,注意这个参数的 key 我没有固定，主要是因为这个节点会有多个人审批，如果固定的话，后面审批的人会覆盖掉前面的人，所以这个节点的 key 设置成动态的了，approveUser# 后面加上处理这个节点的用户名。,最后还有服务端展示流程数据。就是当用户提交流程之后，想要查看自己的流程处理到哪一步了，也就是下图中的数据：,,这张图中的数据其实包含了两部分，一部分是已经执行完的流程，还有一部分是正在执行中的流程，所以在查询中，我们也得分为两步来完成，如下：,这段代码比较长，但是比较像。整体上分为两部分，前面是查询未执行完的流程，后面是查询已经执行完毕的流程。对于未执行完的流程，我们在 historyInfo 中设置 status 为 3，表示待审批。当我们去读取一个流程的历史变量时，有一个以 approveUser 开头的变量，这个就表示这个流程已经被谁审批过了，我们将这个存到一个 List 集合中，将来返回给前端。流程的历史变量中还有一个 userTask，表示这个流程中这个节点待审批的用户都有谁，我们也将之保存到 List 集合中，将来返回给前端。,最后，我们再来看看前端如何渲染 2.5 小节返回的数据，如下：,大家看到，在审批人这个字段中，我们先去遍历显示这个流程所有的审批人（candidateUsers），在遍历的过程中，如果发现这个用户存在于 approveUsers 集合中，就表示这个用户已经审批，用绿色的 el-tag 显示，否则表示这个用户还没有审批，我们就用灰色的 el-tag 显示。,好啦，这就可以啦！一个简简单单的会签功能就完成了，测试流程我就不演示了，小伙伴们参考本文一开始的内容～,说完了会签，再来和大家说一说或签。,或签意思就是 A 的请假流程提交给 B、C、D，但是并不需要 B/C/D 同时审批通过，只需要 B/C/D 中的任意一个审批即可，这就是或签，注意，我这里的表述，只需要 B/C/D 任意一个审批即可，这个审批即可以是审批通过，也可以是审批拒绝，反正只要审批，这个 UserTask 就算完成了。,将会签改为或签其实非常容易，我们只需要修改一下 UserTask 的属性即可，和会签相比，我这里主要改了一个地方，都在下图中用箭头标出来了：,,完成条件（多实例）这里改为了 ${nrOfCompletedInstances >= 1}，表示只要有一个同意或者拒绝，这个 UserTask 就算过了。,改完之后，我们重新下载这个流程图的 XML 文件，并放到前文中的代码上去运行，就可以看到或签效果了，我就不演示了，小伙伴们可以自行尝试。,