基于开源工作流引擎OSWorkflow的业务系统实例——请假审批系统

qinysong

浏览: 192622 次
性别:
来自: 北京

最近访客更多访客>>

Ovbk2c

cutesunshineriver

stride

atopoxo

博主相关

博客

微博

相册

留言

关于我

文章分类

全部博客 (19)

社区版块

存档分类

工作 Workflow OS XML 配置管理

最近工作中一个项目打算采用工作流技术，所以对工作流特别是OSWorkflow进行了一些学习和研究，为了向项目组其他成员演示和进一步进行应用，做了这个小业务系统，现在经过整理把它拿出来，希望对想要了解OSWorkflow的朋友有一点帮助。我接触的时间也不长，所以哪个地方有问题还希望大家多多指点，对工作流技术共同提高。

这个小业务系统的主要目的
演示如何基于OSWorkflow构建业务系统，即如何将原来程序内硬编码的业务过程抽取出来，放到底层的工作流引擎中，上层业务模块只进行具体业务动作的执行，同时演示着两层如何“集成”。
本系统演示三个方面：业务处理和OSWorkflow的基本“集成”、工作流引擎根据工作流定义调用业务处理逻辑、基于业务数据的工作流跳转

业务用例描述
核心工作流：
1、员工填写请假申请单，包括“请假原因”和“请假天数”，填写后进行提交；
2、部门主管对员工请假申请进行审批，同意员工请假；
3、人力资源主管对员工请假申请进行审批，同意员工请假；
4、系统发送邮件通知员工请假申请已获得批准；
5、用例结束；

备选工作流1：
在第一步中，如果员工请假天数小于等于3天，那么不需要部门主管审批，直接从第一步跳到第三步，又人力资源审批；

备选工作流2：
在第二步中，如果部门主管不同意请假申请，那么系统将给请假员工发送请假没有通过的邮件通知，用例结束；

备选工作流3：
在第三步中，如果人力资源主管不同意请假申请，那么系统将给请假员工发送请假没有通过的邮件通知，用例结束；

系统运行/开发环境
数据库：ms sqlserver2000
应用服务器：Jboss-4.0.2
开发工具：Jbuilder2006

系统搭建
1、创建数据库，我命名为osworkflow_app，也可命名为任意名字，只要在数据源配置中正确配置即可；
2、创建数据表并初始化用户及用户组数据，执行附件中的db_leaveApprove_20070712.sql即可；
3、在jboss下配置数据源，我的配置如附件mssql-ds.xml
4、将osworkflow及log4j的配置文件leave_apply.xml、osuser.xml、osworkflow.xml、propertyset.xml、workflows.xml、log4j.properties拷贝到工程目录src下面；
可直接将附件的leaveApprove.rar解到项目中，里面包括所有的源程序和资源包。

工作流定义文件说明
依据本业务需求的工作流定义文件如下
定义中包括6个step

step1是员工请假申请的步骤，本步骤的action在执行时将回调业务方法类ApplyFunction，将申请单数据插入到数据库中，同时处理结果将根据请假申请天数dayCount进行判断，如果请假申请天数大于3天，将跳到step2让部门主管审批，如果不大于3天，将直接跳到step3让人力资源主管审批；

step2 是部门主管审批，如果审批同意（opinion!=2）将跳到step3再由人力资源主管审批，如果审批不同意（opinion==2）将跳到step5自动发“申请未批准”邮件通知步骤；

step3 是人力资源主管审批，如果审批同意（opinion!=2）将跳到step4自动发“申请批准”邮件通知步骤，如果审批不同意（opinion==2）将跳到step5自动发“申请未批准”邮件通知步骤；

step4和step5都是自动发送邮件通知步骤，执行完之后跳到空步骤step6结束该工作流实例。

工作流定义文件

