可以這么說史帝芬的http://my.so-net.net.tw/idealist/OSWorkflow/osworkflow資料是目前華文osworkflow資料中最好的一份入門教程。去面的時候在mssql中中實踐過這份入門資料，感覺非常順利。但感覺按作者的順序把教程中的例子跑完了，還不完全清楚的明白osworkflow的架構。前些在mysql5.0中重做一次，遇到了挺多問題，我通過一步一步的跟蹤原代碼調試終于把這些問題搞定。下圖是把osworkflow所提供的mysql下的數據表的ER圖:



如果你的osworkflow持久化到mysql中你的osworkflow.xml文件內如必需按如下格式來寫:

<osworkflow>
<persistence class="com.opensymphony.workflow.spi.jdbc.MySQLWorkflowStore">
?<property key="datasource" value="jdbc/DefaultDS"/>
?
??? <property key="step.sequence.increment"? value="INSERT INTO OS_STEPIDS (ID) values (null)"/>
??? <property key="step.sequence.retrieve"?? value="SELECT count(ID) FROM OS_STEPIDS"/>
??? <property key="entry.sequence.increment" value="INSERT INTO OS_ENTRYIDS (ID) values (null)"/>
??? <property key="entry.sequence.retrieve"? value="SELECT count(ID) FROM OS_ENTRYIDS"/>
???
?<property key="entry.table" value="OS_WFENTRY"/>
?<property key="entry.id" value="ID"/>
?<property key="entry.name" value="NAME"/>
?<property key="entry.state" value="STATE"/>
?

?<property key="history.table" value="OS_HISTORYSTEP"/>
?<property key="current.table" value="OS_CURRENTSTEP"/>
?<property key="historyPrev.table" value="OS_HISTORYSTEP_PREV"/>
?<property key="currentPrev.table" value="OS_CURRENTSTEP_PREV"/>
?<property key="step.id" value="ID"/>
?<property key="step.entryId" value="ENTRY_ID"/>
?<property key="step.stepId" value="STEP_ID"/>
?<property key="step.actionId" value="ACTION_ID"/>
?<property key="step.owner" value="OWNER"/>
?<property key="step.caller" value="CALLER"/>
?<property key="step.startDate" value="START_DATE"/>
?<property key="step.finishDate" value="FINISH_DATE"/>
?<property key="step.dueDate" value="DUE_DATE"/>
?<property key="step.status" value="STATUS"/>
?<property key="step.previousId" value="PREVIOUS_ID"/>

????
?</persistence>
?
?<factory class="com.opensymphony.workflow.loader.XMLWorkflowFactory">
??<property key="resource" value="workflows.xml"/>
?</factory>
</osworkflow>
propertyset.xml文件格式如下：
<?xml version="1.0" encoding="UTF-8"?>
<propertysets>
??? <propertyset name="jdbc"
????? class="com.opensymphony.module.propertyset.database.JDBCPropertySet">
??????? <arg name="datasource" value="java:comp/env/jdbc/DefaultDS"/>
??????? <arg name="table.name" value="OS_PROPERTYENTRY"/>
??????? <arg name="col.globalKey" value="GLOBAL_KEY"/>
??????? <arg name="col.itemKey" value="ITEM_KEY"/>
??????? <arg name="col.itemType" value="ITEM_TYPE"/>
??????? <arg name="col.string" value="STRING_VALUE"/>
??????? <arg name="col.date" value="DATE_VALUE"/>
??????? <arg name="col.data" value="DATA_VALUE"/>
??????? <arg name="col.float" value="FLOAT_VALUE"/>
??????? <arg name="col.number" value="NUMBER_VALUE"/>
??? </propertyset>
</propertysets>
workflows.xml文件格式如下：

<workflows>
? <workflow name="leave" type="resource" location="leave.xml"/>
</workflows>

osuser.xml文件格式如下：
<?xml version="1.0" encoding="UTF-8"?>
<opensymphony-user>
???????? <provider class="com.opensymphony.user.provider.jdbc.JDBCAccessProvider">
???????? <property name="user.table">os_user</property>
???????? <property name="group.table">os_group</property>
???????? <property name="membership.table">os_membership</property>
???????? <property name="user.name" >username</property>
???????? <property name="user.password">passwordhash</property>
???????? <property name="group.name">groupname</property>
???????? <property name="membership.userName" >username</property>
???????? <property name="membership.groupName">groupname</property>
???????? <property name="datasource">java:comp/env/jdbc/DefaultDS</property>
?????? </provider>
?????? <provider class="com.opensymphony.user.provider.jdbc.JDBCCredentialsProvider">
???????? <property name="user.table">os_user</property>
???????? <property name="group.table">os_group</property>
???????? <property name="membership.table">os_membership</property>
???????? <property name="user.name" >username</property>
???????? <property name="user.password">passwordhash</property>
???????? <property name="group.name">groupname</property>
???????? <property name="membership.userName" >username</property>
???????? <property name="membership.groupName">groupname</property>
???????? <property name="datasource">java:comp/env/jdbc/DefaultDS</property>
?????? </provider>
?????? <provider class="com.opensymphony.user.provider.jdbc.JDBCProfileProvider">
???????? <property name="user.table">os_user</property>
???????? <property name="group.table">os_group</property>
???????? <property name="membership.table">os_membership</property>
???????? <property name="user.name" >username</property>
???????? <property name="user.password">passwordhash</property>
???????? <property name="group.name">groupname</property>
???????? <property name="membership.userName" >username</property>
???????? <property name="membership.groupName">groupname</property>
???????? <property name="datasource">java:comp/env/jdbc/DefaultDS</property>
?????? </provider>
?????? <authenticator class="com.opensymphony.user.authenticator.SmartAuthenticator" />
???? </opensymphony-user>

請假列子的配置如下：

package com.pdw.wfbo;

import java.util.HashMap;
import java.util.Map;

import com.opensymphony.workflow.*;
import com.opensymphony.workflow.basic.BasicWorkflow;
import com.opensymphony.workflow.config.DefaultConfiguration;

public class LeaveWFBO {
?
?? /**
??? * 送出假單
??? * @param employee
??? * @return
??? */
?public long send(String employee) {
??Workflow workflow=new BasicWorkflow("peidw");
??DefaultConfiguration config=new DefaultConfiguration();
??workflow.setConfiguration(config);
??long workflowId=-1;
??try {
???workflowId=workflow.initialize("leave",0,null);//leave是workflows.xml里配置的工作流名稱
???workflow.doAction(workflowId,1,null);
??}catch(Exception e) {
???e.printStackTrace();
??}
??return workflowId;
?}
?
??? /**
???? * 批假
???? * @param workflowId 工作流編號
???? * @param actionId? 工作編號，2 準許，3 駁回
???? */
?public void allow(long workflowId,int actionId) {
??Workflow workflow=new BasicWorkflow("peidw");
??DefaultConfiguration config=new DefaultConfiguration();
??workflow.setConfiguration(config);
??try {
???System.out.println("actionId->"+actionId);
???System.out.println("workflowId->"+workflowId);
???workflow.doAction(workflowId,actionId,null);
??}catch(Exception e) {
???e.printStackTrace();
??}
?}

}

這是上面的這個例子的一個說明

(史帝芬, 2005/6/6, hi.steven@gmail.com)

看完第一支程式，相信讀者會有許多疑問，這些先就流程的設定做初步的介紹。首先，讀者應該注意到了，第一支程式的用到三個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>