Camunda 如何调用外部子流程

欢迎大家来到IT世界,在知识的湖畔探索吧!

Camunda子流程有两种实现方式：嵌套子流程（Embedded Subprocess）和外部子流程（Call Activity）。以下介绍Camunda外部子流程（Call Activity）的实现方式，通过示例介绍主流程如何发起子流程，主子流程间变量如何传递。

一、什么是调用子流程

BPMN 2.0区分了嵌入式子流程（Embedded Subprocess）和调用活动（Call Activity）。从概念上看，当流程执行到达活动时，两者都将调用子流程。

不同之处在于，调用活动引用流程定义外部的流程，而子流程嵌入在原始流程定义中。调用活动的主要用例是拥有可重用的流程定义，可以从多个其他流程定义调用该定义。子流程的流程定义是在运行时解析的。如果需要，也可以独立调用子流程。

当流程执行到达调用活动时，将创建一个新的流程实例，该实例用于执行子流程，可能会像在常规流程中那样创建并行子执行。主流程实例将一直等待，直到子流程完全结束，然后继续原始流程。

二、流程模拟验证

模拟公文处理流程：拟稿人起草公文——》部门会签——》领导签发，其中部门会签通过外部子流程实现。

第一步、设计流程图

设计公文审批主流程：

欢迎大家来到IT世界,在知识的湖畔探索吧!

设计公文会签子流程：

第二步、主子流程关联配置

点击子流程节点，配置要调用哪个子流程。在调用活动中，calledElement属性包含流程定义键，作为对子流程的引用。这意味着总是调用子流程的最新流程定义版本。要调用子流程的另一个版本，可以在调用活动中定义属性calledElementBinding、calledElementVersion和calledElementVersionTag。这些属性是可选的。

第三步、主子流程变量传递配置

您可以将流程变量传递给子流程，反之亦然。数据在启动时复制到子进程中，在结束时复制回主进程中。

如下图所示，定义主流程变量a1和a2 要分别传递给子流程b1和b2。

如下图所示，定义子流程变量c1要传递给主流程c2。

如下图所示，在子流程中通过script脚本模拟生成变量c1，实际业务应用中可以把表单字段传递过来。

主流程BPMN流程模型文件：

<?xml version="1.0" encoding="UTF-8"?> <bpmn:definitions xmlns:bpmn="http://www.omg.org/spec/BPMN//MODEL" xmlns:bpmndi="http://www.omg.org/spec/BPMN//DI" xmlns:dc="http://www.omg.org/spec/DD//DC" xmlns:camunda="http://camunda.org/schema/1.0/bpmn" xmlns:di="http://www.omg.org/spec/DD//DI" xmlns:modeler="http://camunda.org/schema/modeler/1.0" id="Definitions_031zkxq" 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_0z2exxd" name="公文审批主流程" isExecutable="true"> <bpmn:startEvent id="StartEvent_1"> <bpmn:outgoing>Flow_0zm80xb</bpmn:outgoing> </bpmn:startEvent> <bpmn:sequenceFlow id="Flow_0zm80xb" sourceRef="StartEvent_1" targetRef="Activity_1wpmqyf" /> <bpmn:sequenceFlow id="Flow_0go3jlb" sourceRef="Activity_1wpmqyf" targetRef="Activity_1yu8lt7" /> <bpmn:sequenceFlow id="Flow_0tp93xf" sourceRef="Activity_1yu8lt7" targetRef="Activity_10emus5" /> <bpmn:endEvent id="Event_1pnyryf"> <bpmn:incoming>Flow_036jxrf</bpmn:incoming> </bpmn:endEvent> <bpmn:sequenceFlow id="Flow_036jxrf" sourceRef="Activity_10emus5" targetRef="Event_1pnyryf" /> <bpmn:callActivity id="Activity_1yu8lt7" name="部门会签" calledElement="Process_0fqoao8"> <bpmn:extensionElements> <camunda:in source="a1" target="b1" /> <camunda:in source="a2" target="b2" /> <camunda:out source="c1" target="c2" /> </bpmn:extensionElements> <bpmn:incoming>Flow_0go3jlb</bpmn:incoming> <bpmn:outgoing>Flow_0tp93xf</bpmn:outgoing> </bpmn:callActivity> <bpmn:userTask id="Activity_10emus5" name="领导签发" camunda:assignee="demo"> <bpmn:incoming>Flow_0tp93xf</bpmn:incoming> <bpmn:outgoing>Flow_036jxrf</bpmn:outgoing> </bpmn:userTask> <bpmn:userTask id="Activity_1wpmqyf" name="公文起草"> <bpmn:incoming>Flow_0zm80xb</bpmn:incoming> <bpmn:outgoing>Flow_0go3jlb</bpmn:outgoing> </bpmn:userTask> </bpmn:process> <bpmndi:BPMNDiagram id="BPMNDiagram_1"> <bpmndi:BPMNPlane id="BPMNPlane_1" bpmnElement="Process_0z2exxd"> <bpmndi:BPMNEdge id="Flow_036jxrf_di" bpmnElement="Flow_036jxrf"> <di:waypoint x="690" y="117" /> <di:waypoint x="752" y="117" /> </bpmndi:BPMNEdge> <bpmndi:BPMNEdge id="Flow_0tp93xf_di" bpmnElement="Flow_0tp93xf"> <di:waypoint x="530" y="117" /> <di:waypoint x="590" y="117" /> </bpmndi:BPMNEdge> <bpmndi:BPMNEdge id="Flow_0go3jlb_di" bpmnElement="Flow_0go3jlb"> <di:waypoint x="370" y="117" /> <di:waypoint x="430" y="117" /> </bpmndi:BPMNEdge> <bpmndi:BPMNEdge id="Flow_0zm80xb_di" bpmnElement="Flow_0zm80xb"> <di:waypoint x="215" y="117" /> <di:waypoint x="270" 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_1pnyryf_di" bpmnElement="Event_1pnyryf"> <dc:Bounds x="752" y="99" width="36" height="36" /> </bpmndi:BPMNShape> <bpmndi:BPMNShape id="Activity_1k4sxw6_di" bpmnElement="Activity_1yu8lt7"> <dc:Bounds x="430" y="77" width="100" height="80" /> </bpmndi:BPMNShape> <bpmndi:BPMNShape id="Activity_125gzjf_di" bpmnElement="Activity_10emus5"> <dc:Bounds x="590" y="77" width="100" height="80" /> </bpmndi:BPMNShape> <bpmndi:BPMNShape id="Activity_0ztm7d3_di" bpmnElement="Activity_1wpmqyf"> <dc:Bounds x="270" y="77" width="100" height="80" /> </bpmndi:BPMNShape> </bpmndi:BPMNPlane> </bpmndi:BPMNDiagram> </bpmn:definitions>

