详解SpringCloud集成Camunda7.19实现工作流审批(二)

本章将分享的是camunda流程设计器--Camunda Modeler的基本使用（对应camunda版本是7.19），包括bpmn流程图画法，各种控件使用以及一些日常业务场景的流程图的实现

参考资料：

Camunda BPMN 基础组件-CSDN博客

Camunda: ExecutionListener执行监听器和TaskListener任务监听器-CSDN博客

snail-camunda: Camunda二次封装以及相关功能使用介绍。中国式工作流解决方案。

文章目录

一、常用控件
- 1.事件（Event）
- 2.任务（Task）
- 3.网关（Gateway）
二、流程设计器使用
- 1.新建模型
- 2.命名流程图
- 3.拖拽控件画图
- 4.监听器配置
- 5.网关配置
- 6.子流程
- - 1.内部子流程
  - 2.外部子流程（活动调用）
三、实战演示

一、常用控件

1.事件（Event）

事件是BPMN2.0中一个非常重要的概念，是流程运行过程中发生的事情，而这些事情的发生会影响到流程的流转。对每个事件而言，一般会包含两个要素，分别是触发这个事件的原因，以及由此导致的结果。

以下是一些常用的事件类型

（空白）开始事件

如下图所示，开始事件是流程图里必须要有的元素，同时一个流程图只能有且仅有一个空白开始事件

在这里插入图片描述

结束事件

标志流程的一个实例或一个分支走向结束，在一个流程图里可以存在多个结束事件节点；结束事件不会影响其他并行路径的执行，只是结束它所在的特定路径。

在这里插入图片描述

终止事件

终止事件是 BPMN 2.0 引入的一种特殊类型的结束事件。它会导致整个流程（包括所有并行路径）立即终止。

在这里插入图片描述

流程立即终止：终止事件会导致整个流程立即终止，无论是否有其他并行路径正在执行。
单一实例：一个流程中只能有一个终止事件。如果有多个终止事件，流程引擎将不知道该执行哪个。
影响所有路径：终止事件会影响整个流程的所有并行路径，不仅仅是一个分支。
计时器事件

计时器事件可以用作启动事件、中间事件或边界事件。边界事件可以中断，也可以不中断。

下图里的是边界中断事件，表示的是10秒后还在该节点则判定超时，会中断流程走向下面的路线

在这里插入图片描述

错误事件

错误事件分为错误启动事件和错误边界事件
- 错误启动事件
  
  如下图，错误结束节点后会触发下面的事件子流程，由事件子流程中的错误启动事件进行处理
  
  只能用于触发事件子流程，而不能用于启动流程实例。错误启动事件始终处于中断状态

在这里插入图片描述

注意选择相同的错误定义，这样才能被捕获

在这里插入图片描述

错误边界事件

边界事件可以捕获中间错误，中断流程并重新控制流程走向，如下图所示，由于系统任务执行主动抛出了BpmnError异常，然后就被错误边界事件捕获处理了。

在这里插入图片描述

2.任务（Task）

任务表示流程中的工作单位，需要人工或系统执行特定的动作。

系统任务

即不需要人工处理，而是由系统自动处理的任务。通常调用外部服务或脚本。可以配置 Java 类、表达式或外部任务来实现任务逻辑。

由于项目中我用到系统任务的不多，这里只展示配置java类的方式。

如下图，type选择java class，然后配置java类的全路径

在这里插入图片描述

java类如下，实现JavaDelegate接口

execution对象里可以获取到流程实例的各种信息，也可以对流程实例进行操作，如下面的设置流程变量等

public class TestCalculateErrorDelegate implements JavaDelegate {@Overridepublic void execute(DelegateExecution execution) throws Exception {Integer numerator = 0;Integer denominator = 0;try {int result = numerator / denominator;execution.setVariable("result", result);} catch (Exception e) {execution.setVariable("calculateErrorCode", "4098");execution.setVariable("calculateErrorMsg", "除数不能为0");throw new BpmnError("4098", "除数不能为0");}}
}

用户任务

用户任务即需要人工参与者完成的任务。当流程执行到用户任务节点时，将会给这个节点分配的用户创建待办任务。

如下图所示，分配该用户任务节点给了admin

在这里插入图片描述

这里的assignee在真实业务场景中，一般会设置成流程变量，进行动态的赋值，如下图

${assignee}代表这里取值是取流程实例中的assignee变量，这样就可以结合具体业务动态地给这个地方赋值了

在这里插入图片描述

