Osworkflow定義工作流是通過一個xml文件來完成的，你可以把它取成任何你想要的名字。大致框架如下：

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE workflow PUBLIC 

  "-//OpenSymphony Group//DTD OSWorkflow 2.7//EN"

  "http://www.opensymphony.com/osworkflow/workflow_2_7.dtd">

<workflow>

  <initial-actions>

    ...

  </initial-actions>

  <steps>

    ...

  </steps>

</workflow>

都是按照標準xml指定。通過指定的dtd來校驗xml文件。一般需要輔助工具如xmlspy來自動校驗xml文件里的錯誤，這樣會方便大家檢測xml文件中的錯誤。

Step和actions

理解這個xml文件的第一個重點在于理解step和actions的在工作流系統中的概念。一個step就是這樣的一個概念：一個工作流中所處的不同位置。如在一個文檔治理系統中?？梢允瞧鸩?、編輯階段、發布等等。

Actions指定不同step中的變遷。還是用例子來理解更為形象一些。在一個文檔治理系統當中如在“第一個起草”中的“開始第一個起草”和“結束第一個起草”就是actions。

Initial actions 是一個action的非凡類型。在工作流開始時候，是沒有狀態的，也沒有任何step。用戶必須利用某個action來開始流程，這個用來開始工作流的action就被指定為initial-actions。

例如，我們假定我們只有一個initial-action，非常簡單，如下面：

<action id="1" name="Start Workflow">

  <results>

    <unconditional-result old-status="Finished" status="Queued" step="1"/>

  </results>

</action>

這個action是個action的最簡單的例子。他只是簡單定義我們需要走想的step。

工作流status

Status用來描述特定step中的一個工作流的狀態。如在文檔治理系統當中，我們的“第一次起草”step可以有兩個statuses，“underway”和“queued”

用“queued”來指示此條已經在“first draft”中排隊。沒有安排誰來處理此文檔，但是已經發出請求。而“underway”是指示一個作者已經從隊列中取出此文檔并且或許已經上鎖。表明正在first draft上工作。

Step實例：在這個例子中有兩個actions。第一個action（開始第一個起草）是在一個step中進行。但是，更改狀態為underway，第二個action是工作流流轉到下一個step，我們假定下一個工作流step為“finish”。

<step id="1" name="First Draft">

  <actions>

    <action id="1" name="Start First Draft">

      <results>

        <unconditional-result old-status="Finished" status="Underway" step="1"/>

      </results>

    </action>

    <action id="2" name="Finish First Draft">

      <results>

        <unconditional-result old-status="Finished" status="Queued" step="2"/>

      </results>

    </action>

  </actions>

</step>

<step id="2" name="finished" />

Old-status這個屬性用來指示對于當前state（結束）將要進入哪個history table。在絕大多數情況下，被寫為“finished”。

Conditions

Osworkflow有一些內建的conditon。請參看javadocs，假如需要一個特定的condition。Condition可以接收參數。如本例就接收了一個參數“status”用來指定status

<action id="1" name="Start First Draft">

  <restrict-to>

    <conditions>

      <condition type="class">

        <arg name="class.name">

          com.opensymphony.workflow.util.StatusCondition

        </arg>

        <arg name="status">Queued</arg>

      </condition>

    </conditions>

  </restrict-to>

  <results>

    <unconditional-result old-status="Finished" status="Underway" step="1"/>

  </results>

</action>

這樣就能保證在initial action被調用后才可以正確執行。因為它需要確信當前status是“queued”。

Functions

接下來，假如我們希望指定一個用戶開始first draft，他們變為“owner”為了達到這樣的目的，我們需要這樣做：

1、在當前context中防止一個“caller”變量

2、  設置result的“owner”屬性為call變量。

function是osworkflow的一個非常強大的特征，一個function基本上是一個系列在工作流變遷之間執行的工作，并不影響工作流本身。例如，你能夠有個sendmail功能，它的職責就是當一個特定的變遷發生后發送郵件通知。

Functions能夠給當前context添加變量?？梢栽谄渌鹒unctions或者scripts中使用。

Osworkflow 有自己內建function。其中一個比較有用的就是“caller”。這個function的作用就是通過查找當前的能夠調用工作流的用戶，把該用戶以字符串形式命名為caller變量的值。

<action id="1" name="Start First Draft">

  <PRe-functions>

    <function type="class">

      <arg name="class.name">com.opensymphony.workflow.util.Caller</arg>

    </function>

  </pre-functions>

  <results>

    <unconditional-result old-status="Finished" status="Underway"

                                       step="1" owner="${caller}"/>

  </results>

</action>

整合后的結果：

<action id="1" name="Start First Draft">

  <restrict-to>

    <conditions>

      <condition type="class">

        <arg name="class.name">

                com.opensymphony.workflow.util.StatusCondition

        </arg>

        <arg name="status">Queued</arg>

      </condition>

    </conditions>

  </restrict-to>

  <pre-functions>

    <function type="class">

      <arg name="class.name">

              com.opensymphony.workflow.util.Caller

      </arg>

    </function>

  </pre-functions>

  <results>

    <unconditional-result old-status="Finished" status="Underway"

                                       step="1"  owner="${caller}"/>

  </results>

</action>

<action id="2" name="Finish First Draft">

  <restrict-to>

    <conditions type="AND">

      <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.AllowOwNeronlyCondition

       </arg>

      </condition>

    </conditions>

  </restrict-to>

  <results>

    <unconditional-result old-status="Finished" status="Queued" step="2"/>

  </results>

</action>