odoo10 学习笔记4(工作流)

现在用户已经可以在系统添加请假单了。但是还没有审批流程。先来设置一个简单的审批流程，员工填写请假单（草稿状态）->提交请假单给领导（待审批状态）->领导审批（完成状态）。
编辑类文件 models/models.py

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

from odoo import models, fields, api


class qingjiadan(models.Model):
    WORKFLOW_STATE_SELECTION = [
        ('draft', '草稿'),
        ('confirm', '待审批'),
        ('complete', '已完成')
    ]

    _name = 'qingjia.qingjiadan'
    name = fields.Char(string="申请人")
    days = fields.Integer(string="天数")
    startdate = fields.Date(string="开始日期")
    reason = fields.Text(string="请假事由")
    state = fields.Selection(WORKFLOW_STATE_SELECTION,
                             default='draft',
                             string='状态',
                             readonly=True)

    @api.multi
    def do_confirm(self):
        self.state = 'confirm'
        return True

    @api.multi
    def do_complete(self):
        self.state = 'complete'
        return True

添加了一个字段state，请假单状态，字段类型为fields.Selection,包含三个状态draft(草稿)，confirm(待审批)，complete(已完成),默认值为draft(草稿)，readonly=True属性表示在form视图下是不能修改的。
添加了两个方法do_confirm(),do_complete(),用于改变请假单状态。@api.multi修饰符还不明白用途。按钮事件方法必须有返回值，这里没有什么需要返回的值就返回return True
然后编辑视图资源文件 views/views.xml中的form视图部分

    <!-- form视图 -->
    <record id="view_form_qingjia_qingjiadan" model="ir.ui.view">
      <field name="name">请假单</field>
      <field name="model">qingjia.qingjiadan</field>
      <field name="arch" type="xml">
        <form>
          <header>
            <button name="button_confirm" states="draft"
                    string="提交" type="workflow" class="oe_highlight"/>
            <button name="button_complete" states="confirm"
                    string="批准" type="workflow" class="oe_highlight"
                    groups="base.group_user"/>
            <!-- 右上角 进度显示。-->
            <field name="state" widget="statusbar"/>
          </header>
          <sheet>
            <group name="group_top" string="请假单">
              <field name="name"/>
              <field name="days"/>
              <field name="startdate"/>
              <field name="reason"/>
            </group>            
          </sheet>
        </form>
      </field>
    </record>

添加了<header>...</header>节，名称可知这是表单布局的头部。其中添加了三个元素，两个按钮，一个状态条。
按钮的属性：
name:
指定按钮点击后的事件名，对应工作流的activity，后面会看到
states:
表示按钮在什么状态下显示，对应state字段的值
type:
工作流的按钮固定值workflow
class:
按钮的class样式，oe_highlight样式为高亮显示
groups:
这里就是上一节提到的第三级权限，字段级权限

状态条属性：
name:
状态条绑定字段名
widget:
类型，状态条固定值statusbar

在tree视图中加入state字段显示

<!-- tree视图 -->
<record id="view_tree_qingjia_qingjiadan" model="ir.ui.view">
  <field name="name">请假单列表</field>
  <field name="model">qingjia.qingjiadan</field>
  <field name="arch" type="xml">
    <tree>
      <field name="name"/>
      <field name="days"/>
      <field name="startdate"/>
      <field name="state"/>
    </tree>
  </field>
</record> 

新建工作流资源文件views/workflow.xml
添加工作流：

<!-- 工作流 -->
<record id="workflow_qingjia_qingjiadan" model="workflow">
    <field name="name">请假单工作流</field>
    <field name="osv">qingjia.qingjiadan</field>
    <field name="on_create">True</field>
</record>

这个文件中定义了一个工作流，id为workflow_qingjia_qingjiadan。三个工作流活动，id分别为activity_draft,activity_confirm,activity_complete,两个工作流流转，id分别为transition_draft2confirm,transition_confirm2complete。工作流属性：
model:
工作流模型，固定为workflow
name:
工作流名称，任意填写
osv:
工作流绑定的对象模型
on_create:
创建一个绑定的对象模型的对象时，是否自动生成一个工作流对象。说起来有点绕口，其实就是创建一个请假单时，自动创建一个请假单工作流对象。

添加工作流活动：

