HelloWorld
语雀文档地址:
https://www.yuque.com/paomian-ldog4/by12xp/uqg6yhhgzeinaxge#snmoq
相关文档
https://tkjohn.github.io/flowable-userguide/ 文档手册
https://github.com/flowable/flowable-engine/releases/tag/flowable-6.8.0 flowable-ui下载地址
https://dlcdn.apache.org/tomcat/tomcat-8/v8.5.100/bin/apache-tomcat-8.5.100.zip tomcat下载
百度网盘提取-都给你准备好了哟 (:
链接:https://pan.baidu.com/s/1vlOT1J7B_kC595B2oPtG6w?pwd=ix4c
提取码:ix4c
项目初始化
项目环境
springboot:2.7.18
jdk:1.8+
flowable: 6.8.0
pom.xml
<parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.7.18</version><relativePath/></parent><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><!-- Flowable 工作流相关 --><dependency><groupId>org.flowable</groupId><artifactId>flowable-spring-boot-starter-process</artifactId><version>6.8.0</version></dependency><dependency><groupId>org.flowable</groupId><artifactId>flowable-spring-boot-starter-actuator</artifactId><version>6.8.0</version></dependency><!-- MySQL 相关 --><dependency><groupId>com.mysql</groupId><artifactId>mysql-connector-j</artifactId><scope>runtime</scope></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency></dependencies>
替换自己项目的parent和dependencies
application.yaml
spring:application:name: crazyFur-springboot-flowabledatasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://127.0.0.1:3306/flowable?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=trueusername: rootpassword: root
# 工作流 Flowable 配置
flowable:database-schema-update: true # 设置为 false,可通过 https://github.com/flowable/flowable-sql 初始化async-executor-activate: true
server:port: 8888
记得把数据库改成自己的数据库配置哟
主动启动类
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
public class CrazyfurSpringbootFlowableApplication {public static void main(String[] args) {SpringApplication.run(CrazyfurSpringbootFlowableApplication.class, args);}}
启动项目,检查flowable相关的表是否已经生成,没有生成需要自行百度检查哟-看到有表了就表示🆗了
安装flowable-ui
解压flowable-6.8.0.zip
将flowable-ui.war放到tomcat的webapps目录下
启动tomcat
访问http://localhost:8080/flowable-ui/idm/#/login登录
flowable.common.app.idm-admin.user=admin 默认用户名admin
flowable.common.app.idm-admin.password=test 默认密码test
登录成功后的页面
helloworld
使用flowable-ui画流程图
①
②
③
helloworld/helloworld.bpmn20.xml 的文件内容
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:flowable="http://flowable.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.flowable.org/processdef" exporter="Flowable Open Source Modeler" exporterVersion="6.8.0">
<process id="helloword" name="第一个流程" isExecutable="true">
<documentation>这是一个请假流程</documentation>
<startEvent id="startEvent1" name="开始" flowable:formFieldValidation="true"/>
<userTask id="sid-5885E87F-B683-4262-B6BF-A414577BE8E9" name="hr审批" flowable:assignee="hr" 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-59A392ED-D43D-48AF-9520-39064641E1C2" sourceRef="startEvent1" targetRef="sid-5885E87F-B683-4262-B6BF-A414577BE8E9"/>
<endEvent id="sid-FE879718-BCB3-4067-9B4B-5FC44AA78F51" name="结束"/>
<sequenceFlow id="sid-64E09C57-97AD-4D23-AE2E-AE0B7C5E838A" sourceRef="sid-5885E87F-B683-4262-B6BF-A414577BE8E9" targetRef="sid-FE879718-BCB3-4067-9B4B-5FC44AA78F51"/>
</process>
<bpmndi:BPMNDiagram id="BPMNDiagram_helloword">
<bpmndi:BPMNPlane bpmnElement="helloword" id="BPMNPlane_helloword">
<bpmndi:BPMNShape bpmnElement="startEvent1" id="BPMNShape_startEvent1">
<omgdc:Bounds height="30.0" width="30.0" x="100.0" y="163.0"/>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="sid-5885E87F-B683-4262-B6BF-A414577BE8E9" id="BPMNShape_sid-5885E87F-B683-4262-B6BF-A414577BE8E9">
<omgdc:Bounds height="80.0" width="100.0" x="175.0" y="138.0"/>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="sid-FE879718-BCB3-4067-9B4B-5FC44AA78F51" id="BPMNShape_sid-FE879718-BCB3-4067-9B4B-5FC44AA78F51">
<omgdc:Bounds height="28.0" width="28.0" x="320.0" y="164.0"/>
</bpmndi:BPMNShape>
<bpmndi:BPMNEdge bpmnElement="sid-59A392ED-D43D-48AF-9520-39064641E1C2" id="BPMNEdge_sid-59A392ED-D43D-48AF-9520-39064641E1C2" flowable:sourceDockerX="15.0" flowable:sourceDockerY="15.0" flowable:targetDockerX="50.0" flowable:targetDockerY="40.0">
<omgdi:waypoint x="129.9499984899576" y="178.0"/>
<omgdi:waypoint x="174.9999999999917" y="178.0"/>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sid-64E09C57-97AD-4D23-AE2E-AE0B7C5E838A" id="BPMNEdge_sid-64E09C57-97AD-4D23-AE2E-AE0B7C5E838A" flowable:sourceDockerX="50.0" flowable:sourceDockerY="40.0" flowable:targetDockerX="14.0" flowable:targetDockerY="14.0">
<omgdi:waypoint x="274.95000000000005" y="178.0"/>
<omgdi:waypoint x="320.0" y="178.0"/>
</bpmndi:BPMNEdge>
</bpmndi:BPMNPlane>
</bpmndi:BPMNDiagram>
</definitions>
在项目中的情况
新建单元测试 com.crazyfur.bpm.test.HelloWorldTest
package com.crazyfur.bpm.test;import org.flowable.engine.RepositoryService;
import org.flowable.engine.RuntimeService;
import org.flowable.engine.TaskService;
import org.flowable.engine.repository.Deployment;
import org.flowable.engine.runtime.ProcessInstance;
import org.flowable.task.api.Task;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;import javax.annotation.Resource;
import java.util.List;/*** description: ~~** @author crazyfur* @version 1.0.0* @date 2024/05/28 12:25:11*/
@SpringBootTest
public class HelloWorldTest {@Resourceprivate RepositoryService repositoryService;@Resourceprivate RuntimeService runtimeService;@Resourceprivate TaskService taskService;/*** ① 部署流程*/@Testpublic void deploy(){Deployment deploy = repositoryService.createDeployment().addClasspathResource("helloworld/helloworld.bpmn20.xml").name("请假-01").deploy();System.out.println("deploy.getId() = " + deploy.getId());}/*** ② 启动流程*/@Testpublic void startProcess(){// 根据流程id启动流程===》注意使用自己的流程idProcessInstance instance = runtimeService.startProcessInstanceById("helloword:1:0a03cbb1-1caf-11ef-974d-4a5f08bacd87");System.out.println(instance.getId());}/*** ③ 审批流程任务*/@Testpublic void assigneeTask(){// 根据审批人查找要审批的任务List<Task> list = taskService.createTaskQuery().taskAssignee("hr").list();list.forEach(task -> {System.out.println(task.getId());// 审批任务taskService.complete(task.getId());});}}
运行
运行单元测试:① 部署流程
查看数据库:
运行单元测试:② 启动流程
查看数据库:
运行单元测试:③ 审批流程任务
查看数据库:hr的任务已经审批了
基础知识
什么是BPM
Business Process Management(BPM),即业务流程管理,是一套达成企业各种业务环节整合的全面管理模式。BPM涵盖了人员、设备、桌面应用系统、企业级 Backoffice 应用等内容的优化组合,从而实现跨应用、跨部门、跨合作伙伴与客户的企业运作。 BPM通常以Internet方式实现信息传递、数据同步、业务监控和企业业务流程的持续升级优化。显而易见,BPM不但涵盖了传统“工作流”的流程传递、流程监控的范畴,而且突破了传统“工作流”技术的瓶颈。BPM的推出,是工作流技术和企业管理理念的一次划时代飞跃。
什么是BPMN
首先BPMN规范是由标准组织BPMI发布的.BPMN 1.0规范发布于2004年5月。此规范展示了BPMI组织两年多的努力成果。BPMN的主要目标就是要提供被所有业务用户理解的一套标记语言,包括业务分析者、软件开发者以及业务管理者与监察者。BPMN还将支持生成可执行的BPEL4WS语言。所以,BPMN在业务流程设计与流程实现之间搭建了一条标准化的桥梁。
BPMN定义了业务流程图,其基于流程图技术,同时为创建业务流程操作的图形化模型进行了裁减。业务流程的模型就是图形化对象的网图,包括活动(也可以说工作)和定义操作顺序的流控制。
BPMN是BPM及workflow的建模语言标准之一。
工作流的开源框架
以下是一些常见的开源工作流框架,可用于实现工作流管理系统:
- Activiti:
- Activiti是一个轻量级的、开源的工作流引擎,基于Java语言。
- 它提供了可视化建模工具、灵活的流程定义、任务分配、用户任务管理、流程监控和报告等功能。
- Activiti支持与Java应用程序的集成,并提供REST API和Java API进行工作流操作。
- Camunda:
- Camunda是一个功能强大的、开源的工作流引擎,也是基于Java的。
- 它支持BPMN 2.0标准,提供了流程建模、任务分配、用户任务管理、流程实例管理、事件驱动、流程监控和报告等功能。
- Camunda具有良好的扩展性和可定制性,并提供REST API和Java API用于集成和操作工作流。
- jBPM:
- jBPM是一个基于Java的开源工作流引擎,由Red Hat维护。
- 它支持BPMN 2.0标准,提供了流程建模、任务分配、流程实例管理、决策管理、事件驱动、流程监控和报告等功能。
- jBPM具有良好的可扩展性和灵活性,并可以与Java应用程序集成。
- Flowable:
- Flowable是一个轻量级的、开源的工作流和业务流程管理引擎,基于Java语言。
- 它支持BPMN 2.0标准,提供了流程建模、任务分配、流程实例管理、事件驱动、流程监控和报告等功能。
- Flowable具有高度可定制性,并提供REST API和Java API用于集成和操作工作流。
这些开源工作流框架提供了丰富的功能和灵活性,可以用于构建各种类型的工作流管理系统。根据项目需求和技术栈的考虑,选择适合的工作流框架进行开发。
flowable-ui介绍
身份管理应用程序
流程审批是需要用户参与的,我们通过 身份管理应用程序
来创建2个测试用户
点击身份管理应用程序进去后,我们可以看到从三个角度来管理用户:用户、组、权限控制
创建用户
创建两个测试用户:xiaozhang、xiaoming
点击用户-创建用户
创建组
点击组-创建组
添加组成员
权限控制
给组添加权限
访问idm应用
访问modeler应用
建模器应用程序
在flowable-ui中建模器应用程序
是用来画流程图的,当然你也可以使用第三方流程图工具,我们学习就使用官方的,下面我们介绍如何使用。
点击 流程->创建流程 来填写信息
最终效果面板
流程部署及审批
画流程图
画一个简单的请假流程图,有直接领导审批和hr审批,点击流程-创建流程-填写信息 进入画图面板。
进入面板默认有一个空启动事件
增加一个直接领导审批节点,点击人头像图标添加
分配用户填写
添加一个hr审批节点
添加一个结束节点
校验保存
点击刚刚创建好的流程
点击下载按钮下载xml
xml
test/deploy_audit_test.bpmn20.xml
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:flowable="http://flowable.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.flowable.org/processdef" exporter="Flowable Open Source Modeler" exporterVersion="6.8.0">
<process id="deploy_audit_test" name="流程部署-审批-请假测试" isExecutable="true">
<startEvent id="startEvent1" flowable:formFieldValidation="true"/>
<userTask id="sid-A320E4AC-A182-4032-93E9-7361537BA75B" name="直接领导" flowable:assignee="manager" 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-A1F1D393-3B05-42BF-BEA7-E1646FEC8943" sourceRef="startEvent1" targetRef="sid-A320E4AC-A182-4032-93E9-7361537BA75B"/>
<userTask id="sid-105952D6-371E-4586-9622-69DBD8E812E9" name="hr审批" flowable:assignee="hr" 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-CB3B9345-24C8-46CF-B834-F3FEBB3CFBDD" sourceRef="sid-A320E4AC-A182-4032-93E9-7361537BA75B" targetRef="sid-105952D6-371E-4586-9622-69DBD8E812E9"/>
<endEvent id="sid-C46A7DBD-CE87-4814-B6CD-41CDB20BBB48"/>
<sequenceFlow id="sid-7B4A0AD0-9136-4145-B624-B6318BC11887" sourceRef="sid-105952D6-371E-4586-9622-69DBD8E812E9" targetRef="sid-C46A7DBD-CE87-4814-B6CD-41CDB20BBB48"/>
</process>
<bpmndi:BPMNDiagram id="BPMNDiagram_deploy_audit_test">
<bpmndi:BPMNPlane bpmnElement="deploy_audit_test" id="BPMNPlane_deploy_audit_test">
<bpmndi:BPMNShape bpmnElement="startEvent1" id="BPMNShape_startEvent1">
<omgdc:Bounds height="30.0" width="30.0" x="100.0" y="163.0"/>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="sid-A320E4AC-A182-4032-93E9-7361537BA75B" id="BPMNShape_sid-A320E4AC-A182-4032-93E9-7361537BA75B">
<omgdc:Bounds height="80.0" width="100.0" x="255.0" y="138.0"/>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="sid-105952D6-371E-4586-9622-69DBD8E812E9" id="BPMNShape_sid-105952D6-371E-4586-9622-69DBD8E812E9">
<omgdc:Bounds height="80.0" width="100.0" x="400.0" y="138.0"/>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="sid-C46A7DBD-CE87-4814-B6CD-41CDB20BBB48" id="BPMNShape_sid-C46A7DBD-CE87-4814-B6CD-41CDB20BBB48">
<omgdc:Bounds height="28.0" width="28.0" x="545.0" y="164.0"/>
</bpmndi:BPMNShape>
<bpmndi:BPMNEdge bpmnElement="sid-CB3B9345-24C8-46CF-B834-F3FEBB3CFBDD" id="BPMNEdge_sid-CB3B9345-24C8-46CF-B834-F3FEBB3CFBDD" flowable:sourceDockerX="50.0" flowable:sourceDockerY="40.0" flowable:targetDockerX="50.0" flowable:targetDockerY="40.0">
<omgdi:waypoint x="354.9499999999907" y="178.0"/>
<omgdi:waypoint x="399.9999999999807" y="178.0"/>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sid-7B4A0AD0-9136-4145-B624-B6318BC11887" id="BPMNEdge_sid-7B4A0AD0-9136-4145-B624-B6318BC11887" flowable:sourceDockerX="50.0" flowable:sourceDockerY="40.0" flowable:targetDockerX="14.0" flowable:targetDockerY="14.0">
<omgdi:waypoint x="499.95000000000005" y="178.0"/>
<omgdi:waypoint x="545.0" y="178.0"/>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sid-A1F1D393-3B05-42BF-BEA7-E1646FEC8943" id="BPMNEdge_sid-A1F1D393-3B05-42BF-BEA7-E1646FEC8943" flowable:sourceDockerX="15.0" flowable:sourceDockerY="15.0" flowable:targetDockerX="50.0" flowable:targetDockerY="40.0">
<omgdi:waypoint x="129.94999949366624" y="178.0"/>
<omgdi:waypoint x="254.99999999993574" y="178.0"/>
</bpmndi:BPMNEdge>
</bpmndi:BPMNPlane>
</bpmndi:BPMNDiagram>
</definitions>
部署流程
流程部署使用RepositoryService类
@Resourceprivate RepositoryService repositoryService;/*** ① 部署流程*/@Testpublic void deploy(){Deployment deploy = repositoryService.createDeployment().addClasspathResource("test/deploy_audit_test.bpmn20.xml").name("holiday-01").deploy();System.out.println("deploy.getId() = " + deploy.getId());}
启动成功后相关表信息:
act_ge_bytearray
表用于存储二进制数据,如流程定义、流程模板、流程图的字节流文件等。 act_re_deployment
表用于保存流程定义部署时需要持久化的信息,如部署的时间、部署人等。 act_re_procdef
表用于存储业务流程定义数据,该表与act_re_deployment
表是多对一的关系,即一个部署的bar
包里可能包含多个流程定义文件,每个流程定义文件在act_re_procdef
表中都有一条记录。每个流程定义的数据,都会对应act_ge_bytearray
表内的一个资源文件和 PNG 图片文件。act_ge_bytearray
表的NAME
字段与act_re_procdef
表的NAME
字段通过程序关联,在数据库表结构中没有体现。
启动流程
启动流程使用RuntimeService类
@Resourceprivate RuntimeService runtimeService;/*** ② 启动流程*/@Testpublic void startProcess(){// 启动流程有2种方式:// ① 调用startProcessInstanceById方法,传入表act_re_procdef的id字段ProcessInstance instance = runtimeService.startProcessInstanceById("deploy_audit_test:1:9bdc90f7-2231-11ef-b2af-4a5f08bacd87");// ② 调用startProcessInstanceByKey方法,传入表act_re_procdef的key字段//ProcessInstance instance = runtimeService.startProcessInstanceByKey("deploy_audit_test");System.out.println(instance.getId());}
启动成功后相关表信息:
act_ru_execution表用于存储流程执行的相关信息,例如执行实例的 ID、父执行实例的 ID、流程定义的 ID 等。该表的主要作用是跟踪流程的执行过程,包括流程的分支、合并、暂停、恢复等操作。
act_ru_task`表用于存储用户任务的相关信息,例如任务的 ID、执行实例的 ID、流程实例的 ID、任务的名称、任务的负责人等。该表的主要作用是管理流程中的用户任务,包括任务的分配、执行、完成等操作。 这两张表都是 Flowable 流程引擎的核心表,它们共同协作来实现流程的执行和管理。通过对这两张表的操作,可以实现对流程的监控、跟踪和管理,以及对用户任务的分配、执行和完成等操作。
流程任务审批
流程任务审批使用TaskService类
@Resourceprivate TaskService taskService;/*** ③ 审批流程任务*/@Testpublic void assigneeTask(){// 根据审批人查找要审批的任务// 审批manager任务List<Task> list = taskService.createTaskQuery().taskAssignee("manager").list();list.forEach(task -> {System.out.println(task.getId());// 审批任务taskService.complete(task.getId());});// 审批hr任务list = taskService.createTaskQuery().taskAssignee("hr").list();list.forEach(task -> {System.out.println(task.getId());// 审批任务taskService.complete(task.getId());});}
任务审批完以后表act_ru_execution,act_ru_task相关数据会被清除