现在用户已经可以在系统添加请假单了。但是还没有审批流程。先来设置一个简单的审批流程,员工填写请假单(草稿状态)->提交请假单给领导(待审批状态)->领导审批(完成状态)。
编辑类文件 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用户登录系统,创建一个请假单,并保存。
我们看到在头部出现的
提交
按钮,状态条,并显示默认的草稿
状态。提交后,出现了
审批
按钮,显示待审批
状态。批准后,无按钮,显示
已完成
状态。工作流都按预期执行了,但是这里有点问题,就是自己有权限审批自己的请假单,这是因为权限配置的问题,我们把
审批
按钮的权限给到了base.group_user
组,而我们知道这是一个默认全部账号都有的基本组。下次我们来解决这个问题。