Flowable实战：启动事件与结束事件

工作流只要是涉及到组织审批和审核的情况下基本都需要，Flowable作为一个工作流现在比较流行的框架，算是activiti框架的修正版，国外这种情况还蛮多的就是，就是原班人马走了然后另起一家，据说硅谷没有竞业协议的说法，也不知道这个是不是真的。

前面的知识我也是摸着别人的入坑的
这里有两个简单的关于flowable的简单例子，一个是简单的整合的flowable的maven，还有一个是简单的springboot整合的项目，当然实际例子肯定不会那么简单，我看到的一些BPMN文件复杂的不像话，各种条件。

maven整合的简单flowbale简单demo

springboot整合的flowable简单demo

一 前置知识

如果你有使用过flow able的经历或者启动过我上面的demo，会有一个疑问就是我的工作流要怎么设计的，程序如何获取这些信息处理。

这涉及到一个BPMN，也就是业务流模型和标记标准，根据这个标准去定义工作流模型，工程中是我们的一个resorce/process文件夹下面的一个xml文件，当然这个文件看起来不直观易懂，尤其是添加复杂的情况下，实际上还有很多可视化工具可以将其转化图的形式，比如我IDE用的是Flowable BPMN visualizer。同样前端也有很多展示的JS插件工具。

这个文件就是流程定义文件，他和flowable数据库的基础表（里面的基础表是第一次启动连接数据自动生成的，只有你自定义的表要自己去建。）

以下是我demo的一个流程定义文件：

二 启动事件

现在通用的标准是BPMN2.0大家都用这一个标准的产品，我换别人家的产品时，就很平滑不至于说，我只能用这一家，用别人的要重新开始。

启动事件

这里介绍的启动事件和结束事件是流程的一个基础部分，启动事件指的是start event，流程的起点.

1

启动事件在XML中，类型由子元素声明来定义。
启动事件保持等候状态，直到特定的触发器被触发。
启动事件是细线图形。

1 空启动事件

none Start Event 未指定触发器，就是由用户来触发启动的事件。

空心圆来代表空启动事件（中间没有图标就是没有触发器的意思）

1

使用方法

	ProcessInstance processInstance = runtimeService.startProcessInstanceByXXX();
1

扩展

	
1

2 定时器启动事件

定时器启动，timer start event，在指定时间内创建一次或多次流程实例。
定时器启动事件，在流程部署的同时就开始计时。不需要调用startProcessInstanceByXXX就会在时间启动。调用startProcessInstanceByXXX时会在定时启动之外额外启动一个流程。

当部署带有定时器启动事件的流程的更新版本时，上一版本的定时器作业会被移除。这是因为通常并不希望旧版本的流程仍然自动启动新的流程实例。

这个定时器只能包含以下一种元素
（实际上就是普通启动事件+定时器子元素，这也就是说为什么启动类型由子元素确定的意思）

timeDate 到时间就会触发

    
        2022-01-11T12:13:14
    

1
2
3
4

timeDuration 等待多长时间就会触发，P是period P10D D是Day天的意思，P10D就是每10天，同样的还有T 就是时间的意思，这些都遵循着ISO_8601标准。
duration ISO_8601格式

• P is the duration designator (for period) placed at the start of the duration representation.
  Y is the year designator that follows the value for the number of calendar years.
  M is the month designator that follows the value for the number of calendar months.
  W is the week designator that follows the value for the number of weeks.
  D is the day designator that follows the value for the number of calendar days.
  T is the time designator that precedes the time components of the representation.
  H is the hour designator that follows the value for the number of hours.
  M is the minute designator that follows the value for the number of minutes.
  S is the second designator that follows the value for the number of seconds.

For example, “P3Y6M4DT12H30M5S” represents a duration of “three years, six months, four days, twelve hours, thirty minutes, and five seconds”.

    
        P10D
    

1
2
3
4

timeCycle 重复周期 例如：R3/PT10H/2022-01-12T23:59:59+00:00 重复三次启动，每次间隔为10小时，到指定时间时结束重复

    
        R3/PT10H/2022-01-12T23:59:59+00:00
    

1
2
3
4

可以搭配变量比如结束时间${EndDate}

    
        R3/PT10H/${EndDate}
    

1
2
3
4

3 消息启动事件

消息启动事件，message start event 使用具名消息启动流程实例

一个流程定义不得包含多个同名的消息启动事件。
在流程定义中，一个或多个消息启动事件引用了已经部署的另一流程定义中消息启动事件的消息名，则会抛出异常。
流程版本：在部署流程定义的新版本时，会取消上一版本的消息订阅，即使新版本中并没有这个消息事件。

普通事件+messageEventDefinition子元素

    

        

        
           
            
                
            
            ...
        

    

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

相关代码

    ProcessInstance startProcessInstanceByMessage(String messageName);
    ProcessInstance startProcessInstanceByMessage(String messageName, Map processVariables);
    ProcessInstance startProcessInstanceByMessage(String messageName, String businessKey,
        Map

  
    
  
  
  
  
  


1
2
3
4
5
6
7
8
9
10
11
12

    
            
    

1
2
3
4

	
1

    
      
    
1
2
3

    
    ...
    
    ...

1
2
3
4
5

	
    ...
    
    ...
      
        
      
    ...

1
2
3
4
5
6
7
8
9

    
    
1
2
3

    
      
    

1
2
3
4