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

qinysong

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

最近访客更多访客>>

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
浏览 29512
评论(91)
论坛回复 / 浏览 (70 / 114528)
分类:企业架构
查看更多

31 楼 qinysong 2007-08-02

to:zhangyqpost
tomcat下都一样，只是数据源配置一下即可

30 楼 zhangyqpost 2007-08-02

非常感谢楼主把这么好的东西贡献出来.
你用的是jboss,能把tomcat的配置也写出来吧?谢谢.

29 楼 lfh220 2007-08-02

登录可以了，就是申请的时候会出现“提交请假申请时出现异常，可能没有增加您提交需求的权限”
这是什么原因呢？
哪位有没有关于osworkflow方面的电子书，可以发一分给我吗？email:lfh4961983@163.com

28 楼 qinysong 2007-07-31

to:lfh220
用什么驱动没有关系，都是可以的，我只是随便用了一个；
结果连登录都不行，那就根据后台显示的异常信息进行检查

27 楼 lfh220 2007-07-31

你好，我想把这个工程放在tomcat下运行，另外我没用JSQLConnect这种方式，而是用jdbc:microsoft:sqlserver://127.0.0.1:1433;DatabaseName=osworkflow_app，结果连登录都不行。小弟刚开始接触这个，希望。QQ：251713646
希望大家，谢谢

26 楼 qinysong 2007-07-27

你的session.getAttribute("username")取值是多少
看异常信息是插入的纪录OWNER字段违反外键约束，你看看取出的数据和os_user表中数据是否一致。
如果正常登陆，应该不会出现不一致的问题，检查检查

25 楼 classicbride 2007-07-27

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")是可以取得值的...??

24 楼 classicbride 2007-07-26

我又来了... 本来从来没有玩过这个... 看到楼主贴的这个后才开始在弄..很好学到不少东东.. 我现在能走到提交请假表单了...谢谢哈.. 我用的Mysql和Tomcat...
但是到起动工作流程时出错了...
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)
这条sql没有能写入数据库... 搞不懂为什么写不进去？
另外，楼主有没有这方面的电子书呀..有的话发一本，谢谢...
classicbride@126.com

23 楼 philip_kissme 2007-07-24

挺好简单的例子可以给初学者一个形象的概念
jbpm底层一定要用hibernate,要是有jdbc实现就好了

22 楼 lichong712 2007-07-23

可能是中文问题，把system.out.println()的中文去掉，就好了

21 楼 lichong712 2007-07-20

employee1请假提交没问题。
manager1审核同意没问题，但是manager1审核不同意和
hr1审核同意或不同意都会就出现上面的错误。

数据库里面我看审核结果是正确的，在bus_leaveApprove表中已存上相关记录。

配置文件我都没改过。不知道是怎么回事？谢谢了！

20 楼 qinysong 2007-07-19

to:lichong712
前面几个步骤如何，hr1审核同意怎样，会出这个问题吗

19 楼 qinysong 2007-07-19

to：lichong712
前面几个步骤如何？hr1审核同意时，可以跑吗

18 楼 lichong712 2007-07-19

请问一下，我用hr1审核时报错

ERROR [(util.beanshell.BeanShellFunctionProvider)] Evaluation error while running BSH function script
Sourced file: <Inline eval of:
System.out.println("步骤 5 自动动作请假申请没能获准邮件通知 Send mail 很抱歉$$$$$$$");
; > Token Parsing Error: Lexical error at line 2, column 62. Encountered: " " (32), after : "\"e\u00a4 5 \u00ea\u00a8\u00a8\\": <at unknown location>
at bsh.Interpreter.eval(Unknown Source)

这是什么问题啊？谢谢了

17 楼 qinysong 2007-07-19

classicbride 写道

请教一下那个OSUser 我怎么用不了...

UserManager userManager = UserManager.getInstance();时userManager为null;

com.opensymphony.user.UserManagerImplementationException: The configuration file osuser.xml could not be found.

我把osuser.xml放到src下了...

哪里不对？？？谢谢

你检查一下生成的部署war包里，相应的目录（类似WebModule.war\WEB-INF\classes）里有没有那个xml文件

16 楼 qinysong 2007-07-19

agile_boy 写道

数据库脚本，可否更标准些啊，比如我想在mysql下运行，是不是会有问题啊

在osworkflow的官方网站下载包中，有对应各种类型的数据库创建文件；
附件是上面示例的mysql数据库脚本，不过没有测试过

15 楼 classicbride 2007-07-19

