flowable 工作流从入门到精通

HelloWorld

logo.jpeg
语雀文档地址:

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下载地址
image.png
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-flowable
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/flowable?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true
    username: root
    password: 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相关的表是否已经生成,没有生成需要自行百度检查哟-看到有表了就表示🆗了

image.png

安装flowable-ui

解压flowable-6.8.0.zip
image.png
将flowable-ui.war放到tomcat的webapps目录下
image.png
启动tomcat
image.png
访问http://localhost:8080/flowable-ui/idm/#/login登录

flowable.common.app.idm-admin.user=admin 默认用户名admin
flowable.common.app.idm-admin.password=test 默认密码test

image.png
登录成功后的页面
image.png

helloworld

使用flowable-ui画流程图


image.png

image.png

image.png
image.png
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>

在项目中的情况
image.png

新建单元测试 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 {

    @Resource
    private RepositoryService repositoryService;

    @Resource
    private RuntimeService runtimeService;

    @Resource
    private TaskService taskService;


    /**
     * ① 部署流程
     */
    @Test
    public void deploy(){
        Deployment deploy = repositoryService.createDeployment()
                .addClasspathResource("helloworld/helloworld.bpmn20.xml")
                .name("请假-01")
                .deploy();
        System.out.println("deploy.getId() = " + deploy.getId());
    }

    /**
     * ② 启动流程
     */
    @Test
    public void startProcess(){
        // 根据流程id启动流程===》注意使用自己的流程id
        ProcessInstance instance = runtimeService.startProcessInstanceById("helloword:1:0a03cbb1-1caf-11ef-974d-4a5f08bacd87");
        System.out.println(instance.getId());
    }

    /**
     * ③ 审批流程任务
     */
    @Test
    public void assigneeTask(){
        // 根据审批人查找要审批的任务
        List<Task> list = taskService.createTaskQuery().taskAssignee("hr").list();
        list.forEach(task -> {
            System.out.println(task.getId());
            // 审批任务
            taskService.complete(task.getId());
        });
    }


}

image.png

运行

运行单元测试:① 部署流程
查看数据库:
image.png
运行单元测试:② 启动流程
查看数据库:
image.png
image.png
运行单元测试:③ 审批流程任务
查看数据库:hr的任务已经审批了
image.png

基础知识

什么是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的建模语言标准之一。

工作流的开源框架

以下是一些常见的开源工作流框架,可用于实现工作流管理系统:

  1. Activiti:
    • Activiti是一个轻量级的、开源的工作流引擎,基于Java语言。
    • 它提供了可视化建模工具、灵活的流程定义、任务分配、用户任务管理、流程监控和报告等功能。
    • Activiti支持与Java应用程序的集成,并提供REST API和Java API进行工作流操作。
  2. Camunda:
    • Camunda是一个功能强大的、开源的工作流引擎,也是基于Java的。
    • 它支持BPMN 2.0标准,提供了流程建模、任务分配、用户任务管理、流程实例管理、事件驱动、流程监控和报告等功能。
    • Camunda具有良好的扩展性和可定制性,并提供REST API和Java API用于集成和操作工作流。
  3. jBPM:
    • jBPM是一个基于Java的开源工作流引擎,由Red Hat维护。
    • 它支持BPMN 2.0标准,提供了流程建模、任务分配、流程实例管理、决策管理、事件驱动、流程监控和报告等功能。
    • jBPM具有良好的可扩展性和灵活性,并可以与Java应用程序集成。
  4. Flowable:
    • Flowable是一个轻量级的、开源的工作流和业务流程管理引擎,基于Java语言。
    • 它支持BPMN 2.0标准,提供了流程建模、任务分配、流程实例管理、事件驱动、流程监控和报告等功能。
    • Flowable具有高度可定制性,并提供REST API和Java API用于集成和操作工作流。

这些开源工作流框架提供了丰富的功能和灵活性,可以用于构建各种类型的工作流管理系统。根据项目需求和技术栈的考虑,选择适合的工作流框架进行开发。

flowable-ui介绍

身份管理应用程序

流程审批是需要用户参与的,我们通过 身份管理应用程序来创建2个测试用户
image.png
点击身份管理应用程序进去后,我们可以看到从三个角度来管理用户:用户、组、权限控制
image.png

创建用户

创建两个测试用户:xiaozhang、xiaoming
image.png
点击用户-创建用户
image.png

创建组

image.png
点击组-创建组
image.png
添加组成员
image.png
image.png

权限控制

给组添加权限
访问idm应用
image.png
访问modeler应用
image.png

建模器应用程序

在flowable-ui中建模器应用程序是用来画流程图的,当然你也可以使用第三方流程图工具,我们学习就使用官方的,下面我们介绍如何使用。
image.png
点击 流程->创建流程 来填写信息
image.png
image.png
最终效果面板
image.png

流程部署及审批

画流程图

画一个简单的请假流程图,有直接领导审批和hr审批,点击流程-创建流程-填写信息 进入画图面板。
image.png
进入面板默认有一个空启动事件
image.png
增加一个直接领导审批节点,点击人头像图标添加
image.png
image.png
分配用户填写
image.png
image.png
添加一个hr审批节点
image.png
添加一个结束节点
image.png
image.png
校验保存
image.png
image.png
点击刚刚创建好的流程
image.png
image.png
点击下载按钮下载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类

    @Resource
    private RepositoryService repositoryService;

    /**
     * ① 部署流程
     */
    @Test
    public 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字段通过程序关联,在数据库表结构中没有体现。
image.png
image.png
image.png

启动流程

启动流程使用RuntimeService类

    @Resource
    private RuntimeService runtimeService;
    /**
     * ② 启动流程
     */
    @Test
    public 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 流程引擎的核心表,它们共同协作来实现流程的执行和管理。通过对这两张表的操作,可以实现对流程的监控、跟踪和管理,以及对用户任务的分配、执行和完成等操作。
image.png
image.png

流程任务审批

流程任务审批使用TaskService类

    @Resource
    private TaskService taskService;
    /**
     * ③ 审批流程任务
     */
    @Test
    public 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相关数据会被清除

相关推荐

最近更新

  1. TCP协议是安全的吗?

    2024-06-10 03:16:02       16 阅读
  2. 阿里云服务器执行yum,一直下载docker-ce-stable失败

    2024-06-10 03:16:02       16 阅读
  3. 【Python教程】压缩PDF文件大小

    2024-06-10 03:16:02       15 阅读
  4. 通过文章id递归查询所有评论(xml)

    2024-06-10 03:16:02       18 阅读

热门阅读

  1. 第三章:Three.js 基本概念

    2024-06-10 03:16:02       12 阅读
  2. 黄仁勋:打破摩尔定律,机器人时代来了

    2024-06-10 03:16:02       12 阅读
  3. mac前端开发环境搭建:一步步指引你的编程之旅

    2024-06-10 03:16:02       8 阅读
  4. Vue如何引入ElementUI并使用

    2024-06-10 03:16:02       8 阅读
  5. 深入解析:MySQL连接超时问题排查与优化策略

    2024-06-10 03:16:02       10 阅读
  6. QuanTA: 一种新的高秩高效微调范式

    2024-06-10 03:16:02       10 阅读
  7. 【环境搭建】5.阿里云ECS服务器 安装Nginx

    2024-06-10 03:16:02       8 阅读