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

Posted 2022-12-04 _江南一点雨

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了请假要组长和经理同时审批该怎么办？来看看工作流中的会签功能相关的知识，希望对你有一定的参考价值。

文章目录

今天松哥和小伙伴们介绍一下 Spring Security 中另外一个好玩的会签功能。

会签的意思就是，在一个流程中的某一个 Task 上，这个 Task 需要多个用户审批，当多个用户全部审批通过，或者多个用户中的某几个用户审批通过，就算通过。这就是我们说的 Flowable 中的会签功能！

例如我们之前的请假流程，假设这个请假流程需要组长和经理都审批了，才算审批通过，那么我们就需要设置这个 Task 是会签节点。

以我们之前的请假流程为例，我和大家演示一下我们这次要实现的效果。

首先员工提交请假申请，可以提交给多个审批人：

提交成功之后，员工的历史请假列表中，可以看到刚刚提交的请假申请，但是选择的三个审批人都是灰色的，表示三个人都还没有审批。

接下来，以 javaboy 的身份登录到系统中，就可以看到刚刚用户提交的请假申请，然后进行审批。

审批完成后，以 zhangsan 的身份登录到系统中，就可以看到 javaboy 已经完成审批了，等三个人都完成审批之后，这个请假流程的状态也就会变成已通过，要是三个人中有一个人点击了拒绝，那么这个请假流程的状态就会变为已拒绝。

好啦，这就是我们本文要实现的一个功能。本文也是基于之前的文章完成，如果小伙伴们还没看过松哥之前发的关于 Flowable 流程引擎的文章，可以在公众号江南一点雨上先翻一下。

1. 会签流程图

首先我们来画一下这个请假流程图，这个流程图基本上还是和之前的一样，如下图：

这跟我们之前的流程图有两个不一样的地方：

首先就是最最核心的的这个批准或者拒绝的节点，这个节点下面多个三个竖线，这三个竖线的意思就是多个用户审批时是并发执行的，相互之间没有先后顺序，还有一种是三个横线，三个横线的意思是多个用户顺序执行。当然，这里不是说流程图上多三个竖线就行了，还需要稍微配置一下，如下：

这里配置的属性主要有五个：

多实例类型：这个选项主要有两个，分别是 Parallel 和 Sequential，表示并发执行还是顺序执行，选择是 Parallel 就是多个用户并发执行，相互之间没有先后顺序，选择 Sequential 则是顺序执行，多个用户之间有先后顺序。
集合（多实例）：这个地方我配置了一个 $userTasks，这个表示当流程执行到这个节点的时候，我会传进来一个变量，这个变量的名字是 userTasks，这个变量中包含了所有要审批这个 Task 的用户名。
元素变量（多实例）：由于上面的是一个集合，这里配置的则是集合中每一个元素的变量名，这就类似于 Java 里增强 for 循环的变量名。
完成条件（多实例）：这里我配置的值是 $nrOfCompletedInstances== nrOfInstances，涉及到两个变量，nrOfCompletedInstances 这个表示已经完成审批的实例个数，nrOfInstances 则表示总共的实例个数，也就是当完成审批的实例个数等于总的实例个数的时候，这个节点就算执行完了，换句话说，也就是 zhangsan 将请假申请提交给 javaboy 和 lisi，必须这两个人都审批了，这个节点才算执行完。另外这里还有一个内置的变量可用就是 nrOfActiveInstances 表示未完成审批的实例个数，只不过在本案例中没有用到这个内置变量。
分配用户：这个是说这个 Task 的执行人，当然就是我们前面配置的 userTask，也就是从集合中拿出来的每一个元素的变量名。

去掉了审批通过之后的 UserTask。

在之前的请假流程图中，当请假审批通过之后，发送了请假通过通知之后，还会进入到一个 UserTask 流程中，这里为了方便，我把这个流程删掉了。