<?xml version="1.0" encoding="GBK"?>
<!DOCTYPE workflow PUBLIC "-//OpenSymphony Group//DTD OSWorkflow 2.6//EN" "http://www.opensymphony.com/osworkflow/workflow_2_8.dtd">
<workflow>
	<initial-actions>
		<action id="100" name="启动请假申请工作流">
			<results>
				<unconditional-result old-status="Finished" status="Underway" step="1"/>
			</results>
		</action>
	</initial-actions>
	<steps>
		<step id="1" name="请假申请">
			<actions>
				<action id="1" name="提交需求申请">
					<restrict-to>
						<conditions type="AND">
							<condition type="class">
								<arg name="class.name">com.opensymphony.workflow.util.OSUserGroupCondition</arg>
								<arg name="group">employee</arg>
							</condition>
						</conditions>
					</restrict-to>
					<pre-functions>
						<function type="class">
							<arg name="class.name">com.qiny.leave.ApplyFunction</arg>
						</function>
					</pre-functions>
					<results>
						<result old-status="Finished" status="Underway" step="2" owner="manager1">
							<conditions type="AND">
								<condition type="beanshell">
									<arg name="script">
									propertySet.getInt("dayCount")>3
									</arg>
								</condition>
							</conditions>
							<post-functions>
								<function type="beanshell">
									<arg name="script">
                                        System.out.println("步骤 1 提交需求申请 满足条件结果 需部门经理审批...");
                                    </arg>
								</function>
							</post-functions>
						</result>
						<unconditional-result old-status="Finished" status="Underway" step="3" owner="hr1"/>
					</results>
				</action>
			</actions>
		</step>
		<step id="2" name="请假申请审核">
			<actions>
				<action id="2" name="部门主管审批请假申请">
					<restrict-to>
						<conditions type="AND">
							<condition type="beanshell">
								<arg name="script">true</arg>
							</condition>
							<condition type="class">
								<arg name="class.name">com.opensymphony.workflow.util.StatusCondition</arg>
								<arg name="status">Underway</arg>
							</condition>
							<condition type="class">
								<arg name="class.name">com.opensymphony.workflow.util.OSUserGroupCondition</arg>
								<arg name="group">manager</arg>
							</condition>
						</conditions>
					</restrict-to>
					<pre-functions>
						<function type="class">
							<arg name="class.name">com.qiny.leave.ApproveFunction</arg>
						</function>
					</pre-functions>
					<results>
						<result old-status="Finished" status="Underway" step="5">
							<conditions type="AND">
								<condition type="beanshell">
									<arg name="script">
									propertySet.getInt("opinion")==2
									</arg>
								</condition>
							</conditions>
							<post-functions>
								<function type="beanshell">
									<arg name="script">
                                        System.out.println("步骤 2 请假申请审核 部门经理审批没有通过 ...");
                                    </arg>
								</function>
							</post-functions>
						</result>
						<unconditional-result old-status="Finished" status="Underway" step="3" owner="hr1"/>
					</results>
				</action>
			</actions>
		</step>
		<step id="3" name="请假申请审核">
			<actions>
				<action id="3" name="人力资源主管审批请假申请">
					<pre-functions>
						<function type="class">
							<arg name="class.name">com.qiny.leave.ApproveFunction</arg>
						</function>
					</pre-functions>
					<results>
						<result old-status="Finished" status="Underway" step="5">
							<conditions type="AND">
								<condition type="beanshell">
									<arg name="script">
									propertySet.getInt("opinion")==2
									</arg>
								</condition>
							</conditions>
						</result>
						<unconditional-result old-status="Finished" status="Underway" step="5"/>
					</results>
				</action>
			</actions>
		</step>
		<step id="4" name="请假申请结果通知">
			<actions>
				<action id="4" auto="true" name="请假申请获准邮件通知">
					<pre-functions>
						<function type="beanshell">
							<arg name="script">
                                System.out.println("步骤 4 自动动作 请假申请获准邮件通知 Send mail 祝贺你$$$$$$$");
                            </arg>
						</function>
					</pre-functions>
					<results>
						<unconditional-result old-status="Finished" status="Finished" step="6"/>
					</results>
				</action>
			</actions>
		</step>
		<step id="5" name="请假申请结果通知">
			<actions>
				<action id="5" auto="true" name="请假申请没能获准邮件通知">
					<pre-functions>
						<function type="beanshell">
							<arg name="script">
                                System.out.println("步骤 5 自动动作 请假申请没能获准邮件通知 Send mail 很抱歉$$$$$$$");
                            </arg>
						</function>
					</pre-functions>
					<results>
						<unconditional-result old-status="Finished" status="Finished" step="6"/>
					</results>
				</action>
			</actions>
		</step>
		<step id="6" name="flow over">
		</step>
	</steps>
</workflow>

回家了，明天再对一些程序进行说明
可以下载附件，建立工程后执行，数据库中有三个用户：employee1表示员工，可以提交请假申请；manager1表示部门主管；hr1表示人力资源主管，密码都是test

leaveApprove.rar (2.7 MB)
描述: 程序源文件和需要的lib
下载次数: 13282

