【Activiti学习之五】BPMN事件

时间:2021-12-07 06:51:26

环境
  JDK 1.8
  MySQL 5.6
  Tomcat 7
  Eclipse-Luna
  activiti 6.0

一、事件定义
1、定时器事件
(1)timeDate:指定时间触发
<timerEventDefinition>
<timeDate>2019-09-12T07:30:00</timeDate>
</timerEventDefinition>
ISO8601时间格式,如果要加时间需要前面加T。

(2)timeDuration:指定一个时间段之后执行
<timerEventDefinition>
<timeDuration>PT1S</timeDuration>
</timerEventDefinition>
S表示秒,M表示分,D表示天;P表示时间段,T表示精确到时间的时间段;

(3)timeCycle:指定定时器的运行周期
<timerEventDefinition>
<timeCycle>R2/PT1M</timeCycle>
</timerEventDefinition>
R表示需要执行的次数,R2/PT1M表示执行两次,每次持续1分钟
支持cron表达式:秒 分钟 小时 月份中的日期 月份 星期中的日期 年份

2、错误事件
处理流程中出现的异常。
举例:
<error id="myerror" errorCode="123"></error>
<process id="testp" name="testp">
<endEvent id="myerrorevent">
<errorEventDefinition errorRef="myerror"></errorEventDefinition>
</endEvent>
</process>

3、信号事件
使用信号给流程发送广播。
<signal id="signalA" name="signalA"></signal>
<process id="testp" name="testp">
...
<signalEventDefinition signalRef="signalA"></signalEventDefinition>
...
</process>

4、消息事件
消息指向某个接收人,而不是整个流程。
<message id="mymessage" name="mymessage"></message>
<process id="testp" name="testp">
...
<messageEventDefinition messageRef="mymessage"></messageEventDefinition>
...
</process>

5、取消事件
取消事件使用在事务子流程中。
<cancelEventDefinition></cancelEventDefinition>

6、补偿事件
补偿事件对于已经完成的流程做回退处理。
<componsateEventDefinition></componsateEventDefinition>

7、其他事件
条件事件:<ConditionalEventDefinition>
升级事件:<EscalationEventDefinition>
连接事件:<LinkEventDefinition>
终止事件:<TerminateEventDefinition>

参考:BPMN事件分类与事件定义

二、开始事件
1、无指定开始事件
不为开始事件指定任何触发条件。
<startEvent id="s" name="s"></startEvent>

【Activiti学习之五】BPMN事件

2、定时器开始事件
<startEvent id="s" name="s">
<timerEventDefinition id="ss" name="ss">
<timeCycle>PT1S</timeCycle>
</timerEventDefinition>
</startEvent>

【Activiti学习之五】BPMN事件

3、消息开始事件
<message id="mymessage" name="mymessage"></message>
<process id="testp" name="testp">
<startEvent id="s" name="s">
<messageEventDefinition messageRef="mymessage"></messageEventDefinition>
</startEvent>

【Activiti学习之五】BPMN事件
4、错误开始事件
错误开始事件只能用在事件子流程中。
<error id="errorId" errorCode="MyErrorCode"></error>
<process id="errorStartEventTest01" name="错误开始事件测试01" isExecutable="true">
<startEvent id="start"></startEvent>
<serviceTask id="serviceTask01" name="Service Task" activiti:class="com.bug315.event.ErrorStartEventDelegate"></serviceTask>
<endEvent id="end"></endEvent>

<sequenceFlow id="sid-1EAADC30-396A-4E19-B181-C688B909510B" sourceRef="serviceTask01" targetRef="end"></sequenceFlow>
<sequenceFlow id="sid-07875D4F-D2C7-47E0-B4C3-6866F110206F" sourceRef="start" targetRef="serviceTask01"></sequenceFlow>

<subProcess id="sid-DDBC6BA0-A097-4FC9-8023-C40E6AD0B499" name="subProcess" triggeredByEvent="true">
<startEvent id="subStart">
<errorEventDefinition errorRef="errorId"></errorEventDefinition>
</startEvent>
<serviceTask id="subServiceTask01" name="Sub Task" activiti:class="com.bug315.event.ErrorHandlerDelegate"></serviceTask>
<endEvent id="subEnd"></endEvent>
<sequenceFlow id="sid-24413ADF-BD05-4BB7-9FA8-E70154B94767" sourceRef="subServiceTask01" targetRef="subEnd"></sequenceFlow>
<sequenceFlow id="sid-A130E45F-9A0B-4362-908E-C8FEB3F640E7" sourceRef="subStart" targetRef="subServiceTask01"></sequenceFlow>
</subProcess>
</process>

参考:开始事件

三、结束事件
1、无指定结束事件
<endEvent id="subEnd" name=""></endEvent>

【Activiti学习之五】BPMN事件

2、错误结束事件
错误结束事件一般用在子流程中,一般和错误边界事件一起使用才有意义。
<endEvent id="subEnd">
<errorEventDefinition errorRef="errorId"></errorEventDefinition>
</endEvent>

3、取消结束事件和取消边界事件
取消结束事件只能用在事务子流程中,该事件表示事务将会取消,并且会触发附在事务子流程上的取消边界事件。

