NetBPM工作流的一个示例－请假审批

最新推荐文章于 2023-01-17 14:37:16 发布

weixin_30663391

最新推荐文章于 2023-01-17 14:37:16 发布

阅读量261

点赞数

CC 4.0 BY-SA版权

原文链接：http://www.cnblogs.com/LuBen/archive/2007/08/12/852010.html

本文介绍了一个基于NetBPM工作流引擎的请假审批流程示例，详细展示了processdefinition.xml和webinterface.xml的配置方法，以及关键动态委托类的设计思路。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

NetBPM工作流的一个示例：请假审批

Made by LuBen:2007年8月12日

请假流程描述

流程图：

假设：公司有两级领导，一级为主管(Chief),一级为老板（Boss）,我们这里只是一个模拟，当然现实生活中情况比这个更加复杂;-)

描述：

在某公司中，部门员工休假需要主管（Chief）的批准。
如果休假天数大于10天，则在部门主管同意后，还必须老板（Boss）批准。
如果是部门主管请假则直接提交老板批准。
在休假被批准之前，申请人可以撤销休假申请。
申请批准后，对休假天数进行修改（也可以是其他业务数据处理）。每次休假申请结束之后，不管通过未通过或是否取消，都必须记录下来。
流程结束时，系统要把请假的结果信息Email给申请人。
对于大于10天的申请，如果部门主管已批准同意而上级主管还未批准，这时申请人撤销申请后，系统应发Email通知部门主管申请已撤销。

流程定义之processdefinition.xml

processdefinition.xml
1

<?xml version="1.0"?>
2

<!-- NOTE：在定义流程时，建议先画出流程图，然后再来定义，这样思维清晰，也不易于出错
3

关于processdefiniton.xml如何定义，请严格按照nPdl规定 -->
4

<process-definition>
5

7

8

9

<name>请假DEMO</name>
10

<description>该流程模拟公司的请假流程, Made By LuBen</description>
11

<responsible>ae</responsible>
12

14

15

16

<start-state name="start leave request">
17

<description>提交请假单</description>
18

19

<role>requester</role>
20

<!-- 在这里定义start-state的field，它表示该filed相关联的属性，并且在该state，它对属性的访问权利。
21

如果需要定义其在web表单上的操作界面，如何进行web表单显示等，需要在webinterface.xml文件对应节点补充该field -->
22

<field attribute="start date" access="write-only-required" />
23

<field attribute="end date" access="write-only-required" />
24

<field attribute="leave days" access="write-only-required" />
25

<field attribute="comment" access="write-only" />
26

<transition to="Is Cancel Fork" />
27

</start-state>
28

30

<end-state name="end" />
31

34

35

36

37

39

<action event="process-instance-end"
40

handler="NetBpm.Example.LeaveOfAbsence.EmailAction, NetBpm.Example.LeaveOfAbsence" on-exception="log">
41

<!--定义action参数，供委托类实例化类调用方法时获取使用。如这里的EmailAction的run方法发送邮件，需要知道发给谁，邮件标题等等，那么
42

参数可以提供辅助-->
43

<parameter name="to">previousActor</parameter>
44

<parameter name="subject">您提交了请假申请</parameter>
45

<parameter name="message">you requested a holiday from ${start date} to ${end date} with comment ${comment}</parameter>
46

</action>
47

48

<action event="process-instance-end"
49

handler="NetBpm.Example.LeaveOfAbsence.LogLeaveInfoAction, NetBpm.Example.LeaveOfAbsence" on-exception="log">
50

<parameter name="LogInfo">记录请假日志? :) </parameter>
51

</action>
52

54

55

56

57

58

<attribute name="requester" type="actor" />
59

<attribute name="chief" type="actor" />
60

<attribute name="boss" type="actor" />
61

63

<attribute name="start date" type="date" />
64

<attribute name="end date" type="date" />
65

<attribute name="leave days" type="integer" />
66

<attribute name="comment" type="text" initial-value="请假理由或者备注" />
67

<attribute name="Chief evaluation result" type="evaluation" />
68

<attribute name="Boss evaluation result" type="evaluation" />
69

71

72

<attribute name="RunTrace" type="text" />
73

74

<attribute name="ToUserEmailSubject" type="text" />
75

77

78

79

80

<!-- 定义decision节点，从decision可以流出多条边（transition），这些边可以目的地相同，也可以不同。
82

如下面，虽然decision分出了3条供选择的边，但是边的目的地都是end节点，只是边的名称不同 -->
83

