OSWorkflow观念探讨 -转自史蒂芬
--流程设定基础
(史帝芬, 2005/6/6,)
看完第一支程式,相信读者会有许多疑问,这里先就流程的设定做初步的介绍。首先,读者应该注意到了,第一支程式的用到三个xml设定档,这三个是设定流程的设定档,说明如下。
osworkflow.xml:这个档案是设定流程是否存在资料库或存在记忆体,前面的内容是存在MS SQL Server的写法。
leave.xml:请假流程写在这个档案,这也是osworkflow的重点之一。
workflows.xml:指定系统启动时要载入那些流程。
这里针对leave.xml做些说明…
initial-actions:每个流程都至少需定义一个initial-actions,这是流程的起点。
action:导致流程变动的动作,每个action都有个编号,且不能重复。
step:虽然它的名称是步骤,似乎它会有动作?其实将它视为流程位置可能比较恰当,osworkflow真正的动作在action发生。
result:执行动作后的结果,result有两种conditional-result和unconditional-result,每个result一定有unconditional-result,当conditional-result的条件都不满足时,就执行unconditional-result。
status:流程在某个action时的状态。
old-status:流程执行某个action后的状态。
caller:这是OSWorkflow的保留字,可取得呼叫此工作流的user,即Workflow workflow = new BasicWorkflow(caller);在资料库中会记录于Table OS_HISTORYSTEP如下:
記得在pre-functions加上如下設定…
<pre-functions>
<function type="class">
<arg name="class.name">com.opensymphony.workflow.util.Caller</arg>
</function>
</pre-functions>
owner:這是傳工作流到此步驟的user。
--限制条件 转自史蒂芬
编辑
第二支程式只举AllowOwnerOnlyCondition为例,事实上OSWorkflow 2.7版提供了以下四种限制条件。
OSUserGroupCondition:限制由隶属某指定Group的人执行。
StatusCondition:限制step的status为某个值时才能执行。
AllowOwnerOnlyCondition:只允许Owner执行。
DenyOwnerCondition:只有Owner不能执行。
当同时要加上两个限制条件时,可以如下写。
<restrict-to>
<conditions type="AND">
<condition type="class">
<arg name="class.name">
com.opensymphony.workflow.util.StatusCondition
</arg>
<arg name="status">Queued</arg>
</condition>
<condition type="class">
<arg name="class.name">
com.opensymphony.workflow.util.OSUserGroupCondition
</arg>
<arg name="group">A0001</arg>
</condition>
</conditions>
</restrict-to>
--传值储值
Property sets:持续性变数,会将变数值存入Table OS_PROPERTYENTRY,在设定档中以propertySet来存取。
Transient Map:临时性变数,仅在workflow中有效,在设定档中以transientVars来存取。
外部函数:外部函数要实作FunctionProvider,如第三支程式的OutputPropertySet,在设定档中如下呼叫使用。
<function type="class">
<arg name="class.name">
tw.idv.idealist.OutputPropertySet
</arg>
<arg name="author">Steven Shi</arg>
</function>
--校验器
看完第四支程式应该多半的人已经知道怎么做校验器了!这里再大略讲解一下。首先写一个类别,这个类别要实作Validator,如前面程式的MyValidator,如有错误抛出exception。接下来在流程设定档中加入
<validators>
<validator type="class">
<arg name="class.name">
tw.idv.idealist.MyValidator
</arg>
</validator>
</validators>
上面這一段設定應放在那裡? 這可以查一下DTD,就知道應放於那個位置了。
<!ELEMENT action (meta*, restrict-to? , validators?, pre-functions?, results, post-functions?)>
--查询API
要使用OSWorkflow提供的Query API,先继承AbstractWorkflow,透过AbstractWorkflow里的getPersistence method可连接资料做查询,其余的语法参考程式即可知道,这里针对几点做说明:
WorkflowExpressionQuery参数
这个类别建立时所需的四个参数,第二个对应到资料库的Table如下所示,第一个则对应到Table中的栏位,栏位如何对应由名称应可明了,不另作说明。
常數 Table
FieldExpression.ENTRY OS_WFENTRY
FieldExpression.CURRENT_STEPS OS_CURRENTSTEP
FieldExpression.HISTORY_STEPS OS_HISTORYSTEP
第三個參數為運算元,只有四種如下:
運算元 說明
FieldExpression.EQUALS 等於
FieldExpression.NOT_EQUALS 不等於
FieldExpression.GT 大於
FieldExpression.LT 小於
巢状运算
如果要比较的不只一个栏位,就需要用到巢状运算,使用class NestedExpression,底下是一个官方文件的范例:
、
// Get all finished workflow entries
//where the current owner is 'testuser'
Expression queryLeft = new FieldExpression(
FieldExpression.OWNER,
FieldExpression.CURRENT_STEPS,
FieldExpression.EQUALS, 'testuser');
Expression queryRight = new FieldExpression(
FieldExpression.STATUS,
FieldExpression.CURRENT_STEPS,
FieldExpression.EQUALS,
"Finished",
true);
WorkflowExpressionQuery query =
new WorkflowExpressionQuery(
new NestedExpression(
new Expression[] {queryLeft, queryRight},
NestedExpression.AND));
标签:设定,workflow,流程,探讨,观念,OSWorkflow,FieldExpression,new,result
From: https://blog.51cto.com/u_16085616/6441487