<?xml version="1.0"?>

  <terp><data>

    <record model="workflow" id=workflow_id>

    <field name="name">workflow.name</field>

    <field name="osv">resource.model</field>

    <field name="on_create">True | False</field>

  </record>

</data></terp>

model：固定取值"workflow"

id：任意值，唯一標識本工作流

name: 工作流的名稱，任意定義

osv：本工作流關聯的物件型別，是OpenERP模組中定義的某物件名，如採購單物件（purchase.order）。是本工作流處理的資料物件。

on_create：每當系統新產生一個osv 中定義的物件的例項時候，是否對應的產生一個和該物件例項關聯的工作流例項。預設是True.

工作流和工作流例項：工作流定義了對某一型別的物件，如採購訂單（PO）的處理流程。例如，PO單的一般處理流程也許是：1）新建PO，State = draft；2）審批PO，審批的同時，a)系統自動產生收貨單，工倉庫收貨；b)系統自動產生憑據（Invoice），供財務確認付款；c)系統自動產生PDF的採購訂單，並自動EMail給該PO單對應的供應商。但對於特定的某個PO物件，需要一個工作流例項，以記錄本PO物件處在流程的哪個階段，如PO1尚在draft狀態，PO2已經審批通過。

PO單的審批，以及對應的a)、b)、c)的動作，都可以在OE的工作流中定義解決，而不需要全編碼在PO物件上。即工作流實現了流程處理相關的程式碼和被處理物件的程式碼相分離，降低了不同處理程式碼的耦合性，增加了系統功能的柔軟性。

二、活動（Activity）定義

<record model="workflow.activity" id="activity_id">

  <field name="wkf_id" ref="workflow_id"/>

  <field name="name">activity.name</field>

  <field name="kind">dummy | function | subflow | stopall</field>

  <field name="subflow_id">subflow_id</field>

  <field name="action">(...)</field>

  <field name="action_id">(...)</field>

  <field name="split_mode">XOR | OR | AND</field>

  <field name="join_mode">XOR | AND</field>

  <field name="signal_send">(...)</field>

  <field name="flow_start">True | False</field>

  <field name="flow_stop">True | False</field>

</record>

model：固定取值workflow.activity

wkf_id：本Activity所屬的工作流id

name: 本Activity名稱，任意值

kind：本Activity型別，有Dummy, Function, Subflow, Stop All 四種。kind說明，如果流程到達本節點，系統應執行的動作類別。

  Dummy 表示不執行任何動作，即action中定義的程式碼不會被執行。

  Function 表示執行action中定義的python程式碼，且，執行action_id中定義的server action。常見情況是，action中定義一個write方法，修改流程關聯的物件的狀態。對於Function型別的節點，action中定義的程式碼或者返回False，或者返回一個客戶端動作id（A client action should be returned）。

  Subflow型別表示觸發“subflow_id”中指定的工作流。仔細的讀者或許要問，工作流的執行總是和某個被處理的物件關聯，是的，如果定義了action，subflow 關聯的物件id 由action中定義的程式碼返回。如果沒有定義action，系統預設subflow關聯的物件和本節點所屬的工作流處理的物件id一致。stopall型別表示，流程到此節點則結束，但結束前，系統仍會執行action中的程式碼。

signal_send：執行完本節點的動作（action及action_id定義的動作）後，應向別的工作流發往的signal，格式是：subflow.signal。subflow_id和signal_send必須配合使用，subflow_id表示，觸發子工作流subflow_id，在該子工作流中，通常必須定義signal_send，signal_send定義父流程中的某個signal，表示，子流程處理結束後觸發父流程中的訊號subflow.signal。注意，用於父子流程通訊的工作流signal必須是形如subflow.* 。例如，在HR模組的workflow "wkf_expenses"中，需要開發票時候，它觸發流程account模組中的工作流“account.wkf”（<field name="subflow_id" ref="account.wkf"/>）。account.wkf處理完成後，發出訊號subflow.paid 通知wkf_expenses流程（<field name="signal_send">subflow.paid</field>）。wkf_expenses中定義了訊號subflow.paid（<field name="signal">subflow.paid</field>）。

split_mode：有三個選項，XOR，OR，AND，預設是XOR。XOR 表示，由本節點始發的出遷移中，沿著第一個滿足遷移條件的遷移跳轉。OR 表示由本節點始發的出遷移中，只要滿足遷移條件即沿該遷移跳轉。AND 表示由本節點始發的出遷移中，只有所有遷移皆滿足遷移條件才跳轉，而且是同時沿所有遷移跳轉。XOR 只有一個跳轉，OR 有零或多個跳轉，AND 有零或全部跳轉。

join_mode：有兩個選項，XOR，AND，預設是XOR。XOR 表示，以本節點為終點的入遷移中，只要有一個跳至本節點，即執行本節點的action。AND 表示，以本節點為終點的入遷移中，只有所有遷移都已經跳至本節點，才執行本節點的action。

flow_start：表示流程的開始節點。

flow_stop：表示流程的結束節點。

三、遷移（Transition）的定義

遷移的完整 XML 定義格式如下。

<record model="workflow.transition" id="transition_id">

  <field name="act_from" ref="activity_id_1"/>

  <field name="act_to" ref="activity_id_2"/>

  <field name="signal">(...)</field>

  <field name="condition">(...)</field>

  <field name="trigger_model">(...)</field>

  <field name="trigger_expr_id">(...)</field>

</record>

act_from：本遷移的起始節點，引用之前定義的Activity。

act_to：本遷移的結束節點，引用之前定義的Activity。

signal：觸發本遷移的訊號，表示，如果系統收到signal定義的訊號，則觸發本遷移。觸發訊號有三種方式，1）最常見的是使用者點選檢視中的“name = 本處定義的signal”的button，此時相當於向系統傳送遷移訊號量。系統會根據檢視中的物件id，找到物件關聯的workflow，再找到與button name相同的signal，觸發之。2）呼叫workflow_service的方法：trg_validate(self, uid, res_type, res_id, signal, cr)，此方法表示，觸發物件型別res_type關聯的workflow的signal訊號，工作流例項關聯的物件例項是 res_id。3）子流程的signal_send 發出的訊號，此種情況前文已說過。

condition：遷移的條件，是一段Python程式碼，通常是一個函式呼叫。當系統收到signal中定義的訊號時候，檢查此處的條件，條件為真則實際觸發遷移。

trigger_model和trigger_expr_id：此二欄位表示啟動一個新工作流例項。trigger_model定義物件型別，trigger_expr_id 定義一段Python程式碼，返回trigger_model型別的物件id。此二欄位表示，如果act_from 中的action 執行完畢，且condition 條件OK，則系統中插入一個trigger_model型別，trigger_expr_id返回的物件id關聯的工作流例項。然後，可以呼叫workflow_service的方法trg_trigger(self, uid, res_type, res_id, cr)實際執行該工作流。實際使用例子請參考Sale模組的工作流定義 wkf_sale：

            <field name="trigger_model">procurement.order</field>

            <field name="trigger_expr_id">procurement_lines_get()</field>

遷移（Transition）的定義漏了許可權組group_id，修正如下。表示只有該許可權組可以觸發本遷移。

遷移的完整 XML 定義格式如下。

<record model="workflow.transition" id="transition_id">

  <field name="act_from" ref="activity_id_1"/>

  <field name="act_to" ref="activity_id_2"/>

  <field name="group_id" ref="groupid"/>

  <field name="signal">(...)</field>

  <field name="condition">(...)</field>

  <field name="trigger_model">(...)</field>

  <field name="trigger_expr_id">(...)</field>

</record>