Flowable流程设计器的使用

一、克隆流程设计器项目：

项目地址：https://github.com/CoderWang1999/Flowable-Process-Designer.git

二、修改数据源信息

三、启动项目，访问http://127.0.0.1:1999/flowable-modeler-demo/#/processes

四、新建流程图

注意：这个key最好不要有中文，后期流程部署、启动、跳转都可能会用到它，所有不要定义的过于随意

五、根据你的业务需求画流程图：

下面讲解流程图中各个属性的含义和用处（只介绍最常用的几种）：

1、节点分类：开始节点、用户任务节点、结束节点

2、节点名称：可直接在“名称”处填写，也可以双击节点输入。

3、分配用户（只针对用户任务节点）：

为节点分配审批人（由于Flowable自带的的组织结构和我们的组织架构可能存在差异，所以我们一般用固定值）

4、任务监听器（只针对用户任务节点）：

4.1、任务监听器的分类：

create：当任务被创建时会执行的监听器。

assignment：当任务被签收时会执行的监听器。

complete：当任务完成时执行的监听器。

delete：当任务被删除时执行的监听器。

4.2、常用的任务监听器以及使用场景：

create：上面讲的给用户节点设置审批人只适用于办理人是固定的某一个人或多个候选人；如果一个用户节点办理人是不固定的话，我们可以用create任务监听器来实现；具体实现后面再介绍。

complete：当遇到一个用户任务办完需要抄送或者触发其他事物的时候，我们可以使用complete任务监听器；不同类型的任务监听器使用方法都一样，后期我们以create监听器为例重点介绍。

5、多实例：

FLowable支持一个节点多个实例；通俗讲就是你在流程图里只画了一个用户节点，但是通过多实例配置可以使流程运行时为这一个节点创建多个实例；这个类似于循环，而循环的次数取决于你设置的基数。

多实例还支持串行Sequential和并行parallel；通俗来讲所谓的串行就是顺序执行，并行就是不按顺序执行，但它俩的相同点都是必须要所有的实例都完成这个节点才算结束。

6、流程线：

1、流条件配置：

审批流当中最常见的就是通过和驳回，这时候就需要为通过和驳回的流程线设置流转条件。

Flowable流条件是以占位符的方式存在的，后期讲代码我们会详细介绍。

2、跳过表达式：

和流条件配置方式一样；流程启动后，当传入的流程变量值符合要求时会自动跳过。

7、常用的网关：

1、排他网关：通过它的流只能有一条。

注意：排他网关支持默认出口；流程启动后，当其他流程线都返回false时走默认流。

2、并行网关：只有所有要经过它的任务流都完成时才会进行下一步。

六、保存：

保存后流程图相关数据会保存在act_de_model表内，并且每次更新并保存后，流程定义的版本会+1

七、下载：

八、bpmn20.xml文件相关介绍：

1、做标：

