流程设计之flowable & springboot 的手动部署

什么是flowable？

Flowable是一个使用Java编写的轻量级业务流程引擎。Flowable流程引擎可用于部署BPMN 2.0流程定义（用于定义流程的行业XML标准）， 创建这些流程定义的流程实例，进行查询，访问运行中或历史的流程实例与相关数据Flowable可以十分灵活地加入你的应用/服务/构架。可以将JAR形式发布的Flowable库加入应用或服务，来嵌入引擎。 以JAR形式发布使Flowable可以轻易加入任何Java环境：Java SE；Tomcat、Jetty或Spring之类的servlet容器；JBoss或WebSphere之类的Java EE服务器，等。

工作流有哪些好处

工作流是一个固定好的框架，大家就按照这个框架来执行流程就行了，但某些情况他本身没有流转顺序的要求，比如：员工A需要请假需要通过经理和组长审批。这种情况我们需要使用CMMN来建模，它就是专门针对这种情况而设计的。工作流解决的痛点在于，解除业务宏观流程和微观逻辑的耦合，让熟悉宏观业务流程的人去制定整套流转逻辑，而让专业的人只需要关心他们应当关心的流程节点，总而言之，言而总之就是每个人只需要负责自己的部分。不用关心其他的步骤。

这里我们先说一下 Flowable UI 应用- Flowable IDM: 身份管理应用。为所有Flowable UI应用提供单点登录认证功能，并且为拥有IDM管理员权限的用户提供了管理用户、组与权限的功能。

1. Flowable Modeler: 让具有建模权限的用户可以创建流程模型、表单、选择表与应用定义。
2. Flowable Task: 运行时任务应用。提供了启动流程实例、编辑任务表单、完成任务，以及查询流程实例与任务的功能。
3. Flowable Admin: 管理应用。让具有管理员权限的用户可以查询BPMN、DMN、Form及Content引擎，并提供了许多选项用于修改流程实例、任务、作业等。管理应用通过REST API连接至引擎，并与Flowable Task应用及Flowable REST应用一同部署。

BPMN2.0 是一个广泛接受与支持的，展现流程的注记方法。BPMN 2.0标准对流程的所有的参与者都很有用。最终用户不会因为依赖专有解决方案，而被供应商“绑架”。Flowable之类的开源框架，也可以提供与大型供应商的解决方案相同（经常是更好;-）的实现。有了BPMN 2.0标准，从大型供应商解决方案向Flowable的迁移，可以十分简单平滑。

缺点则是标准通常是不同公司（不同观点）大量讨论与妥协的结果。作为阅读BPMN 2.0 XML流程定义的开发者，有时会觉得某些结构或方法十分笨重。Flowable将开发者的感受放在最高优先，因此引入了一些**Flowable BPMN扩展（extensions） **。这些“扩展”并不在BPMN 2.0规格中，有些是新结构，有些是对特定结构的简化。

尽管BPMN 2.0规格明确指出可以支持自定义扩展，我们仍做了如下保证：

需要放在Tomcat 容器中部署 Flowable UI

