Camunda条件事件示例Demo（Conditional Events）
Camunda条件事件（Conditional Events）：定义了一个事件，该事件在给定条件被求值为true时被触发。它可以作为事件子流程的起始事件、中间事件和边界事件。开始和边界事件可以是中断的和不中断的。在Camunda中，条件事件是在流程变量的帮助下触发的。
Camunda条件事件包括：Conditional Start Event（启动条件事件）、Intermediate Conditional Catch Event（中间捕获条件事件）、Conditional Boundary Event（边界条件事件）、Conditional Start Event for Event Sub Process（子流程条件事件）。
本文重点介绍Conditional Start Event（启动条件事件）和T Conditional Boundary Event（边界条件事件），其它事件请参考camunda官方文档：https://docs.camunda.org/manual/7.15/reference/bpmn20/events/
一、设计流程图
测试场景：通过报销流程模拟条件事件流程自动发起，如果报销金额大于10000元，将自动发起报销审批子流程，在财务审批环节，如果报销金额金额发生变化，自动触发边界条件事件，退后给审批人。
报销主流程：
报销事件节点配置:
代理类代码如下：
package com.example.demo1;
import org.camunda.bpm.engine.RuntimeService;
import org.camunda.bpm.engine.delegate.DelegateExecution;
import org.camunda.bpm.engine.delegate.JavaDelegate;
import org.camunda.bpm.engine.runtime.ProcessInstance;
import java.util.List;
/**
* 触发条件事件启动子流程
*/
public class InstantiateProcessByConditionDelegate implements JavaDelegate {
public void execute(DelegateExecution execution) {
Integer money = (int)execution.getVariable("money");
RuntimeService runtimeService = execution.getProcessEngineServices().getRuntimeService();
List<ProcessInstance> instances = runtimeService
.createConditionEvaluation()
.setVariable("money", money)
.evaluateStartConditions();
}
}BPMN流程模型文件：
<?xml version="1.0" encoding="UTF-8"?>
<bpmn:definitions xmlns:bpmn="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:dc="http://www.omg.org/spec/DD/20100524/DC" xmlns:camunda="http://camunda.org/schema/1.0/bpmn" xmlns:di="http://www.omg.org/spec/DD/20100524/DI" xmlns:modeler="http://camunda.org/schema/modeler/1.0" id="Definitions_1ktuxzn" targetNamespace="http://bpmn.io/schema/bpmn" exporter="Camunda Modeler" exporterVersion="4.8.1" modeler:executionPlatform="Camunda Platform" modeler:executionPlatformVersion="7.15.0">
<bpmn:process id="Process_10z1wy2" name="报销主流程" isExecutable="true">
<bpmn:startEvent id="StartEvent_1">
<bpmn:outgoing>Flow_0f0u4dp</bpmn:outgoing>
</bpmn:startEvent>
<bpmn:sequenceFlow id="Flow_0f0u4dp" sourceRef="StartEvent_1" targetRef="Activity_02e4hhc" />
<bpmn:sequenceFlow id="Flow_0ckn1r7" sourceRef="Activity_02e4hhc" targetRef="Activity_1lkdefp" />
<bpmn:endEvent id="Event_1iic3x0">
<bpmn:incoming>Flow_04z0quc</bpmn:incoming>
</bpmn:endEvent>
<bpmn:sequenceFlow id="Flow_04z0quc" sourceRef="Activity_1lkdefp" targetRef="Event_1iic3x0" />
<bpmn:serviceTask id="Activity_02e4hhc" name="报销事件" camunda:class="com.example.demo1.InstantiateProcessByConditionDelegate">
<bpmn:incoming>Flow_0f0u4dp</bpmn:incoming>
<bpmn:outgoing>Flow_0ckn1r7</bpmn:outgoing>
</bpmn:serviceTask>
<bpmn:userTask id="Activity_1lkdefp" name="通知报销人" camunda:assignee="demo">
<bpmn:incoming>Flow_0ckn1r7</bpmn:incoming>
<bpmn:outgoing>Flow_04z0quc</bpmn:outgoing>
</bpmn:userTask>
</bpmn:process>
<bpmndi:BPMNDiagram id="BPMNDiagram_1">
<bpmndi:BPMNPlane id="BPMNPlane_1" bpmnElement="Process_10z1wy2">
<bpmndi:BPMNEdge id="Flow_0f0u4dp_di" bpmnElement="Flow_0f0u4dp">
<di:waypoint x="215" y="117" />
<di:waypoint x="270" y="117" />
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge id="Flow_0ckn1r7_di" bpmnElement="Flow_0ckn1r7">
<di:waypoint x="370" y="117" />
<di:waypoint x="430" y="117" />
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge id="Flow_04z0quc_di" bpmnElement="Flow_04z0quc">
<di:waypoint x="530" y="117" />
<di:waypoint x="592" y="117" />
</bpmndi:BPMNEdge>
<bpmndi:BPMNShape id="_BPMNShape_StartEvent_2" bpmnElement="StartEvent_1">
<dc:Bounds x="179" y="99" width="36" height="36" />
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Event_1iic3x0_di" bpmnElement="Event_1iic3x0">
<dc:Bounds x="592" y="99" width="36" height="36" />
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Activity_09rzn3u_di" bpmnElement="Activity_02e4hhc">
<dc:Bounds x="270" y="77" width="100" height="80" />
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Activity_1khoz85_di" bpmnElement="Activity_1lkdefp">
<dc:Bounds x="430" y="77" width="100" height="80" />
</bpmndi:BPMNShape>
</bpmndi:BPMNPlane>
</bpmndi:BPMNDiagram>
</bpmn:definitions>报销审批子流程：
Conditional Start Event（启动条件事件）节点配置：
${money>=10000} 表示报销金额大于等于1万元，流程自动启动。
Conditional Boundary Event（边界条件事件）节点配置：
${money>=20000}表示报销金额大于等于2万元，自动触发边界条件事件。
BPMN流程模型文件：
<?xml version="1.0" encoding="UTF-8"?>
<bpmn:definitions xmlns:bpmn="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:dc="http://www.omg.org/spec/DD/20100524/DC" xmlns:camunda="http://camunda.org/schema/1.0/bpmn" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:di="http://www.omg.org/spec/DD/20100524/DI" xmlns:modeler="http://camunda.org/schema/modeler/1.0" id="Definitions_1n4m8dk" targetNamespace="http://bpmn.io/schema/bpmn" exporter="Camunda Modeler" exporterVersion="4.8.1" modeler:executionPlatform="Camunda Platform" modeler:executionPlatformVersion="7.15.0">
<bpmn:process id="Process_0uf5zc5" name="条件事件流程" isExecutable="true">
<bpmn:sequenceFlow id="Flow_1f7cdrv" sourceRef="StartEvent_1" targetRef="Activity_15fulz2" />
<bpmn:sequenceFlow id="Flow_0p7c5lt" sourceRef="Activity_15fulz2" targetRef="Activity_0xikne3" />
<bpmn:endEvent id="Event_152527w">
<bpmn:incoming>Flow_1l03vwj</bpmn:incoming>
</bpmn:endEvent>
<bpmn:sequenceFlow id="Flow_1l03vwj" sourceRef="Activity_0xikne3" targetRef="Event_152527w" />
<bpmn:startEvent id="StartEvent_1">
<bpmn:outgoing>Flow_1f7cdrv</bpmn:outgoing>
<bpmn:conditionalEventDefinition id="ConditionalEventDefinition_0lzdf7y" camunda:variableName="money">
<bpmn:condition xsi:type="bpmn:tFormalExpression">${money>=10000}</bpmn:condition>
</bpmn:conditionalEventDefinition>
</bpmn:startEvent>
<bpmn:userTask id="Activity_15fulz2" name="经理审批" camunda:assignee="demo">
<bpmn:incoming>Flow_1f7cdrv</bpmn:incoming>
<bpmn:incoming>Flow_08he9tn</bpmn:incoming>
<bpmn:outgoing>Flow_0p7c5lt</bpmn:outgoing>
</bpmn:userTask>
<bpmn:userTask id="Activity_0xikne3" name="财务审批" camunda:assignee="demo">
<bpmn:incoming>Flow_0p7c5lt</bpmn:incoming>
<bpmn:outgoing>Flow_1l03vwj</bpmn:outgoing>
</bpmn:userTask>
<bpmn:boundaryEvent id="Event_0mnbhru" name="报销费修改事件" attachedToRef="Activity_0xikne3">
<bpmn:outgoing>Flow_08he9tn</bpmn:outgoing>
<bpmn:conditionalEventDefinition id="ConditionalEventDefinition_19eu007" camunda:variableName="money">
<bpmn:condition xsi:type="bpmn:tFormalExpression">${money>=20000}</bpmn:condition>
</bpmn:conditionalEventDefinition>
</bpmn:boundaryEvent>
<bpmn:sequenceFlow id="Flow_08he9tn" sourceRef="Event_0mnbhru" targetRef="Activity_15fulz2" />
</bpmn:process>
<bpmndi:BPMNDiagram id="BPMNDiagram_1">
<bpmndi:BPMNPlane id="BPMNPlane_1" bpmnElement="Process_0uf5zc5">
<bpmndi:BPMNEdge id="Flow_1f7cdrv_di" bpmnElement="Flow_1f7cdrv">
<di:waypoint x="215" y="117" />
<di:waypoint x="270" y="117" />
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge id="Flow_0p7c5lt_di" bpmnElement="Flow_0p7c5lt">
<di:waypoint x="370" y="117" />
<di:waypoint x="500" y="117" />
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge id="Flow_1l03vwj_di" bpmnElement="Flow_1l03vwj">
<di:waypoint x="600" y="117" />
<di:waypoint x="662" y="117" />
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge id="Flow_08he9tn_di" bpmnElement="Flow_08he9tn">
<di:waypoint x="550" y="175" />
<di:waypoint x="550" y="195" />
<di:waypoint x="320" y="195" />
<di:waypoint x="320" y="157" />
</bpmndi:BPMNEdge>
<bpmndi:BPMNShape id="Event_1d290h0_di" bpmnElement="StartEvent_1">
<dc:Bounds x="179" y="99" width="36" height="36" />
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Activity_1hwmimx_di" bpmnElement="Activity_15fulz2">
<dc:Bounds x="270" y="77" width="100" height="80" />
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Event_152527w_di" bpmnElement="Event_152527w">
<dc:Bounds x="662" y="99" width="36" height="36" />
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Activity_10pf0x5_di" bpmnElement="Activity_0xikne3">
<dc:Bounds x="500" y="77" width="100" height="80" />
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Event_0bjat0x_di" bpmnElement="Event_0mnbhru">
<dc:Bounds x="532" y="139" width="36" height="36" />
<bpmndi:BPMNLabel>
<dc:Bounds x="451" y="166" width="77" height="14" />
</bpmndi:BPMNLabel>
</bpmndi:BPMNShape>
</bpmndi:BPMNPlane>
</bpmndi:BPMNDiagram>
</bpmn:definitions>
二、部署流程并测试验证
流程部署后，查看数据库流程订阅事件表act_ru_event_subscr，发现Conditional Start Event（条件启动事件）已持久化到数据库中。
通过demo用户登录camunda平台http://localhost:8080/camunda/app/tasklist/default/#/login，启动主流程模拟测试。
由于报销金额满足条件，所以子流程被自动触发启动：
手动子流程提交到下一节点：
此时，流程流转到了Conditional Boundary Event（边界条件事件）节点上，查看数据库表记录：
为了模拟触发Conditional Boundary Event，在camunda后台修改money变量值：
由于流程变量money变成了20000，满足了Conditional Boundary Event触发条件，所以流程自动流程到对应节点。
三、条件事件使用说明
- Conditional Start Event（启动条件事件）
条件启动事件（Conditional Start Event）可以通过计算某些条件来启动流程。一个流程可以有一个或多个条件启动事件。
如果满足了多个条件，则会触发相应数量的进程。
部署带有条件启动事件的流程定义时，需要考虑以下事项:
在给定的流程定义中，条件启动事件的条件必须是唯一的，也就是说，流程定义不能有多个条件相同的条件启动事件。如果两个或多个条件启动事件包含相同的条件，则引擎会在部署流程定义时抛出异常。
流程版本控制:在部署流程定义的新版本时，将取消前一个版本的条件订阅。新版本中没有出现的条件事件也是如此。
当启动一个流程实例时，可以在RuntimeService上使用以下方法触发一个条件启动事件:
List<ProcessInstance> instances = runtimeService
.createConditionEvaluation()
.setVariable("temperature", 24)
.evaluateStartConditions();
// or
List<ProcessInstance> instances = runtimeService
.createConditionEvaluation()
.setVariables(variableMap)
.evaluateStartConditions();所提供的变量用于计算条件。它们还将作为变量传递给新创建的流程实例。条件启动事件的XML表示是带有conditionalEventDefinition子元素的普通启动事件声明。
可选:将variableName属性添加到conditionalEventDefinition允许指定一个变量名，在该变量名上，条件事件的条件应专门计算。
<startEvent id="conditionalStartEvent">
<conditionalEventDefinition camunda:variableName="temperature">
<condition type="tFormalExpression">${temperature > 20}</condition>
</conditionalEventDefinition>
</startEvent>
2、Conditional Boundary Event（边界条件事件）
条件边界事件（Conditional Boundary Event）就像一个观察者，如果满足一个特定的条件，它就会被触发。中断条件事件和非中断条件事件是有区别的。缺省情况下为中断事件。非中断事件导致原始活动未被中断，实例仍处于活动状态。相反，创建了一个额外的执行路径，采用事件的传出转换。一个不中断的条件事件可以被触发多次，只要它所附加的活动是活动的。
在非中断条件事件的XML表示中，cancelActivity属性被设置为false:
<boundaryEvent id="conditionalEvent" attachedToRef="taskWithCondition" cancelActivity="false">
<conditionalEventDefinition>
<condition type="tFormalExpression">${var1 == 1}</condition>
</conditionalEventDefinition>
</boundaryEvent>
参考：
https://docs.camunda.org/manual/7.15/reference/bpmn20/events/conditional-events/
专注云原生、低代码、流程引擎研发和应用。免费体验环境：http://www.yunchengxc.com
浙公网安备 33010602011771号