做标相关数据我们一般不用关心；这些数据都是前端框架自动生成的。

  <bpmndi:BPMNDiagram id="BPMNDiagram_baoxiao"><bpmndi:BPMNPlane bpmnElement="baoxiao" id="BPMNPlane_baoxiao"><bpmndi:BPMNShape bpmnElement="startEvent1" id="BPMNShape_startEvent1"><omgdc:Bounds height="30.0" width="30.0" x="75.0" y="215.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="sid-B4027636-3A87-419F-8C01-4180B20313D5" id="BPMNShape_sid-B4027636-3A87-419F-8C01-4180B20313D5"><omgdc:Bounds height="40.0" width="40.0" x="195.0" y="210.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="sid-4F1689EF-BD84-42C8-B9BA-B6985E6E79AC" id="BPMNShape_sid-4F1689EF-BD84-42C8-B9BA-B6985E6E79AC"><omgdc:Bounds height="40.0" width="40.0" x="285.0" y="105.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="sid-96D229EF-3DE1-416C-AEF6-724782C41A27" id="BPMNShape_sid-96D229EF-3DE1-416C-AEF6-724782C41A27"><omgdc:Bounds height="40.0" width="40.0" x="285.0" y="330.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="sid-B11876E3-0747-4048-AF25-5479053BBA76" id="BPMNShape_sid-B11876E3-0747-4048-AF25-5479053BBA76"><omgdc:Bounds height="80.0" width="100.0" x="370.0" y="30.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="sid-AD9FED10-E0A8-41EB-81A0-5CB912AD12BF" id="BPMNShape_sid-AD9FED10-E0A8-41EB-81A0-5CB912AD12BF"><omgdc:Bounds height="80.0" width="100.0" x="370.0" y="190.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="sid-1A674671-4521-4150-9842-547254DA577F" id="BPMNShape_sid-1A674671-4521-4150-9842-547254DA577F"><omgdc:Bounds height="80.0" width="100.0" x="370.0" y="390.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="sid-651237FD-821F-4F4F-82C7-9560DB0D6206" id="BPMNShape_sid-651237FD-821F-4F4F-82C7-9560DB0D6206"><omgdc:Bounds height="40.0" width="40.0" x="510.0" y="105.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="sid-E4AB42DD-94B2-4C28-83F5-1C2A53D614CC" id="BPMNShape_sid-E4AB42DD-94B2-4C28-83F5-1C2A53D614CC"><omgdc:Bounds height="40.0" width="40.0" x="510.0" y="330.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="sid-21F47710-F5C3-472A-92BC-4A314A677BCA" id="BPMNShape_sid-21F47710-F5C3-472A-92BC-4A314A677BCA"><omgdc:Bounds height="28.0" width="28.0" x="735.0" y="216.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNEdge bpmnElement="sid-C94AAC6F-A1EA-4DC4-B155-ECA5BF0CC71C" id="BPMNEdge_sid-C94AAC6F-A1EA-4DC4-B155-ECA5BF0CC71C"><omgdi:waypoint x="543.3180826369545" y="131.63088235294117"></omgdi:waypoint><omgdi:waypoint x="736.3576311499917" y="223.9582234699538"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="sid-1C5D1528-09EE-443A-8F8F-B9E7D3DE9C4C" id="BPMNEdge_sid-1C5D1528-09EE-443A-8F8F-B9E7D3DE9C4C"><omgdi:waypoint x="316.68352653271506" y="358.2655927835051"></omgdi:waypoint><omgdi:waypoint x="370.0" y="395.28384279475983"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="sid-7DB07042-FE7F-4100-A4B8-DCA02C17B4EA" id="BPMNEdge_sid-7DB07042-FE7F-4100-A4B8-DCA02C17B4EA"><omgdi:waypoint x="318.9369117647059" y="118.97058823529412"></omgdi:waypoint><omgdi:waypoint x="370.0" y="94.21157205240173"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="sid-5841A455-F150-4A5E-9160-47477E7CDB00" id="BPMNEdge_sid-5841A455-F150-4A5E-9160-47477E7CDB00"><omgdi:waypoint x="315.22031914893614" y="340.24468085106383"></omgdi:waypoint><omgdi:waypoint x="381.99170124481327" y="269.95000000000005"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="sid-75F32CA5-FF1A-4B7A-9B3B-C03DDC001155" id="BPMNEdge_sid-75F32CA5-FF1A-4B7A-9B3B-C03DDC001155"><omgdi:waypoint x="469.95" y="393.6363636363636"></omgdi:waypoint><omgdi:waypoint x="518.421052631579" y="358.40000000000003"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="sid-1B17740B-E875-4B0B-98EE-EA90E90C60F6" id="BPMNEdge_sid-1B17740B-E875-4B0B-98EE-EA90E90C60F6"><omgdi:waypoint x="305.5" y="125.5"></omgdi:waypoint><omgdi:waypoint x="316.0" y="125.5"></omgdi:waypoint><omgdi:waypoint x="380.1913875598086" y="190.0"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="sid-92D1F94C-65C7-496D-B5FD-01B32F5104DC" id="BPMNEdge_sid-92D1F94C-65C7-496D-B5FD-01B32F5104DC"><omgdi:waypoint x="223.62142857142857" y="241.3279271775345"></omgdi:waypoint><omgdi:waypoint x="296.5" y="338.4935744883389"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="sid-E5D5A277-109D-4039-9FED-F96873D087E2" id="BPMNEdge_sid-E5D5A277-109D-4039-9FED-F96873D087E2"><omgdi:waypoint x="224.7076923076923" y="219.73076923076923"></omgdi:waypoint><omgdi:waypoint x="296.2692307692307" y="136.24230769230766"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="sid-5DC3D443-D637-4E02-B0AC-59BAA3B1E8AC" id="BPMNEdge_sid-5DC3D443-D637-4E02-B0AC-59BAA3B1E8AC"><omgdi:waypoint x="461.85238095238094" y="190.0"></omgdi:waypoint><omgdi:waypoint x="519.7674418604652" y="134.74302325581394"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="sid-31CD19B6-1015-45A3-B126-A8B0D24685C1" id="BPMNEdge_sid-31CD19B6-1015-45A3-B126-A8B0D24685C1"><omgdi:waypoint x="469.95000000000005" y="95.08800904977377"></omgdi:waypoint><omgdi:waypoint x="516.5066225165563" y="118.47891566265058"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="sid-6DE853F7-6E9E-4C5A-BF58-A6FEE380DBAB" id="BPMNEdge_sid-6DE853F7-6E9E-4C5A-BF58-A6FEE380DBAB"><omgdi:waypoint x="456.6346473029046" y="269.95000000000005"></omgdi:waypoint><omgdi:waypoint x="520.4545454545455" y="339.5434876676764"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="sid-E47ED599-89B0-4509-B471-855D657327B0" id="BPMNEdge_sid-E47ED599-89B0-4509-B471-855D657327B0"><omgdi:waypoint x="104.94985958140524" y="230.05956143745834"></omgdi:waypoint><omgdi:waypoint x="195.41999999999686" y="230.42"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="sid-D0F49E18-C032-422E-AA9B-E9B48B98E434" id="BPMNEdge_sid-D0F49E18-C032-422E-AA9B-E9B48B98E434"><omgdi:waypoint x="543.358628318584" y="343.39085545722713"></omgdi:waypoint><omgdi:waypoint x="736.7384221810878" y="236.73795546730696"></omgdi:waypoint></bpmndi:BPMNEdge></bpmndi:BPMNPlane></bpmndi:BPMNDiagram>