参考:结束事件
四、边界事件
附属于某个流程元素(如任务、子流程等)的事件为边界事件。边界事件是Catching事件,会等待被触发,当边界事件被触发,当前的活动会被中断,并且当前的顺序流会发生转移。
1、定时器边界事件
需要注意的是:需要开启JobExecutor,cancelActivity属性为true表示原先的流程被中断,false表示不中断,继续执行
示例:
<process id="myProcess" name="My process" isExecutable="true">
<startEvent id="startevent1" name="Start"></startEvent>
<userTask id="usertask1" name="初级工程师处理"></userTask>
<userTask id="usertask2" name="中级工程师处理"></userTask>
<endEvent id="endevent1" name="End"></endEvent>
<boundaryEvent id="boundarytimer1" name="Timer"
attachedToRef="usertask1" cancelActivity="true">
<timerEventDefinition>
<timeDuration>PT5S</timeDuration>
</timerEventDefinition>
</boundaryEvent>
....
</process>

【Activiti学习之五】BPMN事件

2、错误边界事件
错误边界事件依附在某个流程活动中,用于捕获子流程中抛出的错误,因此错误边界事件使用在嵌入子流程或调用子流程中。
<process id="ebProcess" name="ebProcess">
<startEvent id="startevent1" name="Start"></startEvent>
<endEvent id="endevent1" name="End"></endEvent>
<subProcess id="subprocess1" name="Sub Process">
<startEvent id="startevent2" name="Start"></startEvent>
<serviceTask id="servicetask1" name="Throw Error Task"
activiti:class="org.crazyit.activiti.ThrowErrorDelegate"></serviceTask>
<endEvent id="endevent2" name="ErrorEnd"></endEvent>
<sequenceFlow id="flow4" name="" sourceRef="startevent2"
targetRef="servicetask1"></sequenceFlow>
<sequenceFlow id="flow5" name="" sourceRef="servicetask1"
targetRef="endevent2"></sequenceFlow>
</subProcess>
<boundaryEvent id="boundaryerror1" cancelActivity="false"
attachedToRef="subprocess1">
<errorEventDefinition errorRef="abc"></errorEventDefinition>
</boundaryEvent>
....
</process>
【Activiti学习之五】BPMN事件
3、信号边界事件
信号边界事件的触发条件是接收到信号,但是不一样的是,信号边界事件具有全局性,换言之,信号边界事件会进行全局范围的信号捕获。与定时器边界事件类似,信号边界事件同样存在可中断与不可中断两类,可以为boundaryEvent元素设置cancelActivity属性,如果设置为true,那么原来的执行流将会被中断,设置为false,则原来的执行流仍然存在。如果多个信号边界事件使用了相同的信号,当在某个地方发出信号时,即使在不同的流程实例中,这些信号边界事件均会捕获到该信号。
<signal id="contactChangeSignal" name="contactChangeSignal"></signal>
<process id="sbProcess" name="sbProcess">
<startEvent id="startevent1" name="Start"></startEvent>
<userTask id="usertask1" name="签订查看"></userTask>
<userTask id="usertask2" name="合同确认"></userTask>
<boundaryEvent id="boundarysignal1" cancelActivity="true"
attachedToRef="usertask2">
<signalEventDefinition signalRef="contactChangeSignal"></signalEventDefinition>
</boundaryEvent>
<userTask id="usertask3" name="合同变更"></userTask>
<userTask id="usertask4" name="签订合同"></userTask>
<endEvent id="endevent1" name="End"></endEvent>
...
</process>
【Activiti学习之五】BPMN事件

4、补偿边界事件
使用了取消结束事件和取消边界事件,当事务子流程被取消时,会触发事务子流程里面的补偿边界事件,这些补偿边界事件会依附在事务子流程的活动中,除了在事务子流程中可以使用取消事件来触发补偿边界事件外,还可以使用补偿中间事件来触发补偿边界事件。

参考:边界事件

五、中间事件
中间事件是指可以单独作为流程元素的事件,BPMN2.0规范中所指的中间事件也包括边界事件。中间事件作为流程元素表示对事件的捕获与事件的触发,一类中间事件可以在流程中等待被触发,一类中间事件会在流程中自动被触发并抛出结果(触发信息)。
除了无指定Throwing中间事件外,其他事件均需要加入事件定义。

1、中间Catching事件
(1)定时器(Timer)中间事件
定时器中间事件一直等待被触发,当达到定义的时间条件后,该定时器中间事件会被触发,流程继续往下执行。
<process id="tcProcess" name="tcProcess">
<startEvent id="startevent1" name="Start"></startEvent>
<userTask id="usertask1" name="发货"></userTask>
<userTask id="usertask2" name="接收订单"></userTask>
<intermediateCatchEvent id="timerintermediatecatchevent1"
name="TimerCatchEvent">
<timerEventDefinition>
<timeDuration>PT1M</timeDuration>
</timerEventDefinition>
</intermediateCatchEvent>
<endEvent id="endevent1" name="End"></endEvent>
...
</process>
【Activiti学习之五】BPMN事件
(2)信号(Signal)中间事件
一个信号中间Catching事件会等待被触发,直接到该事件接收到相应的信号,与其他事件不同的是,当信号事件接收到信号后,该信号不会被消耗掉,如果存在多个引用了相同信号的事件,那么当接收到信号时,这些事件被一并被触发,即使它们不在同一个流程实例中.

(3)消息(Message)中间事件

<intermediateCatchEvent id="myIntermediateCatchEvent" >
<XXXEventDefinition/>
</intermediateCatchEvent>

2、中间Throwing事件:
(1)无指定(None)中间事件
(2)信号(Signal)中间事件
(3)补偿(Compensation)中间事件

<intermediateThrowEvent id="myIntermediateThrowEvent" >
<XXXEventDefinition/>
</intermediateThrowEvent>

参考:中间事件

六、补偿中间事件

参考:补偿中间事件

参考:疯狂工作流讲义(第2版)基于Activiti6.x