工作流概念：“ 工作流，指的是一系列相互衔接、自动进行的业务活动或任务。” -百度百科
我的个人理解，工作流就是执行一个任务的一系列过程（步骤），每个步骤可能需要设计不同“模块”，而且步骤之间又有着各种各样的联系。以企业的采购为例：采购过程包括 采购申请→采购批准→采购订单→审核采购订单→…… ；其中采购申请可能是A部门申请，批准可能是B部门批准……这就是一个简单的工作流。

• 本文将使用Odoo框架，开发一个简单的workflow模块，代码解释将嵌套在源码中

文件结构

文件结构

Model创建(models.py)

• 注意在init.py 文件中导入你的“ models.py ”模块
• Odoo 框架中的代码跟平时开发时代码规范有些许出入
• 关于@api.one 链接

# -*- coding: utf-8 -*-

from openerp import models, fields, api


class workflow_demo(models.Model):
    """
    Author  : SXY
    Date    : 2016/3/24 9:28
    Version : 1.0
    """
    _name = 'workflow_demo.workflow_demo'

    WORKFLOW_STATE_SELECTION = [
        ('init', '初始'),
        ('start', '开始'),
        ('confirm', '确认'),
        ('complete', '完成'),
    ]

    name = fields.Char(string="姓名")
    state = fields.Selection(WORKFLOW_STATE_SELECTION, default='init', string="状态", readonly=True)

    # 注意使用新版本定义方法是，需要添加装饰器@api.one/@api.multi
    # 将state 置于开始状态
    @api.one
    def do_start(self):
        print "------------self.state = 'start'"
        self.state = 'start'
        return True

    # 将state 置于确认状态
    @api.one
    def do_confirm(self):
        print "------------self.state = 'confirm'"
        self.state = 'confirm'
        return True

    # 将state 置于完成状态
    @api.one
    def do_complete(self):
        print "------------self.state = 'complete'"
        self.state = 'complete'
        return True

View 创建 (workflow_view.xml)

• 注意，关于field，官网（链接）(参见lists中的field)有如下要求：要求同一个name只能使用一次。如 <field name="state" /> 中这个“state”只能使用一次，如果多次使用，那么只显示最后使用这个"state"的标签

<?xml version="1.0" encoding="UTF-8"?>
<openerp>
    <data>
        <!-- form 视图-->
        <record id="workflow_demo_form_view" model="ir.ui.view">
            <field name="name">Workflow</field>
            <field name="type">form</field>
            <field name="model">workflow_demo.workflow_demo</field>
            <field name="arch" type="xml">
                <form string="Workflow单">
                    <!-- workflow 声明-->
                    <!-- 添加header标签用来显示workflow中的按钮-->
                    <header>
                        <!-- 首先指明button的type为workflow类型 -->
                        <!-- name 对应于workflow.transition中的signal-->
                        <!-- states 属性用来控制button显示隐藏，例如states="init"，当state属性为init时，这个button显示，否则不显示 -->
                        <button name="workflow_start" states="init" string="开始" type="workflow" class="oe_highlight"/>
                        <button name="workflow_confirm" states="start" string="确认" type="workflow" class="oe_highlight"/>
                        <button name="workflow_end" states="confirm" string="完成" type="workflow" class="oe_highlight"/>
                        <!-- 右上角 进度显示。注意在此处已经使用的state属性，所以在接下来的tree标签里面就不能再次声明<field name="state"/>了如果再次声明此处的进度显示便会失去作用 -->
                        <field name="state" widget="statusbar" statusbar_visible="start,confirm,complete"/>
                    </header>
                    <sheet>
                        <group col="4">
                            <field name="name"/>
                        </group>
                    </sheet>
                </form>
            </field>
        </record>
        <!-- tree(list)视图 -->
        <record id="workflow_demo_tree_view" model="ir.ui.view">
            <field name="name">workflow_demo</field>
            <field name="type">tree</field>
            <field name="model">workflow_demo.workflow_demo</field>
            <field name="arch" type="xml">
                <tree string="Workflow">
                    <field name="name"/>
                </tree>
            </field>
        </record>

        <record id="workflow_demo_action" model="ir.actions.act_window">
            <field name="name">Workflow</field>
            <field name="type">ir.actions.act_window</field>
            <field name="res_model">workflow_demo.workflow_demo</field>
            <field name="view_type">form</field>
            <field name="view_mode">tree,form</field>
            <field name="help" type="html">
                <p class="oe_view_nocontent_create">创建Workflow单</p>
            </field>
        </record>

        <!-- 菜单 -->
        <menuitem id="workflow_demo_main_menu" name="Workflow演示"/>
        <menuitem id="workflow_demo_sub_menu" name="Workflow演示" parent="workflow_demo_main_menu"/>
        <menuitem id="workflow_demo_item_menu" name="Workflow" parent="workflow_demo_sub_menu"
                  action="workflow_demo_action" sequence="1"/>
    </data>