14 楼 agile_boy 2007-07-19

数据库脚本，可否更标准些啊，比如我想在mysql下运行，是不是会有问题啊

13 楼 stworthy 2007-07-18

对前面的流程改用YAML描述一下：
<div class='code_title'>ruby 代码</div>
<div class='dp-highlighter'>
<div class='bar'/>
<ol class='dp-rb'>
 <li class='alt'>workflow: </li>
 <li class=''> init-actions: </li>
 <li class='alt'> 1: </li>
 <li class=''> name: 启动请假申请工作流 </li>
 <li class='alt'> results: </li>
 <li class=''> - </li>
 <li class='alt'> step: 1 </li>
 <li class=''> status: Underway </li>
 <li class='alt'> owner: employee </li>
 <li class=''> steps: </li>
 <li class='alt'> 1: </li>
 <li class=''> name: 请假申请 </li>
 <li class='alt'> actions: </li>
 <li class=''> 1: </li>
 <li class='alt'> name: 提交需求申请 </li>
 <li class=''> condition: @wf_params['group']=='employee' </li>
 <li class='alt'> after-action: | </li>
 <li class=''> if curr_instance_step(1).owner=='manager' </li>
 <li class='alt'> puts "步骤 1 提交需求申请满足条件结果需部门经理审批..." </li>
 <li class=''> end </li>
 <li class='alt'> results: </li>
 <li class=''> - </li>
 <li class='alt'> condition: @wf_params['dayCount']>3 </li>
 <li class=''> step: 2 </li>
 <li class='alt'> status: Underway </li>
 <li class=''> owner: manager </li>
 <li class='alt'> - </li>
 <li class=''> step: 3 </li>
 <li class='alt'> status: Underway </li>
 <li class=''> owner: hrl </li>
 <li class='alt'> 2: </li>
 <li class=''> name: 请假申请审核 </li>
 <li class='alt'> actions: </li>
 <li class=''> 1: </li>
 <li class='alt'> name: 部门主管审批请假申请 </li>
 <li class=''> condition: curr_instance_step(2).status=='Underway' and @wf_params['group']=='manager' </li>
 <li class='alt'> results: </li>
 <li class=''> - </li>
 <li class='alt'> condition: @wf_params['opinion']==2 </li>
 <li class=''> step: 5 </li>
 <li class='alt'> status: Underway </li>
 <li class=''> - </li>
 <li class='alt'> step: 3 </li>
 <li class=''> status: Underway </li>
 <li class='alt'> owner: hrl </li>
 <li class=''> 3: </li>
 <li class='alt'> name: 请假申请审核 </li>
 <li class=''> actions: </li>
 <li class='alt'> 1: </li>
 <li class=''> name: 人力资源主管审批请假申请 </li>
 <li class='alt'> results: </li>
 <li class=''> - </li>
 <li class='alt'> condition: @wf_params['opinion']==2 </li>
 <li class=''> step: 5 </li>
 <li class='alt'> status: Underway </li>
 <li class=''> - </li>
 <li class='alt'> step: 5 </li>
 <li class=''> status: Underway </li>
 <li class='alt'> 4: </li>
 <li class=''> name: 请假申请结果通知 </li>
 <li class='alt'> actions: </li>
 <li class=''> 1: </li>
 <li class='alt'> name: 请假申请获准邮件通知 </li>
 <li class=''> auto: true </li>
 <li class='alt'> before-acton: | </li>
 <li class=''> puts "步骤 4 自动动作请假申请获准邮件通知 Send mail 祝贺你" </li>
 <li class='alt'> results: </li>
 <li class=''> - </li>
 <li class='alt'> step: 6 </li>
 <li class=''> status: Finished </li>
 <li class='alt'> 5: </li>
 <li class=''> name: 请假申请结果通知 </li>
 <li class='alt'> actions: </li>
 <li class=''> 1: </li>
 <li class='alt'> name: 请假申请没能获准邮件通知 </li>
 <li class=''> before-action: | </li>
 <li class='alt'> puts "步骤 5 自动动作请假申请没能获准邮件通知 Send mail 很抱歉$$$$$$$" </li>
 <li class=''> results: </li>
 <li class='alt'> - </li>
 <li class=''> step: 6 </li>
 <li class='alt'> status: Finished </li>
 <li class=''> 6: </li>
 <li class='alt'> name: flow over </li>
 <li class=''> </li>
</ol>
</div>

12 楼 hill123 2007-07-17

下载来看看

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

发表评论

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

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论