多实例用户任务

一个用户任务节点也可以是多个参与者，同时又分为并行和串行 2种类型

如下图，通过点击修改属性按钮，可以看到右上角有两个类型选项，第一个是并行，第二个串行

在这里插入图片描述

并行

并行又分为或签（一个人通过即通过）、比例签（通过人数达到总人数XX比例即通过）还有会签（需要全部人都通过才通过）

如下图是或签，配置与单实例任务有所不同

第一行是固定写法，同理的还有：
```
//比例签，需要满足0.3比例通过
${nrOfCompletedInstances/nrOfInstances > 0.3 }
//会签，需要全部通过
${nrOfCompletedInstances == nrOfInstances}
```

在这里插入图片描述

串行

串行即多个人依次审批，待办任务也是只有当到自己审批的时候才会创建。配置逻辑和并行的基本同理。

在这里插入图片描述

3.网关（Gateway）

在流程中，需要根据条件分叉或合并路线的时候，就需要用到网关。

排他网关

会依次判断所有的路径，然后走符合条件的第一条路径

如下图所示

在这里插入图片描述

并行网关

允许同时走多个分叉路径，都走完后合并后再走后面的节点

并行网关是没有条件限制的

如下图所示

在这里插入图片描述

包含网关

与并行网关类似，区别在于可以设置条件限制，满足条件的路径就会走

如下图所示的请假流程，当请假天数大于3天，既会走经理审批，同时也会走老板审批，两个都审批好后再汇集走下个节点

在这里插入图片描述

二、流程设计器使用

这里我们以camunda7.19为例，讲解流程设计器的基本使用

1.新建模型

如下图所示，新建的时候选择camunda 7版本，并且左下角再选择小版本号为7.19

在这里插入图片描述

2.命名流程图

创建新文件后，默认会有一个开始节点，然后我们需要先点击下空白处，然后在右边的窗口里输入流程的名字和流程的ID(流程定义key)

Name可以在后面作为流程名称(流程类型)来使用，而流程定义key(表里是PROC_DEF_KEY_ ) 则是该流程图的唯一标识

区别于流程定义id，即表里的PROC_INST_ID_，每次修改了图重新部署都会变，对应的是这个图的某个版本；流程定义key则图修改重新部署后不会变

在这里插入图片描述

3.拖拽控件画图

从左边的控件栏选择后拖拽到画板即可，这里常用的控件上面已经介绍过。

在这里插入图片描述

4.监听器配置

在流程中，我们经常要在节点前或节点后去做一些操作，这时候我们就可以使用监听器来实现。

执行监听器 ExecutionListener触发事件有：start、end、take；

其中节点有start、end两种事件，而连线则有take事件。

任务监听器TaskListener触发事件有：create, assignment, update, complete, delete or timeout。

执行监听器 ExecutionListener

如下图，就是在开始节点配置了执行监听器，start时触发

监听器类型是java类，即会执行下面的java方法

在这里插入图片描述

这里的java类实现ExecutionListener接口，如下所示

public class ProcessStartExecutionListener implements ExecutionListener {@Overridepublic void notify(DelegateExecution execution) throws Exception {//初始化状态为审批中execution.setVariable("approveState", 0);log.info("初始化状态为审批中---------------approveState=0");}}

监听器除了用java类，常用的还有脚本片段，如下图所示

在这里插入图片描述

注意：

脚本使用的是groovy语言，需要先在springboot项目中引入groovy依赖，否则会报错找不到引擎

<dependency><groupId>org.codehaus.groovy</groupId><artifactId>groovy-jsr223</artifactId><version>3.0.15</version><scope>runtime</scope>
</dependency>

任务监听器 TaskListener

如下图，任务节点create的时候，会执行监听器逻辑，同样可以配置java类或脚本片段

在这里插入图片描述

java类参考下面，实现TaskListener接口

public class ProcessReturnTaskListener implements TaskListener {@Overridepublic void notify(DelegateTask delegateTask) {// 设置变量variable1值为1delegateTask.setVariable("variable1", 1);log.info("流程退回变量初始化值为1成功, taskId:{}, variableName:{}", delegateTask.getId(), variableName);}}
}

监听器执行顺序

下图为例

在这里插入图片描述

执行顺序：1. 开始节点：start -》 end2. 连线：take3. 任务节点ExecutionListener： start4. 任务节点TaskListener：create -》 assignment -》 complete5. 任务节点ExecutionListener： end6. 连线：take7. 结束节点：start - 》 end