转载注明出处： http://www.cnblogs.com/anbylau2130/p/3877983.html

原文： 请假示例



流程定义包源码下载(注：par包就是zip格式压缩包)。原文地址：http://www.cnblogs.com/LuBen/archive/2007/08/11/852010.html（转载请保留）请假流程描述流程图： 假设：公司有两级领导，一级为主管(Chief),一级为老板（Boss）,我们这里只是一个模拟，当然现实生活中情况比这个更加复杂;-)描述：在某公司中，部门员工休假需要主管（Chief）的批准。如果休假天数大于10天，则 在部门主管同意后，还必须老板（Boss）批准。如果是部门主管请假则直接提交老板批准。在休假被批准之前，申请人可以撤销休假申请。申请批准后，对休假天数进行修改（也可以是其他业务数据处理）。 每次休假申请结束之后，不管通过未通过或是否取消，都必须记录下来。流程结束时，系统要把请假的结果信息Email给申请人。对于大于10天的申请，如果部门主管已批准同意而上级主管还未批准，这时申请人撤销申请后，系统应发Email通知部门主管申请已撤销。流程定义之processdefinition.xml   1<?xml version="1.0"?>  2<!-- NOTE：在定义流程时，建议先画出流程图，然后再来定义，这样思维清晰，也不易于出错  3    关于processdefiniton.xml如何定义，请严格按照nPdl规定 -->  4<process-definition>  5  6  <!-- =================================== -->  7  <!-- == PROCESS DEFINITION PROPERTIES == -->  8  <!-- =================================== -->    9  <name>请假DEMO</name> 10  <description>该流程模拟公司的请假流程, Made By LuBen</description> 11  <responsible>ae</responsible> 12 13  <!-- ====================== --> 14  <!-- == START & ENDSTATE == --> 15  <!-- ====================== --> 16  <start-state name="start leave request"> 17    <description>提交请假单</description> 18    <!-- 定义了role，引擎在该start-state节点执行时，就会把执行者信息赋值给角色对应的属性“requester” --> 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   29  <!-- 结束节点除名称外不要定义其他--> 30  <end-state name="end" /> 31 32 33  <!-- ====================== --> 34  <!-- ==      Actions     == --> 35  <!-- ====================== --> 36  <!-- 解释：这里定义process-definition节点的action，有效的事件类型为：process-instance-start, process-instance-end and process-instance-cancel --> 37   38  <!-- 此处具体为：在流程结束的时候, 发送E－Mail消息给申请者，记录请假日志 -->     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    <!-- 此处具体为：在流程结束的时候记录请假日志, 此处Log模拟 注意：每个节点可以定义多个action --> 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 53  <!-- ================ --> 54  <!-- == ATTRIBUTES == --> 55  <!-- ================ --> 56  <!-- 解释：定义属性值及其序列化方式。属性值一般包括3类 --> 57  <!-- one:角色对应的属性 --> 58  <attribute name="requester" type="actor" /> 59  <attribute name="chief" type="actor" /> 60  <attribute name="boss" type="actor" /> 61   62  <!-- two:所有acitivity-state(包括start-state)处需要更新的属性，和用户表单内容对应 --> 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   70  <!-- three:标识属性，该属性不会在web界面上体现，主来用来存储流程标识信息，供后面的逻辑处理使用 --> 71  <!-- 该属性不会在界面上呈现, 在具体流程路径中被设置以决定Decide Which Action如何走 --> 72  <attribute name="RunTrace" type="text" /> 73  <!-- 该属性不会在界面上呈现, 该属性被用来设置流程结束将要发送给用户的邮件信息(邮件标题, 如果需要邮件内容可扩展) --> 74  <attribute name="ToUserEmailSubject" type="text" /> 75 76  <!-- =========== --> 77  <!-- == NODES == --> 78  <!-- =========== --> 79  <!-- 定义流程包含的所有节点 --> 80 81  <!-- 定义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 93    <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> 99100    <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        <!--- action的参数只能有3个, 切记切记, 调试的时候搞晕了-->108        <parameter name="to">role(chief)</parameter>109        <!--<parameter name="cancelMan">previousActor</parameter> -->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>  115116  117  <!-- ====================== -->118  <!-- == CONCURRENT BLOCK == -->119  <!-- ====================== -->120  <!-- 解释：定义并发块，concurrent-block一定包括一个fork，一个join，且边不可越出其界。concurrent-block是可以嵌套的 -->121  <concurrent-block>122    <!-- 定义fork，若没有定义forkhandler，那么其在fork flow时将按照默认行为执行 -->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>133134    <activity-state name="Request Cancel">135      <description>在请假申请被最终审批前, 您可以在这里取消申请.</description>136      <role>requester</role>137      <!-- fields are optional. they limit the access to attributes in an activity -->138      <field attribute="start date"        access="read-only" />139      <field attribute="end date"          access="read-only" />140141        <!--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>151152    <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>157158    <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>174175    <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>196197    <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>205206  </concurrent-block>207  208</process-definition>209流程定义之webinterface.xml   1<?xml version="1.0"?>  2  3<!-- 关于webinterface.xml如何定义，请严格按照nPdl规定  4     只有需要人操作的节点, 也就是activity-state(包括StartState), 在该文件中才在需要进行定义，指定如何显示web表单等 -->  5<web-interface>  6    7  <!-- ==================== -->  8  <!-- == PROCESS IMAGE  == -->  9  <!-- ==================== --> 10  <!-- 定义该流程的流程图片 --> 11  <image name="web/leavedemo.gif" mime-type="image/gif" width="510" height="560" /> 12 13  <!-- ================ --> 14  <!-- == ACTIVITIES == --> 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    <!--逐个定义该节点fields的web显示方式，htmlformatter是委托类，可以充分利用其委托类的特性--> 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 55  <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 75  </activity-state> 76 77  <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>107108    <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作判断用。 1using System; 2using System.Collections; 3using log4net; 4using NetBpm.Workflow.Organisation; 5using NetBpm.Workflow.Delegation; 6using NetBpm.Workflow.Delegation.Impl; 7 8namespace NetBpm.Example.LeaveOfAbsence 9{10    /// <summary> 11    /// 通用Action类, 改类用来设置属性, 把值(action参数setValue)设置给属性(action参数attribute)12    /// by Luben13    /// </summary>14    public class AutoSetAttributesAction : IActionHandler15    {16        private static readonly ILog log = LogManager.GetLogger(typeof(AutoSetAttributesAction));17        private static readonly AttributeExpressionResolver _attributeExpressionResolver;1819        static AutoSetAttributesAction()20        {21            _attributeExpressionResolver = AttributeExpressionResolver.Instance;            22        }2324        public void Run(IActionContext actionContext)25        {26            IDictionary configuration = actionContext.GetConfiguration();2728            String setAttributeName = (String)configuration["attribute"];29            String setValue = http://www.mamicode.com/(String)configuration["setValue"];30            setValue = http://www.mamicode.com/_attributeExpressionResolver.ResolveAttributeExpression(setValue, actionContext);"设置属性" + setAttributeName + "的值为:" + setValue); 34        }35    }36}373839 2. NetBpm.Example.LeaveOfAbsence.AnyOneJoin: 该委托主要用来设置激活父flow机制，这里是只要任何一条路径到达了join，则激活父flow，流程往下流。 1using log4net; 2using NetBpm.Workflow.Execution.Impl; 3using System.Collections; 4using NetBpm.Workflow.Delegation; 5using Nullables; 6 7namespace NetBpm.Example.LeaveOfAbsence 8{ 9    /// <summary>10    /// 只要任何一个Subflow到达了该Join, 就激活Parent flow11    /// by Luben12    /// </summary>13    public class AnyOneJoin : IJoinHandler14    {15        private static readonly ILog log = LogManager.GetLogger(typeof(AnyOneJoin));1617        public bool Join(IJoinContext joinContext)18        {19            bool reactivateParent = true;2021            log.Debug("flow " + joinContext.GetFlow().Name + " is joining : " + reactivateParent);2223            // 取消其他并行的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            }3132            return reactivateParent;33        }34    }35}36 3. NetBpm.Example.LeaveOfAbsence.WhichWayDecision:该委托根据流程实际流过路径，根据标识属性RunTrace等进行走哪条边的抉择，如注释。 1using System; 2using NetBpm.Workflow.Delegation; 3 4 5namespace 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 LuBen14    /// </summary>15    public class WhichWayDecision : IDecisionHandler16    {17        public String Decide(IDecisionContext decisionContext)18        {19            // 默认为apprvoe20            String transitionName = "approve";           2122            // runtrace是表示属性，在前面的流过的路径action中被设置23            String runtrace = (String)decisionContext.GetAttribute("RunTrace");2425            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}3738后记    本文仅仅是一个示例，给大家提供一个运用nPdl定义NetBPM流程的参考，如果要把该流程投入现实中使用显然还需要做很多优化。该示例更多的是给大家展示流程定义中action可以定义多个, decision出来的transition可以到达同一条目的节点但名字却不一样等等. 示例中委托类的耦合性太高, 很多地方并不需要那样做, 如一个decision里面进行了2个判断: 判断是否大于10天, 判断是否审批同意, 这个完全可以拆分为两个独立的decision来做. 委托类设计成为高度可重用的, 耦合性低的通用类, 才是我们的目标.    待写：NetBPM实现会签；NetBPM Q&A（不断更新）