前言:会签和加签是常见审批流程模式,在引擎中,对这两种流程模式做了分别定义和实现,其中也用到了Workflow Pattern的Multiple Instance(多实例) 。
1. 会签和加签的定义
会签即当前运行节点有多人进行办理,或者可以说当前节点存在多个办理任务。这些任务可以分为两种情况来运行:一种是按顺序进行办理,即串行会签;一种是同时进行办理,即并行会签。
串行会签和并行会签都可以进行通过率的设置,串行会签和并行会签中通过率是按照通过人数或者百分比进行设置,达到通过人数(或者百分比)则该节点办理完成,进入下一个节点。
加签即当前办理节点中需要另外办理人加入时的操作。加签的方式分为三种:前加签、后加签和并行加签。
前加签:即新加入的办理人在发起加签的办理人之前办理。
后加签:即新加入的办理人在发起加签的办理人之后办理。
并行加签:即新加入的办理人和发起加签的办理人同时办理。
前加签和后加签均属于串行加签,按顺序进行办理。在加签中仍然可以设置通过率,由于加签是动态生成任务和节点,所以加签的通过率也需要动态传入。串行加签和并行加签的通过率和会签通过率的设置方式相同。
2. Multiple Instance多实例模式
多实例模式是针对主节点有多个实例节点运行的场景,在会签和加签审批流中,引擎组件采用多实例模式。
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. 致谢
本文内容由小组成员青文完成,谢谢她认真细致的工作,给大家奉献了详细的文字内容和代码片段。