欢迎大家来到IT世界,在知识的湖畔探索吧!

子流程BPMN流程模型文件：

欢迎大家来到IT世界,在知识的湖畔探索吧!<?xml version="1.0" encoding="UTF-8"?> <bpmn:definitions xmlns:bpmn="http://www.omg.org/spec/BPMN//MODEL" xmlns:bpmndi="http://www.omg.org/spec/BPMN//DI" xmlns:dc="http://www.omg.org/spec/DD//DC" xmlns:camunda="http://camunda.org/schema/1.0/bpmn" xmlns:di="http://www.omg.org/spec/DD//DI" xmlns:modeler="http://camunda.org/schema/modeler/1.0" id="Definitions_10qlgev" 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_0fqoao8" name="公文会签子流程" isExecutable="true"> <bpmn:startEvent id="StartEvent_1"> <bpmn:outgoing>Flow_01enblh</bpmn:outgoing> </bpmn:startEvent> <bpmn:sequenceFlow id="Flow_01enblh" sourceRef="StartEvent_1" targetRef="Activity_1nkq50z" /> <bpmn:endEvent id="Event_13q9iri"> <bpmn:incoming>Flow_0ebh7be</bpmn:incoming> </bpmn:endEvent> <bpmn:sequenceFlow id="Flow_0ebh7be" sourceRef="Activity_1nkq50z" targetRef="Event_13q9iri"> <bpmn:extensionElements> <camunda:executionListener event="take"> <camunda:script scriptFormat="groovy">def c1 = "hello"; execution.setVariable("c1", c1);</camunda:script> </camunda:executionListener> </bpmn:extensionElements> </bpmn:sequenceFlow> <bpmn:userTask id="Activity_1nkq50z" name="会签" camunda:assignee="user1"> <bpmn:incoming>Flow_01enblh</bpmn:incoming> <bpmn:outgoing>Flow_0ebh7be</bpmn:outgoing> </bpmn:userTask> </bpmn:process> <bpmndi:BPMNDiagram id="BPMNDiagram_1"> <bpmndi:BPMNPlane id="BPMNPlane_1" bpmnElement="Process_0fqoao8"> <bpmndi:BPMNEdge id="Flow_0ebh7be_di" bpmnElement="Flow_0ebh7be"> <di:waypoint x="370" y="117" /> <di:waypoint x="432" y="117" /> </bpmndi:BPMNEdge> <bpmndi:BPMNEdge id="Flow_01enblh_di" bpmnElement="Flow_01enblh"> <di:waypoint x="215" y="117" /> <di:waypoint x="270" 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_13q9iri_di" bpmnElement="Event_13q9iri"> <dc:Bounds x="432" y="99" width="36" height="36" /> </bpmndi:BPMNShape> <bpmndi:BPMNShape id="Activity_1m91lyj_di" bpmnElement="Activity_1nkq50z"> <dc:Bounds x="270" y="77" width="100" height="80" /> </bpmndi:BPMNShape> </bpmndi:BPMNPlane> </bpmndi:BPMNDiagram> </bpmn:definitions>

第四步、发起主流程

通过demo用户登录camunda平台
http://localhost:8080/camunda/app/tasklist/default/#/login，发起主流程：

填写流程变量a1和a2：

启动流程后，此时流程在主流程第一个活动节点，点击提交流程，将自动激活子流程。

查看此时主流程的流程变量：

第五步、启动子流程

主流程点击提交，流程执行到达子流程调用活动，将创建一个新的流程实例，该实例用于执行子流程，此时主流程实例将一直等待，直到子流程完全结束，然后继续原始流程。通过user1登录查看子流程待办，并提交待办任务。

查看子流程的流程变量，发现主流程变量a1和a2分别传递了过来，自动映射为b1和b2。

user1登录系统，查看子流程待办任务，提交任务，子流程结束，流程自动回到主流程。

此时查看主流程变量，发现子流程变量c1成功返回给了主流程，自动映射为名称c2 。

通过以上演示了camunda如何配置子流程、如何发起子流程、主子流程间如何传递变量，详细请查看官方文档。