<decision name="Decide Which Action"
84

handler="NetBpm.Example.LeaveOfAbsence.WhichWayDecision, NetBpm.Example.LeaveOfAbsence">
85

<parameter name="attribute">RunTrace</parameter>
86

<transition name="approve" to="end">
87

<action event="transition" handler="NetBpm.Example.LeaveOfAbsence.AutoSetAttributesAction, NetBpm.Example.LeaveOfAbsence" on-exception="log">
88

<parameter name="attribute">ToUserEmailSubject</parameter>
89

<parameter name="setValue">您的请假申请已经被批准 holiday from ${start date} to ${end date} with comment ${comment}</parameter>
90

</action>
91

</transition>
92

<transition name="disapprove" to="end" >
94

<action event="transition" handler="NetBpm.Example.LeaveOfAbsence.AutoSetAttributesAction, NetBpm.Example.LeaveOfAbsence" on-exception="log">
95

<parameter name="attribute">ToUserEmailSubject</parameter>
96

<parameter name="setValue">您的请假申请没有获得批准, holiday from ${start date} to ${end date} with comment ${comment}</parameter>
97

</action>
98

</transition>
99

100

<transition name="requestercancel" to="end">
101

<action event="transition" handler="NetBpm.Example.LeaveOfAbsence.AutoSetAttributesAction, NetBpm.Example.LeaveOfAbsence" on-exception="log">
102

<parameter name="attribute">ToUserEmailSubject</parameter>
103

<parameter name="setValue">您取消了请假申请, holiday from ${start date} to ${end date} with comment ${comment}</parameter>
104

</action>
105

106

<action event="transition" handler="NetBpm.Example.LeaveOfAbsence.EmailChiefAction, NetBpm.Example.LeaveOfAbsence" on-exception="log">
107

108

<parameter name="to">role(chief)</parameter>
109

110

<parameter name="subject">请假申请被取消啦</parameter>
111

<parameter name="message"> requested a holiday from ${start date} to ${end date} with comment ${comment}</parameter>
112

</action>
113

</transition>
114

</decision>
115

116

117

118

119

120

121

<concurrent-block>
122

123

<fork name="Is Cancel Fork">
124

<transition name="CancelLeaveRequest" to="Request Cancel" />
125

<transition name="evaluation" to="IsChiefDecision" />
126

</fork>
127

128

<!-- 定义join，此处定义了joinhandler，则当有forked flow到达join时，将根据该委托判断是否要激活父flow，
129

若没有定义joinhandler，那么将按照默认行为（AndJoin委托类，也就是所有forked flow都汇聚到达Join才激活父flow）执行 -->
130

<join name="join before decided" handler="NetBpm.Example.LeaveOfAbsence.AnyOneJoin, NetBpm.Example.LeaveOfAbsence">
131

<transition to="Decide Which Action" />
132

</join>
133

134

<activity-state name="Request Cancel">
135

<description>在请假申请被最终审批前, 您可以在这里取消申请.</description>
136

<role>requester</role>
137

138

<field attribute="start date" access="read-only" />
139

<field attribute="end date" access="read-only" />
140

141

<!--eg。请假理由备注先不被看到
142

<field attribute="leave days" access="read-only" />
143

<field attribute="comment" access="read-only" />
144

-->
145

<action event="perform-of-activity" handler="NetBpm.Example.LeaveOfAbsence.AutoSetAttributesAction, NetBpm.Example.LeaveOfAbsence" on-exception="log">
146

<parameter name="attribute">RunTrace</parameter>
147

<parameter name="setValue">requestercancel</parameter>
148

</action>
149

<transition to="join before decided" />
150

</activity-state>
151

152

<decision name="IsChiefDecision" handler="NetBpm.Example.LeaveOfAbsence.IsInRoleDecision, NetBpm.Example.LeaveOfAbsence">
153

<parameter name="checkrole">chief</parameter>
154

<transition name="isChief" to="BossApprove" />
155

<transition name="isNotChief" to="ChiefApprove" />
156

</decision>
157

158

<activity-state name="ChiefApprove">
159

<description>您需要在这里对该请假单进行审批</description>
160

<assignment handler="NetBpm.Example.LeaveOfAbsence.AssignmentExpressionResolver, NetBpm.Example.LeaveOfAbsence">
161

<parameter name="expression" >role(requester)->group(hierarchy)->role(chief)</parameter>
162

