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

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

参考资料：

Camunda BPMN 基础组件-CSDN博客

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

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

一、常用控件

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

5.网关配置

当我们的业务需要根据条件来判断不同走向的时候，就需要配置网关

如下图，实现的是流程变量t0等于1则走向admin审批，t0等于0时则直接走向结束

需要在网关后的两条连线配置条件，如下

也可以使用groovy脚本，如下

6.子流程

有的时候某个节点需要走一套流程来实现业务，例如某个多实例并行节点，在节点中有需要有自己的审批、退回等操作，这个时候就可以用到子流程来实现。子流程又分为 内部子流程和外部子流程（活动调用）

1.内部子流程

如下图所示

要注意的是，图里子流程的t1变量是针对整个(父)流程的，也就是如果其中一个子流程赋值了t1变量，其他子流程里的t1变量也会受影响，在真实业务中需要注意这点。

2.外部子流程（活动调用）

如下图所示

外部子流程即触发另一个流程图的流程，在数据表里也是会新增另一个流程定义key的数据（内部子流程不会，还是只是父流程定义key的数据）

下图右边栏里的called element配置的就是子流程图的定义key

父流程

子流程

采用外部子流程，则子流程里的变量是针对子流程实例的，所以不同子流程的变量不会互相影响

三、实战演示

关于流程图的示例，可以学习：

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