2、流程：

 <process id="baoxiao" name="报销案例" isExecutable="true"><startEvent id="startEvent1" name="申请报销" flowable:formFieldValidation="true"></startEvent><exclusiveGateway id="sid-B4027636-3A87-419F-8C01-4180B20313D5" name="排他网关" default="sid-E5D5A277-109D-4039-9FED-F96873D087E2"></exclusiveGateway><sequenceFlow id="sid-E47ED599-89B0-4509-B471-855D657327B0" sourceRef="startEvent1" targetRef="sid-B4027636-3A87-419F-8C01-4180B20313D5"></sequenceFlow><parallelGateway id="sid-4F1689EF-BD84-42C8-B9BA-B6985E6E79AC" name="并行网关"></parallelGateway><parallelGateway id="sid-96D229EF-3DE1-416C-AEF6-724782C41A27" name="并行网关"></parallelGateway><userTask id="sid-B11876E3-0747-4048-AF25-5479053BBA76" name="部门经理审批" flowable:assignee="deptManager" flowable:formFieldValidation="true"><extensionElements><modeler:initiator-can-complete xmlns:modeler="http://flowable.org/modeler"><![CDATA[false]]></modeler:initiator-can-complete></extensionElements></userTask><sequenceFlow id="sid-7DB07042-FE7F-4100-A4B8-DCA02C17B4EA" sourceRef="sid-4F1689EF-BD84-42C8-B9BA-B6985E6E79AC" targetRef="sid-B11876E3-0747-4048-AF25-5479053BBA76"></sequenceFlow><userTask id="sid-AD9FED10-E0A8-41EB-81A0-5CB912AD12BF" name="财务经理审批" flowable:assignee="financialManager" flowable:formFieldValidation="true"><extensionElements><modeler:initiator-can-complete xmlns:modeler="http://flowable.org/modeler"><![CDATA[false]]></modeler:initiator-can-complete></extensionElements></userTask><sequenceFlow id="sid-1B17740B-E875-4B0B-98EE-EA90E90C60F6" sourceRef="sid-4F1689EF-BD84-42C8-B9BA-B6985E6E79AC" targetRef="sid-AD9FED10-E0A8-41EB-81A0-5CB912AD12BF"></sequenceFlow><userTask id="sid-1A674671-4521-4150-9842-547254DA577F" name="总经理审批" flowable:assignee="boss" flowable:formFieldValidation="true"><extensionElements><modeler:initiator-can-complete xmlns:modeler="http://flowable.org/modeler"><![CDATA[false]]></modeler:initiator-can-complete></extensionElements></userTask><sequenceFlow id="sid-1C5D1528-09EE-443A-8F8F-B9E7D3DE9C4C" sourceRef="sid-96D229EF-3DE1-416C-AEF6-724782C41A27" targetRef="sid-1A674671-4521-4150-9842-547254DA577F"></sequenceFlow><sequenceFlow id="sid-5841A455-F150-4A5E-9160-47477E7CDB00" sourceRef="sid-96D229EF-3DE1-416C-AEF6-724782C41A27" targetRef="sid-AD9FED10-E0A8-41EB-81A0-5CB912AD12BF"></sequenceFlow><parallelGateway id="sid-651237FD-821F-4F4F-82C7-9560DB0D6206" name="并行网关"></parallelGateway><sequenceFlow id="sid-5DC3D443-D637-4E02-B0AC-59BAA3B1E8AC" sourceRef="sid-AD9FED10-E0A8-41EB-81A0-5CB912AD12BF" targetRef="sid-651237FD-821F-4F4F-82C7-9560DB0D6206"></sequenceFlow><parallelGateway id="sid-E4AB42DD-94B2-4C28-83F5-1C2A53D614CC" name="并行网关"></parallelGateway><sequenceFlow id="sid-75F32CA5-FF1A-4B7A-9B3B-C03DDC001155" sourceRef="sid-1A674671-4521-4150-9842-547254DA577F" targetRef="sid-E4AB42DD-94B2-4C28-83F5-1C2A53D614CC"></sequenceFlow><endEvent id="sid-21F47710-F5C3-472A-92BC-4A314A677BCA" name="办结"></endEvent><sequenceFlow id="sid-C94AAC6F-A1EA-4DC4-B155-ECA5BF0CC71C" sourceRef="sid-651237FD-821F-4F4F-82C7-9560DB0D6206" targetRef="sid-21F47710-F5C3-472A-92BC-4A314A677BCA"></sequenceFlow><sequenceFlow id="sid-D0F49E18-C032-422E-AA9B-E9B48B98E434" sourceRef="sid-E4AB42DD-94B2-4C28-83F5-1C2A53D614CC" targetRef="sid-21F47710-F5C3-472A-92BC-4A314A677BCA"></sequenceFlow><sequenceFlow id="sid-6DE853F7-6E9E-4C5A-BF58-A6FEE380DBAB" sourceRef="sid-AD9FED10-E0A8-41EB-81A0-5CB912AD12BF" targetRef="sid-E4AB42DD-94B2-4C28-83F5-1C2A53D614CC"></sequenceFlow><sequenceFlow id="sid-31CD19B6-1015-45A3-B126-A8B0D24685C1" sourceRef="sid-B11876E3-0747-4048-AF25-5479053BBA76" targetRef="sid-651237FD-821F-4F4F-82C7-9560DB0D6206"></sequenceFlow><sequenceFlow id="sid-92D1F94C-65C7-496D-B5FD-01B32F5104DC" name="一千元以上" sourceRef="sid-B4027636-3A87-419F-8C01-4180B20313D5" targetRef="sid-96D229EF-3DE1-416C-AEF6-724782C41A27"><conditionExpression xsi:type="tFormalExpression"><![CDATA[${money>1000}]]></conditionExpression></sequenceFlow><sequenceFlow id="sid-E5D5A277-109D-4039-9FED-F96873D087E2" name="一千元以内" sourceRef="sid-B4027636-3A87-419F-8C01-4180B20313D5" targetRef="sid-4F1689EF-BD84-42C8-B9BA-B6985E6E79AC"></sequenceFlow></process>