1.下载最新稳定版本的[Flowable 6](http://www.flowable.org/downloads.html)。
2.将Flowable发行包中，*wars*文件夹下的flowable-admin.war、flowable-idm.war、flowable-modeler.war与flowable-task.war文件，复制到Tomcat的webapps文件夹下。(注意：新版可能只有两个)

将这两个war 放在 tomcat 的webapp目录下启动tomcat就可以了（第一次启动会很慢）启动成功后之际访问http://192.168.1.14:8080/flowable-ui/ 当然这里的IP是自己的

默认情况下，Flowable IDM应用将创建一个具有访问所有Flowable UI应用所需的权限的admin用户。使用admin/test登录，浏览器会跳转至Flowable Modeler应用：

当然 作为可执行的Spring Boot应用，可以直接以独立应用模式运行UI，而不需要应用服务器。

java -jar flowable-idm.war 直接运行也是没有问题的

Flowable IDM应用

Flowable IDM应用，用于其他三个Flowable web应用的认证与授权。因此如果你想要运行Modeler，Task或者Admin应用，就需要运行IDM应用。Flowable IDM应用是一个简单的身份管理应用，目标是为Flowable web应用提供单点登录能力，并提供定义用户、组与权限的能力。

可以创建用户

用户创建完成之后 我们就可以开始设计自己的流程了

可以先设计一个简单的 请假流程

设计完成之后可以将这个流程下载下来

这个文件就是我们下载下来的BNMN2 文件

  
    北京龙猫集团员工请假流程
    
    
      
        
      
    
    
      
        
      
    
    
    
    
    
  
  
    
      
        
      
      
        
      
      
        
      
      
        
      
      
        
        
      
      
        
        
      
      
        
        
      
    
  

新建一个springboot 项目 下面是依赖

    
        org.springframework.boot
        spring-boot-starter
    

    
        org.springframework.boot
        spring-boot-starter-test
        test
    
    
        org.flowable
        flowable-spring-boot-starter
        6.6.0
    
    
        mysql
        mysql-connector-java
    
    
        com.alibaba
        druid
        1.1.14
    
    
        junit
        junit
        4.12
        test
    

yml 文件

spring:
  datasource:
    username: root
    password: root
    url: jdbc:mysql://192.168.1.14:3306/flowable1?autoReconnect=true&useUnicode=true&characterEncoding=utf-8&nullCatalogMeansCurrent=true&serverTimezone=Asia/Shanghai
    driver-class-name: com.mysql.cj.jdbc.Driver
    type: com.alibaba.druid.pool.DruidDataSource
    initialSize: 5
    minIdle: 5
    maxActive: 20
    # 配置获取连接等待超时的时间
    maxWait: 60000
flowable:
  async-executor-activate: false
  database-schema-update: true
server:
  port: 8002

创建一个空的数据库启动一下项目

数据库表名说明

Flowable的所有数据库表都以ACT_ 开头。第二部分是说明表用途的两字符标示符。服务API的命名也大略符合这个规则。

1. ACT_RE_ *: 'RE’代表repository。带有这个前缀的表包含“静态”信息，例如流程定义与流程资源（图片、规则等）。
2. ACT_RU_ *: 'RU’代表runtime。这些表存储运行时信息，例如流程实例（process instance）、用户任务（user task）、变量（variable）、作业（job）等。Flowable只在流程实例运行中保存运行时数据，并在流程实例结束时删除记录。这样保证运行时表小和快。
3. ACT_HI_ *: 'HI’代表history。这些表存储历史数据，例如已完成的流程实例、变量、任务等。
4. ACT_GE_ *: 通用数据。在多处使用。

历史表 HistoryService

1. act_hi_actinst：历史节点表，存放流程实例运转的各个节点信息（包含开始、结束等非任务节点）；
2. act_hi_attachment：历史附件表，存放历史节点上传的附件信息；
3. act_hi_comment：历史意见表；
4. act_hi_detail：历史详情表，存储节点运转的一些信息；
5. act_hi_identitylink：历史流程人员表，存储流程各节点候选、办理人员信息，常用于查询某人或部门的已办任务；
6. act_hi_procinst：历史流程实例表，存储流程实例历史数据（包含正在运行的流程实例）；
7. act_hi_taskinst：历史流程任务表，存储历史任务节点；
8. act_hi_varinst：流程历史变量表，存储流程历史节点的变量信息；流程定义表：
9. act_re_deployment：部属信息表，存储流程定义、模板部署信息；
10. act_re_procdef：流程定义信息表，存储流程定义相关描述信息，但其真正内容存储在act_ge_bytearray表中，以字节形式存储；
11. act_re_model：流程模板信息表，存储流程模板相关描述信息，但其真正内容存储在act_ge_bytearray表中，以字节形式存储；

流程运行时表 RuntimeService

1. act_ru_task：运行时流程任务节点表，存储运行中流程的任务节点信息，重要，常用于查询人员或部门的待办任务时使用；
2. act_ru_event_subscr：监听信息表;
3. act_ru_execution：运行时流程执行实例表，记录运行中流程运行的各个分支信息（当没有子流程时，其数据与act_ru_task表数据是一一对应的）；
4. act_ru_identitylink：运行时流程人员表，重要，常用于查询人员或部门的待办任务时使用；
5. act_ru_job：运行时定时任务数据表，存储流程的定时任务信息；
6. act_ru_variable：运行时流程变量数据表，存储运行中的流程各节点的变量信息；

用户相表IdentityService

1. act_id_group：用户组信息表，对应节点选定候选组信息；
2. act_id_info：用户扩展信息表，存储用户扩展信息；
3. act_id_membership：用户与用户组关系表；
4. act_id_user：用户信息表，对应节点选定办理人或候选人信息；

流程定义、流程模板相关表 RepositoryService

1. act_re_deployment：部属信息表，存储流程定义、模板部署信息；
2. act_re_procdef：流程定义信息表，存储流程定义相关描述信息，但其真正内容存储在act_ge_bytearray表中，以字节形式存储；
3. act_re_model：流程模板信息表，存储流程模板相关描述信息，但其真正内容存储在act_ge_bytearray表中，以字节形式存储；

下面让我们把我们刚才画的 流程图 手动部署一下 将下载下来的 bpmn2文件复制到springboot项目中resources目录下

使用RepositoryService 手动部署流程

@Autowired
private RepositoryService repositoryService;//获取Flowable服务
public  void testDeploy() {
        Deployment holiday = repositoryService.createDeployment()
                .addClasspathResource("MyHolidayUI.bpmn20.xml")
                .name("holiday01")
                .deploy();
        System.out.println("getId:"+holiday.getId());
        System.out.println("getName:"+holiday.getName());
    }

在DB ACT_RE_PROCDEF表中会添加一条记录

下面我们启动 一下流程

@Test
void testStart() {
    Map map=new HashMap<>();
    map.put("assignee0","张三");//发起人
    map.put("assignee1","李四");//审批人
    //ACT_RE_PROCDEF 中 ID_ MyHolidayUI:1:9350a27d-c9ed-11ec-ae28-666ee0fc370d
    runtimeService.startProcessInstanceById("MyHolidayUI:1:9824b6ed-cb5e-11ec-8000-666ee0fc370d",map);
}

就可以在 看到 ACT_RU_TASK中多一条记录

下面我们模拟完成一下 流程

@Test
void testcomlete() {
    Task task = taskService.createTaskQuery()
            //ACT_RU_TASK 表中 PROC_INST_ID_
            .processInstanceId("32551110-cb5f-11ec-8778-666ee0fc370d")
            .taskAssignee("张三")
            .singleResult();
    if (task!=null){
        taskService.complete(task.getId());
        System.out.println("完成");
        //去 历史表中查看
    }
}

完成之后我们去 历史记录中去获取

@Test
void testHistory(){
    List list =
            historyService.createHistoricActivityInstanceQuery()
            .finished()
            //.taskAssignee("李四")
             .processDefinitionId("MyHolidayUI:1:9824b6ed-cb5e-11ec-8000-666ee0fc370d")
            .orderByHistoricActivityInstanceEndTime().asc()
            .list();
    for (HistoricActivityInstance historicActivityInstance : list) {
        System.out.println("ActivityName:"+historicActivityInstance.
                getActivityName()+"ActivityId:"+historicActivityInstance.getActivityId()+
                "耗时："+historicActivityInstance.getDurationInMillis()+"执行人："+historicActivityInstance.getAssignee()
                );

    }
}

整个流程完成 关于其他的API的使用 大家可以 参考
Flowable BPMN 用户手册