好啦，这就是新流程图和以前旧流程图之间的一个区别，现在我们来看下这个流程图对应的 XML 文件：

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:flowable="http://flowable.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.flowable.org/processdef" exporter="Flowable Open Source Modeler" exporterVersion="6.7.2">
  <process id="holidayRequest" name="holidayRequest" isExecutable="true">
    <startEvent id="startEvent1" flowable:formFieldValidation="true"></startEvent>
    <userTask id="sid-1A1AA050-1900-4CAD-A277-18BD97BD61FB" flowable:assignee="$userTask" flowable:formFieldValidation="true">
      <extensionElements>
        <modeler:initiator-can-complete xmlns:modeler="http://flowable.org/modeler"><![CDATA[false]]></modeler:initiator-can-complete>
      </extensionElements>
      <multiInstanceLoopCharacteristics isSequential="false" flowable:collection="$userTasks" flowable:elementVariable="userTask">
        <extensionElements></extensionElements>
        <completionCondition>$nrOfCompletedInstances == nrOfInstances</completionCondition>
      </multiInstanceLoopCharacteristics>
    </userTask>
    <sequenceFlow id="sid-2597F958-175E-4F9F-9BEA-6E89D6C5B0A4" sourceRef="startEvent1" targetRef="sid-1A1AA050-1900-4CAD-A277-18BD97BD61FB"></sequenceFlow>
    <exclusiveGateway id="sid-A04AF65B-D8B2-4F30-BFD5-7F2C9FCEFA51"></exclusiveGateway>
    <sequenceFlow id="sid-7CD68B1D-C2CE-4A1A-ABA7-216D0F80BDD8" sourceRef="sid-1A1AA050-1900-4CAD-A277-18BD97BD61FB" targetRef="sid-A04AF65B-D8B2-4F30-BFD5-7F2C9FCEFA51"></sequenceFlow>
    <serviceTask id="sid-4412386C-15E9-40C6-AB6B-66919A8D1302" flowable:class="org.javaboy.flowable03.flowable.Approve"></serviceTask>
    <serviceTask id="sid-903B79F3-2020-419E-AD42-215C2E26C784" flowable:class="org.javaboy.flowable03.flowable.Reject"></serviceTask>
    <endEvent id="sid-FE27FA28-2B2F-4572-A2D6-BFE83EBA9370"></endEvent>
    <sequenceFlow id="sid-474E5177-9B1A-4757-877F-5A0DA72B0A59" sourceRef="sid-903B79F3-2020-419E-AD42-215C2E26C784" targetRef="sid-FE27FA28-2B2F-4572-A2D6-BFE83EBA9370"></sequenceFlow>
    <sequenceFlow id="sid-85E7B515-734C-4E46-9889-D74FC5A04891" sourceRef="sid-A04AF65B-D8B2-4F30-BFD5-7F2C9FCEFA51" targetRef="sid-903B79F3-2020-419E-AD42-215C2E26C784">
      <conditionExpression xsi:type="tFormalExpression"><![CDATA[$!approved]]></conditionExpression>
    </sequenceFlow>
    <sequenceFlow id="sid-EEC3F695-D61D-40BC-BA68-BCDD4DA40299" sourceRef="sid-A04AF65B-D8B2-4F30-BFD5-7F2C9FCEFA51" targetRef="sid-4412386C-15E9-40C6-AB6B-66919A8D1302">
      <conditionExpression xsi:type="tFormalExpression"><![CDATA[$approved]]></conditionExpression>
    </sequenceFlow>
    <endEvent id="sid-92DA7300-EFD1-437B-96D5-EAADAFABC507"></endEvent>
    <sequenceFlow id="sid-E882A39F-9E88-4BB8-B7CE-F975B6ADC862" sourceRef="sid-4412386C-15E9-40C6-AB6B-66919A8D1302" targetRef="sid-92DA7300-EFD1-437B-96D5-EAADAFABC507"></sequenceFlow>
  </process>
</definitions>

这个流程图也没有啥特别值得说的地方，基本上前面该说的都说了，小伙伴们可以自行结合流程图对比看下这个 XML 文件。

2. 请假处理

2.1 前端提交请假流程

接下来我们看下前端如何提交请假申请：

先来看页面：

对应的 html 如下：

<h1>提交请假申请</h1>
<table>
    <tr>
        <td>请输入请假天数：</td>
        <td>
            <el-input type="text" v-model="afl.days"/>
        </td>
    </tr>
    <tr>
        <td>请输入请假理由：</td>
        <td>
            <el-input type="text" v-model="afl.reason"/>
        </td>
    </tr>
    <tr>
        <td>审批人：</td>
        <td>
            <el-select v-model="afl.approveUsers" style="width: 226px" placeholder="请选择审批人" multiple>
                <el-option
                        v-for="item in users"
                        :key="item.id"
                        :label="item.username"
                        :value="item.username"/>
            </el-select>
        </td>
    </tr>
</table>
<el-button type="primary" @click="submit">提交请假申请</el-button>

跟之前不同的是，这里的下拉框是多选的，当用户提交请假申请的时候，可以选择多个审批人，多个审批人的值将保存在 afl.approveUsers 变量中。

再来看提交请假方法：

submit() 
    let _this = this;
    axios.post('/ask_for_leave', this.afl)
        .then(function (response) 
            if (response.data.status == 200) 
                //提交成功
                _this.$message.success(response.data.msg);
                _this.search();
             else 
                //提交失败
                _this.$message.error(response.data.msg);
            
        )
        .catch(function (error) 
            console.log(error);
        );
,

这个方法其实没啥好说的，唯一需要和小伙伴们强调的是请求的参数，来看下：

我们来看下我这里提交的三个请求参数：

approveUsers：这是审批当前流程的三个用户，当这三个用户都审批通过后，请假流程就通过了。
days：这是请假的天数。
reason：这是请假理由。

2.2 服务端处理请假请求

我们再来看看服务端如何处理这个请假请求，我这里跟大家展示最核心的流程处理代码，文末可以下载完整代码。