2.1 、流程ID和名称：

<process id="baoxiao" name="报销案例" isExecutable="true">

注意：这里的id对应我们前边输入的key

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-qK3aS8gA-1634200747834)(C:\Users\Coder Wang\AppData\Roaming\Typora\typora-user-images\1634197518718.png)]

2.2、开始节点：

<startEvent id="startEvent1" name="申请报销" flowable:formFieldValidation="true"></startEvent>

2.3、流程线：

(1)配置了流条件的：

    <sequenceFlow id="sid-92D1F94C-65C7-496D-B5FD-01B32F5104DC" name="一千元以上" sourceRef="sid-B4027636-3A87-419F-8C01-4180B20313D5" targetRef="sid-96D229EF-3DE1-416C-AEF6-724782C41A27"><conditionExpression xsi:type="tFormalExpression"><![CDATA[${money>1000}]]></conditionExpression></sequenceFlow>

(2)没有配置流条件的：

 <sequenceFlow id="sid-C94AAC6F-A1EA-4DC4-B155-ECA5BF0CC71C" sourceRef="sid-651237FD-821F-4F4F-82C7-9560DB0D6206" targetRef="sid-21F47710-F5C3-472A-92BC-4A314A677BCA"></sequenceFlow>

2.4、排他网关：

 <exclusiveGateway id="sid-B4027636-3A87-419F-8C01-4180B20313D5" name="排他网关" default="sid-E5D5A277-109D-4039-9FED-F96873D087E2"></exclusiveGateway>