<!-- 工作流活动 -->
<record id="activity_draft" model="workflow.activity">
    <field name="name">草稿</field>
    <field name="wkf_id">workflow_qingjia_qingjiadan</field>
    <field name="kind">dummy</field>
    <field name="flow_start">True</field>
</record>
<record id="activity_confirm" model="workflow.activity">
    <field name="name">待审核</field>
    <field name="wkf_id">workflow_qingjia_qingjiadan</field>
    <field name="kind">function</field>
    <field name="action">do_confirm()</field>
</record>
<record id="activity_complete" model="workflow.activity">
    <field name="name">已完成</field>
    <field name="wkf_id">workflow_qingjia_qingjiadan</field>
    <field name="kind">function</field>
    <field name="action">do_complete()</field>
</record>

model:
工作流活动模型，固定为workflow.activity
name:
工作流活动名称，任意填写
wkf_id:
工作流活动所属的工作流id
kind:
工作流活动类型，有三个可选项，'dummy'不执行任何动作，'function'执行action中定义的python代码，并且执行action_id中定义的server action,'subflow'触发subflow_id中指定的工作流。
flow_start:
表示流程的开始节点

添加工作流流转：

<!-- 工作流流转 -->
<record id="transition_draft2confirm" model="workflow.transition">
    <field name="act_from">activity_draft</field>
    <field name="act_to">activity_confirm</field>
    <field name="signal">button_confirm</field>
</record>
<record id="transition_confirm2complete" model="workflow.transition">
    <field name="act_from">activity_confirm</field>
    <field name="act_to">activity_complete</field>
    <field name="signal">button_complete</field>
</record>

model:
工作流流转模型，固定为workflow.transition
act_from:
流转起始的工作流活动id
act_to:
流转结束的工作流活动id
signal:
触发流转的信号，还记得前面在form视图中添加的工作流按钮

<button name="button_confirm" states="draft"
    string="提交" type="workflow" class="oe_highlight"/>
<button name="button_complete" states="confirm"
    string="批准" type="workflow" class="oe_highlight"
    groups="base.group_user"/>

按钮name值就是发出的信号，触发对应的流转。

最后工作流资源文件views/workflow.xml是这样的：

<?xml version="1.0" encoding="UTF-8"?>
<openerp>
  <data>
      <!-- 工作流 -->
      <record id="workflow_qingjia_qingjiadan" model="workflow">
          <field name="name">请假单工作流</field>
          <field name="osv">qingjia.qingjiadan</field>
          <field name="on_create">True</field>
      </record>

      <!-- 工作流活动 -->
      <record id="activity_draft" model="workflow.activity">
          <field name="name">草稿</field>
          <field name="wkf_id" ref="workflow_qingjia_qingjiadan"/>
          <field name="kind">dummy</field>
          <field name="flow_start">True</field>
      </record>
      <record id="activity_confirm" model="workflow.activity">
          <field name="name">待审核</field>
          <field name="wkf_id" ref="workflow_qingjia_qingjiadan"/>
          <field name="kind">function</field>
          <field name="action">do_confirm()</field>
      </record>
      <record id="activity_complete" model="workflow.activity">
          <field name="name">已完成</field>
          <field name="wkf_id" ref="workflow_qingjia_qingjiadan"/>
          <field name="kind">function</field>
          <field name="action">do_complete()</field>
      </record>

      <!-- 工作流流转 -->
      <record id="transition_draft2confirm" model="workflow.transition">
          <field name="act_from">activity_draft</field>
          <field name="act_to">activity_confirm</field>
          <field name="signal">button_confirm</field>
      </record>
      <record id="transition_confirm2complete" model="workflow.transition">
          <field name="act_from">activity_confirm</field>
          <field name="act_to">activity_complete</field>
          <field name="signal">button_complete</field>
      </record>

  </data>
</openerp>

编辑配置文件__manifest__.py，添加对工作流资源文件views/workflow.xml载入：

# always loaded
'data': [
    'security/ir.model.access.csv',
    'views/workflow.xml',
    'views/views.xml',
    'views/templates.xml',
],

好了，代码编辑完了，可以测试下效果。因为修改了python代码文件，所以需要重启服务，然后升级请假模块。也可以把之前的模块卸载后再次安装，不过卸载模块会将之前的数据也清空，这里因为在表中新建了字段，所以我是直接卸载后重新安装的。
用user1用户登录系统，创建一个请假单，并保存。