Slickflow.NET 开源工作流引擎基础介绍(五) -- 会签加签高级特性介绍

时间:2022-03-13 01:15:19

前言:会签和加签是常见审批流程模式,在引擎中,对这两种流程模式做了分别定义和实现,其中也用到了Workflow Pattern的Multiple Instance(多实例) 。

1. 会签和加签的定义

会签即当前运行节点有多人进行办理,或者可以说当前节点存在多个办理任务。这些任务可以分为两种情况来运行:一种是按顺序进行办理,即串行会签;一种是同时进行办理,即并行会签。

串行会签和并行会签都可以进行通过率的设置,串行会签和并行会签中通过率是按照通过人数或者百分比进行设置,达到通过人数(或者百分比)则该节点办理完成,进入下一个节点。

加签即当前办理节点中需要另外办理人加入时的操作。加签的方式分为三种:前加签、后加签和并行加签。

前加签:即新加入的办理人在发起加签的办理人之前办理。

后加签:即新加入的办理人在发起加签的办理人之后办理。

并行加签:即新加入的办理人和发起加签的办理人同时办理。

前加签和后加签均属于串行加签,按顺序进行办理。在加签中仍然可以设置通过率,由于加签是动态生成任务和节点,所以加签的通过率也需要动态传入。串行加签和并行加签的通过率和会签通过率的设置方式相同。

2. Multiple Instance多实例模式

多实例模式是针对主节点有多个实例节点运行的场景,在会签和加签审批流中,引擎组件采用多实例模式。

Slickflow.NET 开源工作流引擎基础介绍(五) -- 会签加签高级特性介绍

3. 会签加签使用说明

 3.1 会签

 3.1.1 流程定义中

<Activity name="任务" id="bb035582-9b73-460a-eaa5-bb3a786f9d3e" code="">

<Description>任务</Description>

<ActivityType  type="TaskNode"  complexType="SignTogether"   mergeType="Parallel"  completeOrder="2"  compareType=”count”/>

……..

</Activity>

说明:

complexType:会签SignTogether或者加签SignForward模式

mergeType:并行Parallel或者串行Sequence模式

compareType:通过人数count或者百分比percentage

completeOrder:通过率,可以是通过率或百分比,由compareType决定

3.1.2 流程转交时对下一步人员进行赋值

(1)    为runner的NextActivityPerformers赋值。

接收人Performers的JSON格式为:{“ActivityGUID”,[{“UserID”:”UserName”}]}。

假设下一步人员有两个,那么以上格式可替换为:{“072af8c3-482a-4b1c-890b-685ce2fcc75d”,[{“01”:”张三”},{“02”:”李四”}]}

将以上结果转换为字典Dictionary<string, PerformerList>并赋值给WfAppRunner对象的NextActivityPerformers属性。例如:

PerformerList p1 = new PerformerList{UserID=”01”,UserName=”张三”};

PerformerList p2 = new PerformerList{UserID=”02”,UserName=”李四”};

Dictionary<string, PerformerList> dict = new Dictionary<string, PerformerList>();

dict.Add(“072af8c3-482a-4b1c-890b-685ce2fcc75d”,p1);

dict.Add(“072af8c3-482a-4b1c-890b-685ce2fcc75d”,p2);

WfAppRunner runner = new WfAppRunner();

runner.NextActivityPerformers= dict;

(2)调用引擎RunProcessApp(WfAppRunner runner)方法送往下一步

串行会签时引擎会按顺序生成办理任务,未办理的人员为挂起状态,待上一步人员办理完成后修改为办理状态,依次类推。

并行会签时引擎生成多人的办理任务,并且状态都为未接收状态,所有办理人员可以同时办理。

 3.2 加签

 3.2.1 流程定义

<Activity name="任务" id="bb035582-9b73-460a-eaa5-bb3a786f9d3e" code="">

<Description>任务</Description>

<ActivityType  type="TaskNode"  complextype="SignForward" />

……..

</Activity>

3.2.3 发起加签

(1)选择加签人员

当该节点处于运行状态时,可以选择加签人员并设置加签通过率进行发起加签。

选择加签人员后,对WfAppRunner对象的NextActivityPerformers属性进行赋值,格式同会签格式。

Runner中DynamicVariables为动态变量,可将通过率赋值给它,比如:

DynamicVariables: {

"SignForwardType":SignForwardBefore,

“SignForwardCompleteOrder”:2

}

参数说明:

SignForwardType:加签通过类型,可分为SignForwardBefore前加签、SignForwardBehind后加签、SignForwardParallel并行加签

SignForwardCompleteOrder:加签通过率,串行加签为通过人数,并行加签为通过百分比

(2)调用引擎SignForwardProcess(WfAppRunner  runner)发起加签

WfExecutedResult runAppResult = _workflowService.SignForwardProcess(runner);

4. 总结

会签和加签的实现是作为引擎组件的高级特性,在解决多人审批场景时,主要涉及到会(加)签的不同子类别,通过率设置等选项。作为企业版的核心功能,为企业客户集成引擎组件,带来了实质的便利。

5. 致谢

本文内容由小组成员青文完成,谢谢她认真细致的工作,给大家奉献了详细的文字内容和代码片段。