注意：default的值就是排他网关的默认出口！

2.5、并行网关：

<parallelGateway id="sid-4F1689EF-BD84-42C8-B9BA-B6985E6E79AC" name="并行网关"></parallelGateway>

2.6、用户任务：

(1)审批人是固定值（一个）：

flowable:assignee后边的值就是配置的固定审批人。

<userTask id="sid-B11876E3-0747-4048-AF25-5479053BBA76" name="部门经理审批" flowable:assignee="deptManager">
</userTask>

(2)设置了候选用户：

flowable:candidateUsers后边的值就是配置的候选审批人。

<userTask id="sid-A6A82E6D-3AA2-4653-AB9E-499D781E659B" name="总经理或商务经理审批" flowable:candidateUsers="1347360657535160322,1347360652384555010">
</userTask

(3)配置了任务监听器：

flowable:taskListener就是任务监听器；event代表监听器类型（create、complete、assignment、delete）；class代表任务监听器对应的全限定类名。

<userTask id="sid-DBA4F33D-801B-421A-BDF0-723ADFD126DD" name="销售经理审批"> <extensionElements>
<flowable:taskListener event="create" class="org.springblade.modules.business.listener.DeptManagerListener"></flowable:taskListener></extensionElements>
</userTask>

(4)配置了多实例：

multiInstanceLoopCharacteristics就代表多实例；isSequential="false"表示并行，isSequential="true"表示串行；loopCardinality的值为基数（类似于循环次数，前面讲过了。）

<userTask id="sid-2688D7B6-08A6-49B1-8028-63E2F664E183" name="多实例用户节点"><multiInstanceLoopCharacteristics isSequential="false"><loopCardinality>3</loopCardinality></multiInstanceLoopCharacteristics>
</userTask>