OSWorkflow观念探讨 -转自史蒂芬

--流程设定基础
(史帝芬, 2005/6/6, [e-mail])
 
看完第一支程式，相信读者会有许多疑问，这里先就流程的设定做初步的介绍。首先，读者应该注意到了，第一支程式的用到三个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));