</assignment>
163

<role>chief</role>
164

<field attribute="requester" access="read-only" />
165

<field attribute="start date" access="read-only" />
166

<field attribute="end date" access="read-only" />
167

<field attribute="Chief evaluation result" access="write-only" />
168

<action event="perform-of-activity" handler="NetBpm.Example.LeaveOfAbsence.EvluationResultAction, NetBpm.Example.LeaveOfAbsence" on-exception="log">
169

<parameter name="attribute">RunTrace</parameter>
170

<parameter name="setValueAttribute">Chief evaluation result</parameter>
171

</action>
172

<transition to="IsMoreTenDays" />
173

</activity-state>
174

175

<activity-state name="BossApprove">
176

<description>您需要在这里对该请假单进行审批</description>
177

<assignment handler="NetBpm.Example.LeaveOfAbsence.AssignmentExpressionResolver, NetBpm.Example.LeaveOfAbsence">
178

<parameter name="expression" >role(requester)->group(hierarchy)->role(boss)</parameter>
179

</assignment>
180

<role>boss</role>
181

<field attribute="requester" access="read-only" />
182

<field attribute="chief" access="read-only" />
183

<field attribute="start date" access="read-only" />
184

<field attribute="end date" access="read-only" />
185

<!-- 理论上Boss不需要看到主管是否同意,因为不同意就不会到他这里来
186

<field attribute="leave days" access="read-only" />
187

<field attribute="Chief evaluation result" access="read-only" />
188

-->
189

<field attribute="Boss evaluation result" access="write-only" />
190

<action event="perform-of-activity" handler="NetBpm.Example.LeaveOfAbsence.EvluationResultAction, NetBpm.Example.LeaveOfAbsence" on-exception="log">
191

<parameter name="attribute">RunTrace</parameter>
192

<parameter name="setValueAttribute">Boss evaluation result</parameter>
193

</action>
194

<transition to="join before decided" />
195

</activity-state>
196

197

<decision name="IsMoreTenDays" handler="NetBpm.Example.LeaveOfAbsence.IsMoreOrLessDecision, NetBpm.Example.LeaveOfAbsence">
198

<parameter name="attribute">leave days</parameter>
199

<parameter name="dividingDays">10</parameter>
200

<!--考虑扩展,形成对数值比较类的通用 <parameter name="datatype">float</parameter>
201

<parameter name="compareType">More</parameter> -->
202

<transition name="IsMore" to="BossApprove" />
203

<transition name="IsnotMore" to="join before decided" />
204

</decision>
205

206

</concurrent-block>
207

208

</process-definition>
209

流程定义之webinterface.xml

webinterface.xml
1

<?xml version="1.0"?>
2

<!-- 关于webinterface.xml如何定义，请严格按照nPdl规定
4

只有需要人操作的节点, 也就是activity-state(包括StartState), 在该文件中才在需要进行定义，指定如何显示web表单等 -->
5

<web-interface>
6

8

9

10

11

<image name="web/leavedemo.gif" mime-type="image/gif" width="510" height="560" />
12

14

15

16

<activity-state name="start leave request">
17

18

<image-coordinates>
19

<x1>285</x1>
20

<y1>54</y1>
21

<x2>307</x2>
22

<y2>76</y2>
23

</image-coordinates>
24

25

<field attribute="start date">
26

<name>开始时间</name>
27

<description>在此处填写您想要在何时开始请假</description>
28

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.DateInput, NetBpm" >
29

<parameter name="dateFormat">dd/MM/yyyy</parameter>
30

</htmlformatter>
31

</field>
32

<field attribute="end date">
33

<name>结束时间</name>
34

<description>在此处填写您想要在何时结束请假</description>
35

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.DateInput, NetBpm" >
36

<parameter name="dateFormat">dd/MM/yyyy</parameter>
37

</htmlformatter>
38

</field>
39

<field attribute="leave days">
40

<name>请假天数(单位:天)</name>
41

<description>在此处填写您请假的天数(以后改进为系统自动计算)</description>
42

<htmlformatter class="NetBpm.Example.LeaveOfAbsence.TextIntergerInput, NetBpm.Example.LeaveOfAbsence" >
43

</htmlformatter>
44

</field>
45

<field attribute="comment">
46

<name>请假理由</name>
47

<description>在此处填写您请假的理由或者其他需要说明的信息</description>
48

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.TextAreaInput, NetBpm">
49

<parameter name="rows">5</parameter>
50