databaseAndConfig.rar (2.3 KB)
描述: 数据库表创建及数据初始化文件数据源配置文件
下载次数: 5181

分享到：

2007-07-12 22:38
浏览 29511
评论(91)
论坛回复 / 浏览 (70 / 114527)
分类:企业架构
查看更多

71 楼 zhima 2008-04-18

bsspirit 写道

zhima 写道

请问楼主：在你设计的业务表中，如何获取某个申请单的审批状态呢？这个审批状态要包含：同意、驳回、审批中、已经提交但未审批4个状态。
我很迷惑

代为回答下：

#         <step id="2" name="请假申请审核">  
#             <actions>  
#                 <action id="2" name="部门主管审批请假申请">  
#                     <restrict-to>  
#                         <conditions type="AND">  
#                             <condition type="beanshell">  
#                                 <arg name="script">true</arg>  
#                             </condition>  
#                             <condition type="class">  
#                                 <arg name="class.name">com.opensymphony.workflow.util.StatusCondition</arg>  
#                                 <arg name="status">Underway</arg>  
#                             </condition>  
#                             <condition type="class">  
#                                 <arg name="class.name">com.opensymphony.workflow.util.OSUserGroupCondition</arg>  
#                                 <arg name="group">manager</arg>  
#                             </condition>  
#                         </conditions>  
#                     </restrict-to>

通过配制StatusCondition的条件，进行判断．上例中，如果运行时的status＝Underway，则符合条件，继续执行．

条件的名字，默认里面只有三种Underway,Queued,Finished，不过都是用string比较相等的，所以自己也可以随便起名．

我是想获取某个申请单的审批结果，这个审批结果要包含：同意或驳回或审批中、已经提交但未审批4个状态。要获得这样的状态结果不用更改工作流xml文件吧；关键是 sql语句怎么写？

70 楼 bsspirit 2008-04-17

zhima 写道

代为回答下：

#         <step id="2" name="请假申请审核">  
#             <actions>  
#                 <action id="2" name="部门主管审批请假申请">  
#                     <restrict-to>  
#                         <conditions type="AND">  
#                             <condition type="beanshell">  
#                                 <arg name="script">true</arg>  
#                             </condition>  
#                             <condition type="class">  
#                                 <arg name="class.name">com.opensymphony.workflow.util.StatusCondition</arg>  
#                                 <arg name="status">Underway</arg>  
#                             </condition>  
#                             <condition type="class">  
#                                 <arg name="class.name">com.opensymphony.workflow.util.OSUserGroupCondition</arg>  
#                                 <arg name="group">manager</arg>  
#                             </condition>  
#                         </conditions>  
#                     </restrict-to>

69 楼 zhima 2008-04-17

68 楼 bsspirit 2008-04-14

有一个小问题, 关于设计上面的.

<step id="3" name="请假申请审核">  
             <actions>  
                 <action id="3" name="人力资源主管审批请假申请">  
                     <pre-functions>  
                         <function type="class">  
                             <arg name="class.name">com.qiny.leave.ApproveFunction</arg>  
                         </function>  
                     </pre-functions>  
                     <results>  
                         <result old-status="Finished" status="Underway" step="5">  
                             <conditions type="AND">  
                                 <condition type="beanshell">  
                                     <arg name="script">  
                                     propertySet.getInt("opinion")==2  
                                     </arg>  
                                 </condition>  
                             </conditions>  
                         </result>  
                         <unconditional-result old-status="Finished" status="Underway" step="5"/>  
                     </results>  
                 </action>  
             </actions>  
         </step>

比如,上面这步, HR主管审批. 楼主的设计是用到一个action, 通过opinion用法判断不同的结果. 是不是也可以两个action替换上面的方式呢? 通过调用进,传入不同action的id号, 判断不同的结果.

<step name="HR审批" id="3">
			<actions>
				<action name="通过" id="4">
					<results>
						<unconditional-result old-status="Finished" step="4" status="Quened" owner="email"/>
					</results>	
					<post-functions>
						<function type="beanshell">
							<arg name="script">
								System.out.println("HR is pass");
							</arg>
						</function>
					</post-functions>			
				</action>
				
				<action name="不通过" id="5">
					<results>
						<unconditional-result old-status="Finished" step="4" status="Quened" owner="email"/>
					</results>
					<post-functions>
						<function type="beanshell">
							<arg name="script">
								System.out.println("HR is fail");
							</arg>
						</function>
					</post-functions>
				</action>
			</actions>
		</step>

