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添加变量。可以在其他functions或者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>