<parameter name="cols">20</parameter>
51

</htmlformatter>
52

</field>
53

</activity-state>
54

<activity-state name="Request Cancel">
56

<image-coordinates>
57

<x1>287</x1>
58

<y1>146</y1>
59

<x2>420</x2>
60

<y2>178</y2>
61

</image-coordinates>
62

<field attribute="start date">
63

<name>开始时间</name>
64

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.DateLabel, NetBpm" >
65

<parameter name="dateFormat">dd/MM/yyyy</parameter>
66

</htmlformatter>
67

</field>
68

<field attribute="end date">
69

<name>结束时间</name>
70

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.DateLabel, NetBpm" >
71

<parameter name="dateFormat">dd/MM/yyyy</parameter>
72

</htmlformatter>
73

</field>
74

</activity-state>
76

<activity-state name="ChiefApprove">
78

<image-coordinates>
79

<x1>173</x1>
80

<y1>220</y1>
81

<x2>295</x2>
82

<y2>253</y2>
83

</image-coordinates>
84

<field attribute="requester">
85

<name>申请人</name>
86

<description>提交请假申请的员工</description>
87

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.PersonLabel, NetBpm" />
88

</field>
89

<field attribute="start date">
90

<name>开始时间</name>
91

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.DateLabel, NetBpm" >
92

<parameter name="dateFormat">dd/MM/yyyy</parameter>
93

</htmlformatter>
94

</field>
95

<field attribute="end date">
96

<name>结束时间</name>
97

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.DateLabel, NetBpm" >
98

<parameter name="dateFormat">dd/MM/yyyy</parameter>
99

</htmlformatter>
100

</field>
101

<field attribute="Chief evaluation result">
102

<name>主管审批意见</name>
103

<description>请审批该员工的请假单</description>
104

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.EvaluationInput" />
105

</field>
106

</activity-state>
107

108

<activity-state name="BossApprove">
109

<image-coordinates>
110

<x1>101</x1>
111

<y1>356</y1>
112

<x2>218</x2>
113

<y2>390</y2>
114

</image-coordinates>
115

<field attribute="requester">
116

<name>申请人</name>
117

<description>提交请假申请的员工</description>
118

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.PersonLabel, NetBpm" />
119

</field>
120

<field attribute="chief">
121

<name>主管审批</name>
122

<description>同意该员工请假的主管领导</description>
123

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.PersonLabel, NetBpm" />
124

</field>
125

<field attribute="start date">
126

<name>开始时间</name>
127

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.DateLabel, NetBpm" >
128

<parameter name="dateFormat">dd/MM/yyyy</parameter>
129

</htmlformatter>
130

</field>
131

<field attribute="end date">
132

<name>结束时间</name>
133

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.DateLabel, NetBpm" >
134

<parameter name="dateFormat">dd/MM/yyyy</parameter>
135

</htmlformatter>
136

</field>
137

<field attribute="Boss evaluation result">
138

<name>老板审批意见</name>
139

<description>该员工请假天数大于10天, 请您审批该员工的请假单</description>
140

<htmlformatter class="NetBpm.Workflow.Delegation.Impl.Htmlformatter.EvaluationInput" />
141

</field>
142

</activity-state>
143

</web-interface>
144

流程定义之动态委托类
委托类包含在lib文件夹下的程序集中。因为委托类数目众多，这里仅贴出几个典型的委托类, 其源码工程若需要请看这里：
1. NetBpm.Example.LeaveOfAbsence.AutoSetAttributionsAction:该委托类设计为一个通用委托类，这里用来设置表识属性，如流程经过用户取消请假路径，则把RunTrace属性设置为requestercancel，供WhichWayDicision作判断用。

AutoSetAttributesAction
1

using System;
2

using System.Collections;
3

using log4net;
4

using NetBpm.Workflow.Organisation;
5

using NetBpm.Workflow.Delegation;
6

using NetBpm.Workflow.Delegation.Impl;
7

namespace NetBpm.Example.LeaveOfAbsence
9