我想问一下, 基于上面两种方式的优缺点, 进行比较一下. (小弟当开始学工作流,请大家指点一下.)

67 楼 nobady 2008-04-08

请问，楼主你写的工作流中，如何区别只有员工有申请的权利-------
也就是我在按你上面的提示运行时这里------long wfid = wf.initialize("leave_apply", 100, null); 出问题，，后台提示--空指针异常，是不是在运行时还有比的细节要注意，，

66 楼 itpsh 2007-12-29

请问楼主,为什么我中间有一步审批没有通过,在这个表中(os_wfentry) 最后的state字段状态应该是6 , 为什么最后总是4呢?

65 楼 aixinyi 2007-12-18

急时雨呀,我就需要这样的例子学习工作流方面的知识呢,谢了

64 楼 itpsh 2007-12-18

请问楼主,os_user表中的密码是通过什么加密的呀...

63 楼 bbxyhaihua 2007-12-17

classicbride 写道

Workflow wf = new BasicWorkflow((String) session.getAttribute("username"));
    Map map = new HashMap();
    map.put("applicant", applicant);
    map.put("reason", reason);
    map.put("dayCount", new Integer(dayCount));

    try {
      long wfid = wf.initialize("leave_apply", 100, null);

为什么我启用一个工作流的时候会报这个错呢？
DEBUG [(opensymphony.workflow.AbstractWorkflow)] Outcome: stepId=1, status=Underway, owner=, actionId=100, currentStep=0
DEBUG [(spi.jdbc.JDBCWorkflowStore)] Executing SQL statement: INSERT INTO OS_CURRENTSTEP (ID,ENTRY_ID, STEP_ID, ACTION_ID, OWNER, START_DATE, DUE_DATE, FINISH_DATE, STATUS, CALLER ) VALUES (?, ?, ?, null, ?, ?, ?, null, ?, null)
com.opensymphony.workflow.StoreException: Unable to create current step for workflow instance #7: root cause: Cannot add or update a child row: a foreign key constraint fails (`workflowtest/os_currentstep`, CONSTRAINT `os_currentstep_ibfk_2` FOREIGN KEY (`OWNER`) REFERENCES `os_user` (`USERNAME`))

owner没有值造成的...而我session.getAttribute("username")是可以取得值的...??

我也遇到了这个问题,不知道你们可找到什么原因了?
有知道的奉献出来
谢谢!!

62 楼 itpsh 2007-12-12

多谢楼主,果然是好东西..如果楼主可以详细介绍一下如何与现在系统集成就太好了.

61 楼 pandaprince 2007-12-05

用过BEA的ServiceBus，也是实现类似的Business Service整合，通过一个很友好的操作界面就可以实现，后台自动生成XML。

60 楼 pandaprince 2007-12-05

这些XML读起来就很累了，大概意思清楚，但估计作者自己也是根据模板改改的吧，要不然不可能严格按照这种格式来写。个人认为这应该提供图形化配置工具来自动生成。

59 楼 xufei203 2007-11-11

楼主能否具体的说一下那几个XML文件的关系呢

58 楼 nuoda 2007-11-09

这里有一个工作流图形编辑工具，希望能够对喜欢osworkflow的朋友带来帮助。[url=http:/nuoda.javaeye.con]

57 楼 nuoda 2007-11-09

这里有一个针对osworkflow的工作流编辑器。http://nuoda.iteye.com，虽然是评估测试版本、比较粗糙，但是功能符合要求。有了图形编辑流程工具，便于交流。

56 楼 kevindeng 2007-10-27

对，楼主写得相当不错了，就是楼主的例子带我入了一点门啊，谢谢啦，但如果下一STEP的人员是由当前STEP指定时要怎么弄呢，比如请假，要找一个代理人，送出后就要给代理人审核，

55 楼 cuizhiyong 2007-10-22

楼主，我用的mysql的数据库，验证的时候authenticated = um.getUser(username).authenticate(password);出错，于是，我把验证去掉，然后在创建请假流程的时候出现异常。请问会是怎么回事呢？

54 楼 nihongye 2007-10-15

楼主的文章写得挺好。说句题外话，这么一堆xml,我觉得完全不如程序来得便捷易懂。

53 楼 asclepiad 2007-10-15

感谢楼主的无私贡献！
请问下有没有oracle的数据库创建源码？

52 楼 nybest 2007-10-11

强烈统一楼上说的..

« 上一页 1 2 3 4 5 下一页 »

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论