</openerp>

Workflow 创建(workflow_demo.xml)

• workflow 介绍
• Workflow transitions 中的group 属性可以进行操作权限控制

<?xml version="1.0" encoding="UTF-8"?>
<openerp>
    <data>
        <!-- Workflow 工作流 -->
        <!-- https://www.odoo.com/documentation/8.0/reference/workflows.html -->
        <!-- 设置record的model为系统自带的 “workflow” -->
        <record model="workflow" id="workflow_demo">
            <field name="name">workflow_demo</field>
            <!-- 关联的model -->
            <field name="osv">workflow_demo.workflow_demo</field>
            <!-- 是否主动被实例化 -->
            <field name="on_create">True</field>
        </record>

        <!-- workflow.activity 用来指定要调用的model里的方法，一般用来更改state状态-->
        <record model="workflow.activity" id="activity_one">
            <!-- wkf_id 这个activity对应于哪个workflow,这里对应于上面声明的workflow-->
            <field name="wkf_id" ref="workflow_demo"/>
            <field name="name">workflow.demo.activity.one</field>
            <!-- dummy 类型用来指定这个activity 是workflow的开始还是结束-->
            <field name="kind">dummy</field>
            <!-- 开始是flow_start  结束是flow_end-->
            <field name="flow_start">True</field>
        </record>

        <record model="workflow.activity" id="activity_two">
            <field name="wkf_id" ref="workflow_demo"/>
            <field name="name">workflow.demo.activity.two</field>
            <!-- function 表示要执行model中的方法-->
            <field name="kind">function</field>
            <!-- 对应model中的方法-->
            <field name="action">do_start()</field>
        </record>

        <record model="workflow.activity" id="activity_three">
            <field name="wkf_id" ref="workflow_demo"/>
            <field name="name">workflow.demo.activity.three</field>
            <field name="kind">function</field>
            <field name="action">do_confirm()</field>
        </record>

        <record model="workflow.activity" id="activity_four">
            <field name="wkf_id" ref="workflow_demo"/>
            <field name="name">workflow.demo.activity.four</field>
            <field name="kind">function</field>
            <field name="action">do_complete()</field>
        </record>

        <record model="workflow.activity" id="activity_five">
            <field name="wkf_id" ref="workflow_demo"/>
            <field name="name">workflow.temp.activity.five</field>
            <field name="kind">dummy</field>
            <field name="flow_end">True</field>
        </record>

        <!-- 相当于一个转换器，用来接受button传来的信号，调用相关的activity-->
        <record model="workflow.transition" id="transition_one">
            <!-- 表示上一个执行的activity，与上面声明的activity对应-->
            <field name="act_from" ref="activity_one"/>
            <!-- 表示上一个将要执行的activity-->
            <field name="act_to" ref="activity_two"/>
            <!-- 用来做一个严重，当满足条件是才能执行，可省略-->
            <field name="condition">state == 'init'</field>
            <!-- 接收的信号 -->
            <field name="signal">workflow_start</field>
        </record>

        <record model="workflow.transition" id="transition_two">
            <field name="act_from" ref="activity_two"/>
            <field name="act_to" ref="activity_three"/>
            <field name="condition">state == 'start'</field>
            <field name="signal">workflow_confirm</field>
        </record>

        <record model="workflow.transition" id="transition_three">
            <field name="act_from" ref="activity_three"/>
            <field name="act_to" ref="activity_four"/>
            <field name="condition">state == 'confirm'</field>
            <field name="signal">workflow_end</field>
        </record>

    </data>
</openerp>

xml声明(openerp.py)

部分代码：

'data': [
        # 声明workflow的相关xml
        'views/workflow_view.xml',
        'views/workflow_demo.xml',
    ],

切记添加完workflow之后，一定要在此做一下声明，好让模块加载过程中能够对workflow进行实例化。
到此，workflow 已经基本实现

测试

• 安装模块
• 测试

test_one.png test_two.png

小结

workflow 该功能的开发要注意，workflow、workflow_activity、workflow_transition三者的关系
Odoo 相比较于现在的workflow声明方式，还有另外一种简单的方式，这种方式要在下一章节给大家介绍。
源码地址 http://git.oschina.net/tobe/OdooDemo （workflow_demo）