@Transactional
public RespBean askForLeave(AskForLeaveVO askForLeaveVO) 
    Map<String, Object> variables = new HashMap<>();
    askForLeaveVO.setName(SecurityContextHolder.getContext().getAuthentication().getName());
    variables.put("name", askForLeaveVO.getName());
    variables.put("days", askForLeaveVO.getDays());
    variables.put("reason", askForLeaveVO.getReason());
    variables.put("userTasks", askForLeaveVO.getApproveUsers());
    try 
        runtimeService.startProcessInstanceByKey("holidayRequest", askForLeaveVO.getName(), variables);
        return RespBean.ok("已提交请假申请");
     catch (Exception e) 
        e.printStackTrace();
    
    return RespBean.error("提交申请失败");

可以看到，从前端一共传递过来三个参数，但是执行这个流程需要四个参数，其中一个 name 表示当前登录的用户名，也就是这个请假是谁发起的。另外三个参数就是前端传来的参数。

2.3 服务端返回待审批数据

接下来我们来看看服务端如何返回待审批数据，也就是下面这张图要展示的数据：

/**
 * 待审批列表
 *
 * @return
 */
public RespBean leaveList() 
    String identity = SecurityContextHolder.getContext().getAuthentication().getName();
    //找到所有分配给你的任务
    List<Task> tasks = taskService.createTaskQuery().taskAssignee(identity).list();
    //重新组装返回的数据，为每个流程增加任务 id，方便后续执行批准或者拒绝操作
    List<Map<String, Object>> list = new ArrayList<>();
    for (int i = 0; i < tasks.size(); i++) 
        Task task = tasks.get(i);
        Map<String, Object> variables = taskService.getVariables(task.getId());
        variables.put("id", task.getId());
        list.add(variables);
    
    return RespBean.ok("加载成功", list);

这个整体上分了两步：

首先查询出来当前用户所有待审批的 Task。
查询出来这些 Task 上的 variables，这是一个 Map 集合，然后我们再手动加上 id 这个参数。

最后将组装好的 list 弄成一个 JSON 返回即可。

2.4 服务端批准 OR 拒绝

我们再来看看服务端批准或者拒绝请假流程的代码：

public RespBean askForLeaveHandler(ApproveRejectVO approveRejectVO) 
    try 
        Task task = taskService.createTaskQuery().taskId(approveRejectVO.getTaskId()).singleResult();
        boolean approved = approveRejectVO.getApprove();
        Map<String, Object> variables = new HashMap<String, Object>();
        variables.put("approved", approved);
        variables.put("approveUser#" + task.getAssignee(), SecurityContextHolder.getContext().getAuthentication().getName());
        taskService.complete(task.getId(), variables);
        return RespBean.ok("操作成功");
     catch (Exception e) 
        e.printStackTrace();
    
    return RespBean.error("操作失败");

批准或者拒绝，最主要的参数就是 approved，true 表示批准，false 表示拒绝。

另一方面，由于现在是会签，我们需要知道目前谁已经审批了，谁还没审批，所以这里额外多加了一个参数 approveUser#XXX，表示审批这个节点的用户名（也就是当前登录用户）。

注意这个参数的 key 我没有固定，主要是因为这个节点会有多个人审批，如果固定的话，后面审批的人会覆盖掉前面的人，所以这个节点的 key 设置成动态的了，approveUser# 后面加上处理这个节点的用户名。

2.5 服务端返回流程数据

最后还有服务端展示流程数据。就是当用户提交流程之后，想要查看自己的流程处理到哪一步了，也就是下图中的数据：

这张图中的数据其实包含了两部分，一部分是已经执行完的流程，还有一部分是正在执行中的流程，所以在查询中，我们也得分为两步来完成，如下：

public RespBean searchResult() 
    String name = SecurityContextHolder.getContext().getAuthentication().getName();
    List<HistoryInfo> infos = new ArrayList<>();
    //未完成流程
    List<HistoricProcessInstance> unFinishedHistoricProcessInstances = historyService.createHistoricProcessInstanceQuery().processInstanceBusinessKey(name).unfinished().orderByProcessInstanceStartTime().desc().list();
    for (HistoricProcessInstance unFinishedHistoricProcessInstance : unFinishedHistoricProcessInstances) 
        HistoryInfo historyInfo = new HistoryInfo();
        Date startTime = unFinishedHistoricProcessInstance.getStartTime();
        Date endTime = unFinishedHistoricProcessInstance.getEndTime();
        List<HistoricVariableInstance> historicVariableInstances = historyService.createHistoricVariableInstanceQuery()
                .p以上是关于请假要组长和经理同时审批该怎么办？来看看工作流中的会签功能的主要内容，如果未能解决你的问题，请参考以下文章 
 请假要组长和经理同时审批该怎么办？来看看工作流中的会签功能
 职责连模式
 如何通过Flow制作简单的工作流 - 请假审批3
 工作流
 小看--职责链模式
 Activit工作流引擎核心数据表存储解剖