{
10

/**//// <summary>
11

/// 通用Action类, 改类用来设置属性, 把值(action参数setValue)设置给属性(action参数attribute)
12

/// by Luben
13

/// </summary>
14

public class AutoSetAttributesAction : IActionHandler
15

{
16

private static readonly ILog log = LogManager.GetLogger(typeof(AutoSetAttributesAction));
17

private static readonly AttributeExpressionResolver _attributeExpressionResolver;
18

static AutoSetAttributesAction()
20

{
21

_attributeExpressionResolver = AttributeExpressionResolver.Instance;
22

}
23

public void Run(IActionContext actionContext)
25

{
26

IDictionary configuration = actionContext.GetConfiguration();
27

String setAttributeName = (String)configuration["attribute"];
29

String setValue = (String)configuration["setValue"];
30

setValue = _attributeExpressionResolver.ResolveAttributeExpression(setValue, actionContext);
31

actionContext.SetAttribute(setAttributeName, setValue);
33

log.Info("设置属性" + setAttributeName + "的值为:" + setValue);
34

}
35

}
36

}
37

2. NetBpm.Example.LeaveOfAbsence.AnyOneJoin: 该委托主要用来设置激活父flow机制，这里是只要任何一条路径到达了join，则激活父flow，流程往下流。

AnyOneJoin
1

using log4net;
2

using NetBpm.Workflow.Execution.Impl;
3

using System.Collections;
4

using NetBpm.Workflow.Delegation;
5

using Nullables;
6

namespace NetBpm.Example.LeaveOfAbsence
8

{
9

/**//// <summary>
10

/// 只要任何一个Subflow到达了该Join, 就激活Parent flow
11

/// by Luben
12

/// </summary>
13

public class AnyOneJoin : IJoinHandler
14

{
15

private static readonly ILog log = LogManager.GetLogger(typeof(AnyOneJoin));
16

public bool Join(IJoinContext joinContext)
18

{
19

bool reactivateParent = true;
20

log.Debug("flow " + joinContext.GetFlow().Name + " is joining : " + reactivateParent);
22

// 取消其他并行的flow。这里存在一个同步问题，如果此时在flow的执行者正在performacitivity，那么要考虑flow的锁定
24

IEnumerator iter = joinContext.GetOtherActiveConcurrentFlows().GetEnumerator();
25

while (iter.MoveNext())
26

{
27

FlowImpl concurrentFlow = (FlowImpl)iter.Current;
28

concurrentFlow.ActorId = null;
29

concurrentFlow.EndNullable = System.DateTime.Now;
30

}
31

return reactivateParent;
33

}
34

}
35

}
36

3. NetBpm.Example.LeaveOfAbsence.WhichWayDecision:该委托根据流程实际流过路径，根据标识属性RunTrace等进行走哪条边的抉择，如注释。

WhichWayDecision
1

using System;
2

using NetBpm.Workflow.Delegation;
3

namespace NetBpm.Example.LeaveOfAbsence
6

{
7

/**//// <summary>
8

/// 根据流程走的路径,
9

/// 1)“主管或者老板批准”－‘approve’：修改员工休假的总天数，设定发给用户E-Mail的信息。
10

/// 2)“主管或者老板否决”-“disapprove”：设定发给用户E－Mail的信息。
11

/// 3)“撤销”-"cancel"－设定发给用户E－Mail的信息。如果主管批准，要发给主管消息说明已经撤销。
12

/// 判断走哪一条路
13

/// by LuBen
14

/// </summary>
15

public class WhichWayDecision : IDecisionHandler
16

{
17

public String Decide(IDecisionContext decisionContext)
18

{
19

// 默认为apprvoe
20

String transitionName = "approve";
21

// runtrace是表示属性，在前面的流过的路径action中被设置
23

String runtrace = (String)decisionContext.GetAttribute("RunTrace");
24

if (runtrace.IndexOf("disapprove") != -1)
26

{
27

transitionName = "disapprove";
28

}
29

else if (runtrace.Equals("requestercancel"))
30

{
31

transitionName = "requestercancel";
32

}
33

return transitionName;
34

}
35

}
36

}
37

后记

本文仅仅是一个示例，给大家提供一个运用nPdl定义NetBPM流程的参考，如果要把该流程投入现实中使用显然还需要做很多优化。该示例更多的是给大家展示流程定义中action可以定义多个, decision出来的transition可以到达同一条目的节点但名字却不一样等等. 示例中委托类的耦合性太高, 很多地方并不需要那样做, 如一个decision里面进行了2个判断: 判断是否大于10天, 判断是否审批同意, 这个完全可以拆分为两个独立的decision来做. 委托类设计成为高度可重用的, 耦合性低的通用类, 才是我们的目标.

待写：NetBPM实现会签；NetBPM Q&A（不断更新）

转载于:https://www.cnblogs.com/LuBen/archive/2007/08/12/852010.html