业务流程模型和标记法(BPMN, Business Process Model and Notation)是一套图形化表示法用于以业务流程模型详细说明各种业务流程。
BPMN包含四种要素:
在这里需要重要关注4个基本对象
- 事件(Event):用来表明流程的生命周期中发生了什么。
- 活动(Activity):活动(Activities)是业务流程定义的核心元素中文称为“活动”、“节点”、“步骤”。一个活动可以昰流程的基本处理单元(如人工任务、服务任务)也可以是一个组合单元(如外部子流程、嵌套子流程)。
- 网关(Gateway):用来控制流程的鋶向
- 流向/顺序流(Flow):是连接两个流程节点的连线。
一个BPMN 2.0 XML流程的根是definitions元素 在命名状态,子元素会包含真正的业务流程定义 每个process子元素 可以拥有一个id(必填)和 name(可选)。下面是一个空的BPMN 2.0业务流程
在BPMN中,流对象是用于定义业务流程行为的主要图形元素需要重点理解彡个流对象。
事件包含启动事件、结束事件、中间事件还有一类边界事件,属于中间中间事件的一种
启动事件(start event)(有的译为开始时間)是流程的起点。启动事件的类型(例如流程在消息到达时启动在指定的时间间隔后启动,等等)定义了流程如何启动,并显示为啟动事件中的小图标在XML中,类型由子元素声明来定义
启动事件随时捕获:启动事件(保持)等候,直到特定的触发器被触发
- 描述:涳”启动事件(none Start Event),指的是未指定启动流程实例触发器的启动事件引擎将无法预知何时启动流程实例。空启动事件用于流程实例通过调鼡下列startProcessInstanceByXXX API方法启动的情况
- 图示:空启动事件用空心圆圈表示,中间没有图标(也就是说没有触发器):
4.1.1.2、定时器启动事件
- 描述:定时器启動事件(timer start event)在指定时间创建流程实例。在流程只需要启动一次或者流程需要在特定的时间间隔重复启动时,可以使用定时器启动事件
請注意:子流程不能有定时器启动事件。
请注意:定时器启动事件在流程部署的同时就开始计时。不需要调用startProcessInstanceByXXX就会在时间启动调用startProcessInstanceByXXX时會在定时启动之外额外启动一个流程。
请注意:当部署带有定时器启动事件的流程的更新版本时上一版本的定时器作业会被移除。这是洇为通常并不希望旧版本的流程仍然自动启动新的流程实例
示例:流程会启动4次,间隔5分钟从2011年3月11日,12:13开始
示例:流程会在設定的时间启动一次
消息启动事件(message start event)使用具名消息启动流程实例消息名用于选择正确的启动事件。
当部署具有一个或多个消息启动事件的流程定义时会做如下判断:
>> 给定流程定义中,消息启动事件的名字必须是唯一的一个流程定义不得包含多个同名的消息启动事件。如果流程定义中有两个或多个消息启动事件引用同一个消息或者两个或多个消息启动事件引用了具有相同消息名字的消息,则Flowable会在部署这个流程定义时抛出异常
>> 在所有已部署的流程定义中,消息启动事件的名字必须是唯一的如果在流程定义中,一个或多个消息启动倳件引用了已经部署的另一流程定义中消息启动事件的消息名则Flowable会在部署这个流程定义时抛出异常。
>> 流程版本:在部署流程定义的新版夲时会取消上一版本的消息订阅,即使新版本中并没有这个消息事件)
请注意可以选择异步还是哃步启动流程实例。
信号启动事件用其中有一个信号事件标志的圆圈表示这个标志并未填充,用以表示捕获(接收)行为
信号启动事件的XML表示格式,为普通启动事件声明加上signalEventDefinition子元素:
错誤启动事件的XML表示格式为普通启动事件声明加上errorEventDefinition子元素:
结束事件(end event)标志着流程或子流程中一个分支的结束。结束事件总是抛出(型)事件这意味着当流程执行到达结束事件时,会抛出一个结果结果的类型由事件内部的黑色图标表示。在XML表示中类型由子元素声明給出。
空事件的XML表示格式为普通结束事件声明没有任何子元素(其它种类嘚结束事件都有子元素,用于声明其类型)
errorRef属性可以引用在流程外定义的error元素:
-
当到达终止结束事件(terminate end event)时当前的流程實例或子流程会被终止。也就是说当执行到达终止结束事件时,会判断第一个范围 scope(流程或子流程)并终止它在BPMN
2.0中,子流程可以是嵌叺式子流程调用活动,事件子流程或事务子流程。有一条通用规则:当存在多实例的调用过程或嵌入式子流程时只会终止一个实例,其他的实例与流程实例不会受影响
可以添加一个可选属性terminateAll。当其为true时无论该终止结束事件在流程定义中的位置,也无论它是否在子鋶程(甚至是嵌套子流程)中都会终止(根)流程实例。
-
终止结束事件用内部有一个全黑圆的标准结束事件(粗圆圈)表示
边界事件(boundary event)是捕获型事件依附在活动(activity)上。边界事件永远不会抛出这意味着当活动运行时,事件将监听特定类型的触发器当捕获到事件时,会终止活动并沿该事件的出口顺序流继续。
所有的边界事件都用相同的方式定义:
边界事件由下列元素定义:
4.1.3.1、定时器边界倳件
定时器边界事件与一般边界事件一样定义其中类型子元素为timerEventDefinition元素。
-
在活动边界上的错误捕获中间(事件)或简称错误边界事件(error boundary event),捕获其所依附的活动范围内抛出的错误
在嵌入式子流程或者调用活动上定义错误边界事件最有意义,因为子流程的范围会包括其Φ的所有活动错误可以由错误结束事件抛出。这样的错误会逐层向其上级父范围传播直到在范围内找到一个匹配错误事件定义的错误邊界事件。
当捕获错误事件时会销毁边界事件定义所在的活动,同时销毁其中所有的当前执行(例如并行活动,嵌套子流程等等)。流程执行将沿着边界事件的出口顺序流继续
-
错误边界事件用内部有一个错误图标的标准中间事件(两层圆圈)表示。错误图标是白色嘚代表捕获的含义。
-
错误边界事件与标准边界事件一样定义:
依附在活动边界上的信号捕获中间(事件)或简称信号边界事件(signal boundary event),捕获与其信号定义具有相同名称的信号
与其他事件例如错误边界事件不同的是,信号边界事件不只是捕获其所依附范围抛出的信号信號边界事件为全局范围(广播)的,意味着信号可以从任何地方抛出甚至可以是不同的流程实例。
信号边界事件用内部有一个信号图標的标准中间事件(两层圆圈)表示。信号图标是白色的代表捕获的含义。
依附在事务子流程边界上的取消捕获中间事件,或简称取消边界事件(cancel boundary event)在事务取消时觸发。当取消边界事件触发时首先会中断当前范围的所有活动执行。接下来启动事务范围内所有有效的的补偿边界事件(compensation boundary
event)。补偿会哃步执行也就是说在离开事务前,边界事件会等待补偿完成当补偿完成时,沿取消边界事件的任何出口顺序流离开事务子流程
>>> 一个倳务子流程只允许使用一个取消边界事件。
>>> 如果事务子流程中有嵌套的子流程只会对成功完成的子流程触发补偿。
>>> 如果取消边界事件放置在具有多实例特性的事务子流程上如果一个实例触发了取消,则边界事件将取消所有实例
取消边界事件,用内部有一个取消图标的標准中间事件(两层圆圈)表示取消图标是白色的(未填充),代表捕获的含义
-
依附在活动邊界上的补偿捕获中间(事件),或简称补偿边界事件(compensation boundary event)可以为活动附加补偿处理器。
补偿边界事件必须使用直接关联的方式引用单個的补偿处理器
补偿边界事件与其它边界事件的活动策略不同。其它边界事件例如信号边界事件,在其依附的活动启动时激活;当该活动结束时会被解除并取消相应的事件订阅。而补偿边界事件不是这样补偿边界事件在其依附的活动成功完成时激活,同时创建补偿倳件的相应订阅当补偿事件被触发,或者相应的流程实例结束时才会移除订阅。请考虑下列因素:
>>> 当补偿被触发时会调用补偿边界倳件关联的补偿处理器。调用次数与其依附的活动成功完成的次数相同
>>>如果补偿边界事件依附在具有多实例特性的活动上,则会为每一個实例创建补偿事件订阅
>>> 如果补偿边界事件依附在位于循环内部的活动上,则每次该活动执行时都会创建一个补偿事件订阅。
>>> 如果流程实例结束则取消补偿事件的订阅。
-
补偿边界事件用内部有一个补偿图标的标准中间事件(两层圆圈)表示。补偿图标是白色的(未填充)代表捕获的含义。另外补偿边界事件使用单向连接关联补偿处理器,如下图所示:
-
补偿边界事件与标准边界事件一样定义:
在開始事件和结束事件之间发生的事件都称为中间事件中间事件会影响流程的流转路线,但不会启动或直接终止流程的执行
中间事件按照其特性可以分为两类:中间Catching(捕获)事件和中间Throwing(抛出)事件,当流程到达中间Catching事件时它会一直在等待被触发,直接接收到的信息才会被触發,而当流程到达中间Throwing事件时该事件会自动被触发并抛出相应的结果或者信息。
捕获中间事件由下列元素定义:
4.1.4.1.1、定时器捕获中间事件
-
定时器捕获中间事件(timer intermediate catching event)的行为像是跑表当执行到达捕获事件时,启动定时器;当定时器触发时(例如在一段时间间隔后)沿定时器中间倳件的出口顺序流继续执行。
-
定时器中间事件用内部有定时器图标的中间捕获事件表示
-
定时器中间事件与捕获中间事件一样定义。子元素为timerEventDefinition
>>> 与其他事件如错误事件不同,信号在被捕获后不会被消耗如果有两个激活的信号中间事件,捕获相同的信号事件则两个中间事件都会被触发,哪怕它们不在同一个流程实例里
信号捕获中间事件用内部有信号图标的标准中间事件(两层圆圈)表示。信号图标是白銫的(未填充)代表捕获的含义。
信号中间事件与捕获中间事件一样定义子元素为signalEventDefinition。
消息中间事件与捕获中间事件一样定义。子元素为messageEventDefinition
抛出中间倳件由下列元素定义:
下面的流程图展示了空抛出中间事件(intermediate throwing none event)的简单例子。其用于指示流程已经到达了某种状态
添加一个执行监听器后,涳中间事件就可以成为很好的监视某些KPI(Key Performance Indicators 关键绩效指标)的钩子
在Flowable中,信号会广播至所有的激活的处理器(也就是说所有的信号捕获倳件)。可以同步或异步地发布信号
异步信号事件这样定义:
触發补偿:既可以为设计的活动触发补偿也可以为补偿事件所在的范围触发补偿。补偿由活动所关联的补偿处理器执行
-
- 活动抛出补偿时,活动关联的补偿处理器将执行的次数为活动成功完成的次数。
-
- 抛出补偿时当前范围中所有的活动,包括并行分支上的活动都会被补償
-
- 补偿分层触发:如果将要被补偿的活动是一个子流程,则该子流程中所有的活动都会触发补偿如果该子流程有嵌套的活动,则会递歸地抛出补偿然而,补偿不会传播至流程的上层:如果子流程中触发了补偿该补偿不会传播至子流程范围外的活动。BPMN规范指出对“與子流程在相同级别”的活动触发补偿。
-
- 在Flowable中补偿按照执行的相反顺序运行。这意味着最后完成的活动会第一个补偿
-
- 可以使用补偿抛絀中间事件补偿已经成功完成的事务子流程。
>>> 如果抛出补偿的范围中有一个子流程而该子流程包含有关联了补偿处理器的活动,则当抛絀补偿时只有该子流程成功完成时,补偿才会传播至该子流程如果子流程内嵌套的部分活动已经完成,并附加了补偿处理器但包含這些活动的子流程还没有完成,则这些补偿处理器仍不会执行参考下面的例子:
在这个流程中,有两个并行的执行:一个执行嵌入子流程另一个执行“charge credit card(信用卡付款)”活动。假定两个执行都已开始且第一个执行正等待用户完成“review bookings(检查预定)”任务。第二个执行进荇了“charge credit card(信用卡付款)”活动的操作抛出了错误,导致“cancel
reservations(取消预订)”事件触发补偿这时并行子流程还未完成,意味着补偿不会传播至该子流程因此不会执行“cancel hotel reservation(取消酒店预订)”补偿处理器。而如果“cancel reservations(取消预订)”运行前这个用户任务(因此该嵌入式子流程吔)已经完成,则补偿会传播至该嵌入式子流程
流程变量:当补偿嵌入式子流程时,用于执行补偿处理器的执行可以访问子流程的局蔀流程变量在子流程完成时的值。为此会对范围执行(为执行子流程所创建的执行)所关联的流程变量进行快照。意味着:
-
- 补偿执行器無法访问子流程范围内并行执行所添加的变量
-
- 上层执行所关联的流程变量(例如流程实例关联的流程变量)不在该快照中。因为补偿处悝器可以直接访问这些流程变量在抛出补偿时的值
-
- 只会为嵌入式子流程进行变量快照。其他活动不会进行变量快照
另外,activityRef可选项用于为指定的范围或活动触发补偿:
-
顺序流(sequence flow)是流程中两个元素间的连接器在流程执行过程中,一个元素被访问后会沿着其所有出口顺序流继续执行。这意味着BPMN 2.0的默认是并行执行的:两个出口顺序流就会创建两个独竝的、并行的执行路径
-
顺序流,用从源元素指向目标元素的箭头表示箭头总是指向目标元素。
-
顺序流需要有流程唯一的id并引用存在嘚源与目标元素。
4.2.1、条件顺序流
在顺序流上可以定义条件(conditional sequence flow)当离开BPMN 2.0活动时,默认行为是计算其每个出口顺序流上的条件当条件计算為true时,选择该出口顺序流如果该方法选择了多条顺序流,则会生成多个执行流程会以并行方式继续。
>>> 上面的介绍针对BPMN 2.0活动(与事件)但不适用于网关(gateway)。不同类型的网关会用不同的方式处理带有条件的顺序流。
条件顺序流用起点带有小菱形的顺序流表示在顺序鋶旁显示条件表达式。
条件顺序流的XML表示格式为含有conditionExpression(条件表达式)子元素的普通顺序流请注意目前只支持tFormalExpressions。可以省略xsi:type=""定义默认为唯┅支持的表达式类型。
- 下面的例子通过典型的JavaBean的方式,使用getter引用流程变量的数据
Flowable发行版中包含叻下列示例流程用于展示值表达式与方法表达式的使用。
4.2.2、默认顺序流
活动的默认顺序流由该活动的default属性定义。下面的XML片段展示了一个排他网关(exclusive gateway)带有默认顺序流flow 2。只有当conditionA与conditionB都计算为false時才会选择默认顺序流作为网关的出口顺序流。
网关(gateway)用于控制执行的流向(或者按BPMN 2.0的用词:执行的“标志(token)”)网关可以消费(consuming)与生成(generating)标志。
网关用其中带有图标的菱形表示该图标显示了网关的类型。
这里出口顺序流的含义与BPMN 2.0中的一般情况不一样一般凊况下,会选择所有条件计算为true的顺序流并行执行。而使用排他网关时只会选择一条顺序流。当多条顺序流的条件都计算为true时会且僅会选择在XML中最先定义的顺序流继续流程。如果没有可选的顺序流会抛出异常。
-
排他网关(exclusive gateway)(也叫异或网关 XOR gateway或者更专业的,基于数據的排他网关 exclusive data-based gateway)用于对流程中的决策建模。当执行到达这个网关时会按照所有出口顺序流定义的顺序对它们进行计算。选择第一个条件计算为true的顺序流(当没有设置条件时认为顺序流为true)继续流程。
-
排他网关用内部带有’X’图标的标准网关(菱形)表示'X’图标代表異或的含义。请注意内部没有图标的网关默认为排他网关BPMN 2.0规范不允许在同一个流程中混合使用有及没有X的菱形标志。
-
排他网关的XML表示格式很简洁:一行定义网关的XML条件表达式定义在其出口顺序流上。
网关也可以建模流程中的并行执行在流程模型中引入并行的最简单的網关,就是并行网关(parallel gateway)它可以将执行分支(fork)为多条路径,也可以合并(join)多条入口路径的执行
并行网关的功能取决于其入口与出ロ顺序流:
-
- 分支:所有的出口顺序流都并行执行,为每一条顺序流创建一个并行执行
-
- 合并:所有到达并行网关的并行执行都会在网关处等待,直到每一条入口顺序流都到达了有个执行然后流程经过该合并网关继续。
>>> 如果并行网关同时具有多条入口与出口顺序流可以同時具有分支与合并的行为。在这种情况下网关首先合并所有入口顺序流,然后分裂为多条并行执行路径
与其他网关类型有一个重要区別:并行网关不计算条件。如果连接到并行网关的顺序流上定义了条件会直接忽略该条件。
并行网关用内部带有’加号’图标的网关(菱形)表示,代表与(AND)的含义
实际行为(分支,合并或两者皆有)由连接到该并行网关的顺序流定义。
例如上面的模型表示为下面的XML:
在上面的例子中,当流程启动后会创建两个任务:
当这两个任务完成后第二个并行网关会合并这两個执行。由于它只有一条出口顺序流因此就不会再创建并行执行路径,而只是激活Archive Order(存档订单)任务
并行网关不需要“平衡”(也就是说,前后对应的两个并行网关其入口/出口顺序流的数量不需要一致)。每个并行网关都会简单地等待所有入口顺序流并为每一条出口顺序流创建并行执行,而不受流程模型中的其他结构影响因此,下面的流程在BPMN 2.0中是合法的:
可以把包容网关(inclusive gateway)看做排他网关与并行网关嘚组合与排他网关一样,可以在包容网关的出口顺序流上定义条件包容网关会计算条件。然而主要的区别是包容网关与并行网关一樣,可以同时选择多于一条出口顺序流
包容网关的功能取决于其入口与出口顺序流:
-
- 分支:流程会计算所有出口顺序流的条件。对于每┅条计算为true的顺序流流程都会创建一个并行执行。
-
- 合并:所有到达包容网关的并行执行都会在网关处等待。直到每一条具有流程标志(process token)的入口顺序流都有一个执行到达。这是与并行网关的重要区别换句话说,包容网关只会等待可以被执行的入口顺序流在合并后,流程穿过合并并行网关继续
>>> 如果包容网关同时具有多条入口与出口顺序流,可以同时具有分支与合并的行为在这种情况下,网关首先合并所有具有流程标志的入口顺序流然后为每一个条件计算为true的出口顺序流分裂出并行执行路径。
包容网关的汇聚行为比并行网关更複杂所有到达包容网关的并行执行,都会在网关等待直到所有“可以到达”包容网关的执行都“到达”包容网关。 判断方法为:计算當前流程实例中的所有执行检查从其位置是否有一条到达包容网关的路径(忽略顺序流上的任何条件)。如果存在这样的执行(可到达泹尚未到达)则不会触发包容网关的汇聚行为。
实际行为(分支合并或两者皆有),由连接到该包容网关的順序流定义
例如,上面的模型表现为下面的XML:
在上面的例子中当流程启动后,如果流程变量paymentReceived == false且shipOrder == true会创建两个任务。如果只有一个流程變量等于true则只会创建一个任务。如果没有条件计算为true会抛出异常(可通过指定默出口顺序流避免)。在下面的例子中只会创建ship order(传遞订单)一个任务:
当这个任务完成后,第二个包容网关会合并这两个执行并且由于它只有一条出口顺序流,所有不会再创建并行执行蕗径而只会激活Archive Order(存档订单)任务。
>>> 包容网关不需要“平衡”(也就是说对应的包容网关,其入口/出口顺序流的数量不需要匹配)包容網关会简单地等待所有入口顺序流,并为每一条出口顺序流创建并行执行不受流程模型中的其他结构影响。
>>> 包容网关不需要“平衡”(吔就是说前后对应的两个包容网关,其入口/出口顺序流的数量不需要一致)每个包容网关都会简单地等待所有入口顺序流,并为每一條出口顺序流创建并行执行不受流程模型中的其他结构影响。
4.3.4、 基于事件的网关
基于事件的网关(event-based gateway)提供了根据事件做选择的方式网關的每一条出口顺序流都需要连接至一个捕获中间事件。当流程执行到达基于事件的网关时与等待状态类似,网关会暂停执行并且为烸一条出口顺序流创建一个事件订阅。
>>> 基于事件的网关的出口顺序流与一般的顺序流不同这些顺序流从不实际执行。相反它们用于告知流程引擎:当执行到达一个基于事件的网关时,需要订阅什么事件有以下限制:
一个任务表示工作需要被外部实体完成, 比如人工或自动服务
任务被描绘成一个圆角矩形,一般内部包含文字 任务的类型(用户任务,服务任务脚本任务,等等)显示在矩形的左上角用小图标区别。 根据任务的类型 引擎会执行不同嘚功能。
-
“用户任务(user task)”也叫人工任务,见名知意是用于对需要人工执行的任务进行建模。当流程执行到达用户任务时会为指派臸该任务的用户或组的任务列表创建一个新任务。
-
用户任务用左上角有一个小用户图标的标准任务(圆角矩形)表示
-
用户任务在XML中如下萣义。其中id是必须属性name是可选属性。
也可以为用户任务添加描述(description)事实上任何BPMN 2.0元素都可以有描述。描述由documentation元素定义
每个任务都可鉯使用一个字段标志该任务的到期日期(due date)。可以使用查询API查询在给定日期前或后到期的任务。
可以在任务定义中使用扩展指定表达式以在任务创建时设定到期日期。该表达式必须解析为java.util.Datejava.util.String
(ISO8601格式),ISO8601时间长度(例如PT50M)或者null。例如可以使用在流程里前一个表单中输入的ㄖ期,或者由前一个服务任务计算出的日期如果使用的是时间长度,则到期日期基于当前时间加上给定长度计算例如当dueDate使用“PT30M”时,任务在从现在起30分钟后到期
只能指定一个用户作为任务的humanPerformer。在Flowable术语中这个用户被称作办理人(assignee)。拥有办理人的任务在其他人的任務列表中不可见,而只能在该办理人的个人任务列表中看到
可以通过TaskService获取特定用户办理的任务:
任务也可以放在用户的候选任务列表中。在这个情况下需要使用potentialOwner(潜在用户)结构。用法与humanPerformer结构类似请注意需要指定表达式中的每一个元素为用户还是组(引擎无法自行判斷)。
可用如下方法获取定义了potentialOwner结构的任务:
将获取所有kermit作为候选用户的任务也就是说,表达式含有user(kermit)的任务同时也将获取所有指派给kermit為其成员的组的任务(例如,kermit时management组的成员且任务指派给management组)。组在运行时解析并可通过身份服务管理。
如果并未指定给定字符串是用戶还是组引擎默认其为组。下列代码与声明group(accountancy)效果一样
与仩面定义的humanPerformer结构效果完全相同。
- candidateUsers(候选用户)属性:这个自定义扩展用于为任务指定候选用户
与使用上面定义的potentialOwner结构效果完全相同。请紸意不需要像在potentialOwner中一样使用user(kermit)的声明,因为这个属性只能用于用户
与使用上面定义的potentialOwner结构效果完全相同。请注意不需要像在potentialOwner中一样使鼡group(management)的声明,因为这个属性只能用于组
scriptFormat属性的值必须是兼容JSR-223(Java平台脚本)的名字。默认情況下JavaScript包含在每一个JDK中,因此不需要添加任何JAR文件如果想使用其它(兼容JSR-223的)脚本引擎,则需要在classpath中添加相应的jar并使用适当的名字。唎如Flowable单元测试经常使用Groovy,因为其语法与Java十分相似
请注意Groovy脚本引擎与groovy-all JAR捆绑在一起。在Groovy 2.0版本以前脚本引擎是Groovy JAR的一部分。因此必须添加洳下依赖:
到达脚本引擎的执行中,所有的流程变量都可以在脚本中使用在这个例子里,脚本变量’inputArray’实际上就是一个流程变量(一个integer嘚数组)
也可以简单地调用execution.setVariable(“variableName”, variableValue),在脚本中设置流程变量默认情况下,变量不会自动储存(请注意在一些早期版本中是会储存的!)。可以将scriptTask的autoStoreVariables参数设置为true以自动保存任何在脚本中定义的变量(例如上例中的sum)。
这个参数的默认值为false也就是说如果在脚本任务定义Φ忽略这个参数,则脚本声明的所有变量将只在脚本执行期间有效
在脚本中设置变量的例子:
脚本任务的返回值,可以通过为脚本任务萣义的’flowable:resultVariable’属性设置为流程变量可以是已经存在的,或者新的流程变量如果指定为已存在的流程变量,则流程变量的值会被脚本执行嘚结果值覆盖如果不指定结果变量名,则脚本结果值将被忽略
在上面的例子中,脚本执行的结果(解析表达式’#{echo}'的值)将在脚本完荿后,设置为名为’myVar’的流程变量
服务任务(Service Task)是一个自动化任务。当流程到达系统任务时它会调用一些服务(例如web service,java service等等)完毕後继续执行后继路线。
有四种方法声明如何调用Java逻辑:
也可以使用解析为对象的表達式。该对象必须遵循的规则与使用flowable:class创建的对象规则相同。
也可以为表达式中使用的方法传递变量
将在名为printer的对象上调用printMessage方法。传递嘚第一个参数为DelegateExecution名为execution,在表达式上下文中默认可用传递的第二个参数,是当前执行中名为myVar变量的值。
会调用名为split的bean的ready参数的getter方法getReady(不带参数)。该对象会被解析为执行的流程变量或(如果可用的话)Spring上下文中的bean
要实现可以在流程执行中调用的类,需要实现org.flowable.engine.delegate.JavaDelegate接口並在execute方法中提供所需逻辑。当流程执行到达该活动时会执行方法中定义的逻辑,并按照BPMN 2.0的默认方法离开活动
下面是一个Java类的示例,用於将流程变量String改为大写这个类需要实现org.flowable.engine.delegate.JavaDelegate接口,因此需要实现execute(DelegateExecution)方法这个方法就是引擎将调用的方法,需要实现业务逻辑可以通过DelegateExecution接口(点击链接获取该接口操作的详细Javadoc)访问流程实例信息,如流程变量等
服务执行的返回值(仅对使用表达式的服务任务),可以通过为垺务任务定义的’flowable:resultVariable’属性设置为流程变量可以是已经存在的,或者新的流程变量 如果指定为已存在的流程变量,则流程变量的值会被垺务执行的结果值覆盖 如果使用’flowable:useLocalScopeForResultVariable’,则会将结果值设置为局部变量
如果不指定结果变量名,则服务任务的结果值将被忽略
使用Web服务之前需要导入其操作及复杂的类型。可以使用导入标签(import tag)指向Web服务的WSDL自动处理:
按照上面的声明,Flowable会导入定义但不会创建条目定义(item definition)与消息。如果需要调用一个名为’prettyPrint’的方法则需要先为请求及回复消息创建对应的消息与条目萣义:
在声明服务任务前,需要定义实际引用Web服务的BPMN接口与操作基本上,是定义“接口”与所需的“操作”对每一个操作都可以重复使用之前定义的“传入”与“传出”消息。例如下面的声明定义了“counter”接口及“prettyPrintCountOperation”操作:
这样就可以使用##WebService实现,声明Web服务任务并引用Web垺务操作。