odoo -u academy -d academy
openacademy官网完整教程
- 练习创建模块
使用上面的命令行创建一个空模块Open Academy,并将其安装在Odoo中。
odoo scaffold openacademy myaddons
- 练习定义模型,
在openacademy模块中定义新的数据模型课程,每门课程包含两个字段,标题和描述,其中标题是必填字段。编辑文件openacademy/models/models.py
以包含Course
类。
openacademy/models/models.py
from odoo import models, fields, api
class Course(models.Model):
#定义了两个字段name,description
_name = 'openacademy.course'
name = fields.Char(string="Title", required=True)
description = fields.Text()
- 练习定义演示数据,
添加演示数据以填充Course模型的数据,编辑文件openacademy/demo/demo.xml
来添加演示数据
openacademy/demo/demo.xml
<odoo>
<data>
<record model="openacademy.course" id="course0">
<field name="name">Course 0</field>
<field name="description">Course 0's description
Can have multiple lines
</field>
</record>
<record model="openacademy.course" id="course1">
<field name="name">Course 1</field>
<!-- no description for this one -->
</record>
<record model="openacademy.course" id="course2">
<field name="name">Course 2</field>
<field name="description">Course 2's description</field>
</record>
</data>
</odoo>
demo.xml如何起作用?
必须添加到data中
'data': [
# 'security/ir.model.access.csv',
'views/views.xml',
'views/templates.xml',
'demo/demo.xml',
],
添加到demo中不起作用
- 练习定义新菜单项,
在开放学院菜单项下定义新菜单项来访问课程。用户应该能够:
显示所有课程的列表
建立或编辑课程
1.建立openacademy/views/openacademy.xml
以创建操作和能够触发操作的菜单项。
2.添加这个文件到openacademy/__manifest__.py
下的data列表。
编写菜单(menuitem)和行为(action)
<?xml version="1.0" encoding="UTF-8"?>
<odoo>
<data>
<!-- window action -->
<!--
The following tag is an action definition for a "window action",
that is an action opening a view or a set of views
-->
<record model="ir.actions.act_window" id="course_list_action">
<field name="name">Courses</field>
<field name="res_model">openacademy.course</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">Create the first course
</p>
</field>
</record>
<!-- top level menu: no parent -->
<menuitem id="main_openacademy_menu" name="Open Academy"/>
<!-- A first level in the left side menu is needed
before using action= attribute -->
<menuitem id="openacademy_menu" name="Open Academy"
parent="main_openacademy_menu"/>
<!-- the following menuitem should appear *after*
its parent openacademy_menu and *after* its
action course_list_action -->
<menuitem id="courses_menu" name="Courses" parent="openacademy_menu"
action="course_list_action"/>
<!-- Full id location:
action="openacademy.course_list_action"
It is not required when it is the same module -->
</data>
</odoo>
- 练习使用XML定制窗体视图
建立课程对象的表单视图,显示课程的名称和描述字段。
- 练习notebook结构元素
在课程的表单视图中,将描述字段放在一个选项卡中,然后再添加选项卡放置其它字段。修改后的课程表单视图如下:
openacademy/views/openacademy.xml
<!--form视图 Course-->
<record model="ir.ui.view" id="view_form_openacademy_course">
<field name="name">course.form</field>
<field name="model">openacademy.course</field>
<field name="arch" type="xml">
<form string="Course Form">
<sheet>
<group>
<field name="name"/>
<field name="description"/>
</group>
<!--notebook标签页-->
<notebook>
<!--描述-->
<page string="Description">
<field name="description"/>
</page>
</notebook>
</sheet>
</form>
</field>
</record>
notebook效果:
当然也可以用纯HTML页面写
- 练习搜索课程
通过标题和描述来搜索课程。
<!--搜索视图 Course-->
<record model="ir.ui.view" id="course_search_view">
<field name="name">course.search</field>
<field name="model">openacademy.course</field>
<field name="arch" type="xml">
<search>
<field name="name"/>
<field name="description"/>
<filter name="my_courses" string="My Courses"
domain="[('responsible_id', '=', uid)]"/>
<group string="Group By">
<filter name="by_responsible" string="Responsible"
context="{'group_by': 'responsible_id'}"/>
</group>
</search>
</field>
</record>
- 练习建立一个授课模型
在开放学院模块中,我们考虑一个授课模型:一个授课是在给定的时间中对给定的受众教授指定的课程。为授课建立模型,授课包括名称、开始时间、持续时间和席位数。添加操作和菜单项来显示新的模型。
openacademy/models.py
class Session(models.Model):
_name = 'openacademy.session'
name = fields.Char(required=True)
start_date = fields.Date()
duration = fields.Float(digits=(6, 2), help="Duration in days")
seats = fields.Integer(string="Number of seats")
openacademy/views/openacademy.xml
<!-- session form view -->
<record model="ir.ui.view" id="session_form_view">
<field name="name">session.form</field>
<field name="model">openacademy.session</field>
<field name="arch" type="xml">
<form string="Session Form">
<sheet>
<group>
<field name="name"/>
<field name="start_date"/>
<field name="duration"/>
<field name="seats"/>
</group>
</sheet>
</form>
</field>
</record>
<record model="ir.actions.act_window" id="session_list_action">
<field name="name">Sessions</field>
<field name="res_model">openacademy.session</field>
<field name="view_type">form</field>
<field name="view_mode">tree,form</field>
</record>
<menuitem id="session_menu" name="Sessions"
parent="openacademy_menu"
action="session_list_action"/>
- 练习Many2one关联
编辑Course和Session模型以反映他们与其它模型的关联:
- 课程有一个负责的用户;该字段的值是内置模型
res.users
的记录
#class Course(models.Model)
responsible_id = fields.Many2one('res.users',
ondelete='set null', string="Responsible", index=True)
- 一个授课有一个教师;该字段的值是内置模型
res.partner
的记录
#class Session(models.Model)
instructor_id = fields.Many2one('res.partner', string="Instructor")
- 授课与课程相关;该字段的值是
openacademy.course
模型的记录,并且是必填项
#class Session(models.Model)
course_id = fields.Many2one('openacademy.course',
ondelete='cascade', string="Course", required=True)
- 在模型中添加Many2one关联,并在视图显示
#form视图
<record model="ir.ui.view" id="view_form_openacademy_course">
<field name="name">course.form</field>
<field name="model">openacademy.course</field>
<field name="arch" type="xml">
<form string="Course Form">
<sheet>
<group>
<field name="name"/>
<field name="description"/>
<field name="responsible_id"/>
</group>
<!--notebook标签页-->
<notebook>
<!--描述-->
<page string="Description">
<field name="description"/>
</page>
</notebook>
</sheet>
</form>
</field>
</record>
<record model="ir.ui.view" id="course_tree_view">
<field name="name">course.tree</field>
<field name="model">openacademy.course</field>
<field name="arch" type="xml">
<tree string="Course Tree">
<field name="name"/>
<field name="description"/>
<field name="responsible_id"/>
</tree>
</field>
</record>
多对一关系
关联字段
Many2one(other_model, ondelete='set null')
多对一字段
一个链接到其它对象的简单示例是这样的:
print foo.other_id.name
One2many(other_model, related_field)
一对多模型,通过for循环遍历
这是一个虚拟的关联,是Many2one的逆,One2many作为记录的容器,访问它将返回一个记录集(也可能是一个空记录集):
for other in foo.other_ids:
print other.name
-
练习逆关联One2many
使用逆关联字段one2many,编辑模型以反映课程和授课之间的关系。 -
编辑Course类,并且加入字段到它的表单视图
#class Course(models.Model)
session_ids = fields.One2many(
'openacademy.session', 'course_id', string="Sessions")
<!--form视图 Course-->
<record model="ir.ui.view" id="course_form_view">
<field name="name">course.form</field>
<field name="model">openacademy.course</field>
<field name="arch" type="xml">
<form string="Course Form">
<sheet>
<group>
<field name="name"/>
<field name="responsible_id"/>
</group>
<!--notebook标签页-->
<notebook>
<!--描述-->
<page string="Description">
<field name="description"/>
</page>
<!--域-->
<page string="Sessions">
<field name="session_ids">
<tree string="Registered sessions">
<field name="name"/>
<!--instructor_id授课教师与课程的捆绑-->
<field name="instructor_id"/>
</tree>
</field>
</page>
</notebook>
</sheet>
</form>
</field>
</record>
notebook中添加了session
-
练习多对多关联many2many
在授课模型中添加关联字段many2many,将每次授课和参与的听众做关联,听众来自于内置模型res.partner
。相应的调整对应的视图。 -
修改Session类并且加入字段到它的表单视图中
# class Session(models.Model)
attendee_ids = fields.Many2many('res.partner', string="Attendees")
视图
<record model="ir.ui.view" id="session_form_view">
<field name="name">session.form</field>
<field name="model">openacademy.session</field>
<field name="arch" type="xml">
<form string="Session Form">
<sheet>
<group>
<field name="name"/>
<field name="start_date"/>
<field name="duration"/>
<field name="seats"/>
</group>
<!--授课和参与的听众做关联,听众来自于内置模型res.partner-->
<label for="attendee_ids"/>
<field name="attendee_ids"/>
</sheet>
</form>
</field>
</record>
-
练习更改现有内容
-
使用模型继承,修改现有partner模型,添加
instructor
布尔字段,以及对应表示"授课-讲师"关联的many2many字段 -
使用视图继承在partner的表单视图中显示这个字段
注意,这里是通过开发人员模式来查找视图外部ID并放置新字段的。
- 创建文件openacademy/models/partner.py并将其导入__init__.py
- 创建文件openacademy/views/partner.xml并将其添加到__manifest__.py
res.partner表的路径
odooodoo10odooaddonsase es es_partner.py
odooodoo10odooaddonsproductviews es_partner_views.xml
openacademy/models/init.py
from . import models
from . import partner
openacademy/manifest.py
# always loaded
'data': [
# 'security/ir.model.access.csv',
'views/openacademy.xml',
'views/templates.xml',
'views/partner.xml',
'demo/demo.xml',
],
openacademy/partner.py
# -*- coding: utf-8 -*-
from odoo import fields, models
class Partner(models.Model):
_inherit = 'res.partner'
# Add a new column to the res.partner model, by default partners are not
# instructors
instructor = fields.Boolean("Instructor", default=False)
session_ids = fields.Many2many('openacademy.session',
string="Attended Sessions", readonly=True)
openacademy/views/partner.xml
<?xml version="1.0" encoding="utf-8" ?>
<odoo>
<data>
<!-- Add instructor field to existing view -->
<!--form视图-->
<record model="ir.ui.view" id="partner_instructor_form_view">
<field name="name">partner.instructor</field>
<field name="model">res.partner</field>
<field name="inherit_id" ref="base.view_partner_form"/>
<field name="arch" type="xml">
<notebook position="inside">
<page string="Sessions">
<group>
<field name="instructor"/>
<field name="session_ids"/>
</group>
</page>
</notebook>
</field>
</record>
<record model="ir.actions.act_window" id="contact_list_action">
<field name="name">Contacts</field>
<field name="res_model">res.partner</field>
<field name="view_mode">tree,form</field>
</record>
<menuitem id="configuration_menu" name="Configuration"
parent="main_openacademy_menu"/>
<menuitem id="contact_menu" name="Contacts"
parent="configuration_menu"
action="contact_list_action"/>
<record model="ir.actions.act_window" id="contact_cat_list_action">
<field name="name">Contact Tags</field>
<field name="res_model">res.partner.category</field>
<field name="view_mode">tree,form</field>
</record>
<menuitem id="contact_cat_menu" name="Contact Tags"
parent="configuration_menu"
action="contact_cat_list_action"/>
<record model="res.partner.category" id="teacher1">
<field name="name">Teacher / Level 1</field>
</record>
<record model="res.partner.category" id="teacher2">
<field name="name">Teacher / Level 2</field>
</record>
</data>
</odoo>
<field name="inherit_id" ref="base.view_partner_form"/>
视图继承
odooodoo10odooaddonsproductviews
es_partner_views.xml
- 练习在关联字段上使用Domain,
当为授课选取讲师时,只有instructor值为True的讲师会被显示出来。
注意
声明为文字列表的domain会在服务端进行计算,不会出现在右侧的动态列表中,而声明为字符串的domain是在客户端进行计算的,字段名将出现在右侧列表。
#class Session(models.Model)
instructor_id = fields.Many2one('res.partner', string="Instructor",
domain=[('instructor', '=', True)])
- 练习更复杂的domain,创建新的partner类别Techer/Level1和Techer/Level2.一个授课的教授人可以是讲师或者任意级别的教师。
<!-- Add instructor field to existing view -->
<!--form视图-->
<record model="ir.ui.view" id="partner_instructor_form_view">
<field name="name">partner.instructor</field>
<field name="model">res.partner</field>
<!--继承-->
<field name="inherit_id" ref="base.view_partner_form"/>
<field name="arch" type="xml">
<notebook position="inside">
<page string="Sessions">
<group>
<field name="instructor"/>
<field name="session_ids"/>
</group>
</page>
</notebook>
</field>
</record>
<!--定义行为-->
<record model="ir.actions.act_window" id="contact_list_action">
<field name="name">Contacts</field>
<field name="res_model">res.partner</field>
<field name="view_mode">tree,form</field>
</record>
<!--菜单-->
<menuitem id="configuration_menu" name="Configuration"
parent="main_openacademy_menu"/>
<menuitem id="contact_menu" name="Contacts"
parent="configuration_menu"
action="contact_list_action"/>
<record model="ir.actions.act_window" id="contact_cat_list_action">
<field name="name">Contact Tags</field>
<field name="res_model">res.partner.category</field>
<field name="view_mode">tree,form</field>
</record>
<menuitem id="contact_cat_menu" name="Contact Tags"
parent="configuration_menu"
action="contact_cat_list_action"/>
<!-- 定义分类-->
<record model="res.partner.category" id="teacher1">
<field name="name">Teacher / Level 1</field>
</record>
<record model="res.partner.category" id="teacher2">
<field name="name">Teacher / Level 2</field>
</record>
视图继承路径odooodoo10odooaddonsproductviews es_partner_views.xml
-
练习计算字段
-
加入座席占用百分比字段到授课模型。
-
在列表视图和表单视图中显示这个字段
-
以进度条的方式显示这个字段
#class Session(models.Model)
taken_seats = fields.Float(string="Taken seats", compute='_taken_seats')
@api.depends('seats', 'attendee_ids') #依赖的任一字段变化时(ORM or Form),触发该函数执行
def _taken_seats(self):
for r in self:
if not r.seats:
r.taken_seats = 0.0
else:
r.taken_seats = 100.0 * len(r.attendee_ids) / r.seats
<field name="taken_seats" widget="progressbar"/>
progresbar进度条
- 练习默认值
定义start_date
默认值为今天
在授课类添加字段active
,并且设置其默认值为True
class Session(models.Model):
start_date = fields.Date(default=fields.Date.today)
active = fields.Boolean(default=True)
注意
Odoo 有内置规则:active字段值为False时记录不可见
- 练习
通过"onchange"机制显示的验证无效值,例如座位数为负数或者座位数多与参与者。
#class Session(models.Model)
@api.onchange('seats', 'attendee_ids')
def _verify_valid_seats(self):
if self.seats < 0:
return {
'warning': {
'title': "Incorrect 'seats' value",
'message': "The number of available seats may not be negative",
},
}
if self.seats < len(self.attendee_ids):
return {
'warning': {
'title': "Too many attendees",
'message': "Increase seats or remove excess attendees",
},
}
- 练习添加Python约束,讲师不能在自己的授课出席人中
import exceptions
#class Session(models.Model):
@api.constrains('instructor_id', 'attendee_ids') #讲师不能在自己的授课出席人中
def _check_instructor_not_in_attendees(self):
for r in self:
if r.instructor_id and r.instructor_id in r.attendee_ids:
raise exceptions.ValidationError("A session's instructor can't be an attendee")
- 练习添加重复项,因为我们为课程名称添加了唯一性约束,所以不能再使用"复制"功能(表单->复制)。重写"复制"方法,允许复制课程对象,将原始名称更改为"原始名称的副本"。
#class Course(models.Model)
@api.multi
def copy(self, default=None):
default = dict(default or {})
print '--------------'
print self.name
print '--------------'
copied_count = self.search_count(
[('name', '=like', u"Copy of {}%".format(self.name))])
if not copied_count:
new_name = u"Copy of {}".format(self.name)
else:
new_name = u"Copy of {} ({})".format(self.name, copied_count)
default['name'] = new_name
return super(Course, self).copy(default)
<record model="ir.ui.view" id="session_form_view">
<field name="name">session.form</field>
<field name="model">openacademy.session</field>
<field name="arch" type="xml">
<form string="Session Form">
<!--<sheet>-->
<!--<group>-->
<!--<field name="course_id"/>-->
<!--<field name="name"/>-->
<!--<field name="start_date"/>-->
<!--<field name="duration"/>-->
<!--<field name="seats"/>-->
<!--<field name="instructor_id"/>-->
<!--</group>-->
<!--<!–授课和参与的听众做关联,听众来自于内置模型res.partner–>-->
<!--<label for="attendee_ids"/>-->
<!--<field name="attendee_ids"/>-->
<!--</sheet>-->
<sheet>
<group>
<group string="General">
<field name="course_id"/>
<field name="name"/>
<field name="instructor_id"/>
<field name="active"/>
</group>
<group string="Schedule">
<field name="start_date"/>
<!--<field name="end_date"/>-->
<field name="duration"/>
<!--<field name="hours"/>-->
<field name="seats"/>
<field name="taken_seats" widget="progressbar"/>
</group>
</group>
<label for="attendee_ids"/>
<field name="attendee_ids"/>
</sheet>
</form>
</field>
</record>
打印出来的name,default
--------------
语文
--------------
{'name': u'Copy of u8bedu6587'}
高级视图
- 练习列表着色
编辑授课的树视图,使得持续时间少于5天的授课以蓝色显示,持续时间超过15天的授课以红色显示。编辑授课的树视图:
<record model="ir.ui.view" id="session_tree_view">
<field name="name">session.tree</field>
<field name="model">openacademy.session</field>
<field name="arch" type="xml">
<tree string="Session Tree" decoration-info="duration<5" decoration-danger="duration>15">
<field name="name"/>
<field name="course_id"/>
<field name="duration" invisible="1"/>
<field name="taken_seats" widget="progressbar"/>
<field name="state"/>
</tree>
</field>
</record>
-
练习日历视图
给授课模型添加一个日历视图,使用户可以查看与开放学院相关联的事件。 -
添加一个计算字段
end_date
,通过start_date
和duration
计算获得。 -
反函数使字段可写,并允许在日历视图中移动授课(通过拖放操作)
-
向授课模型添加日历视图
-
添加日历视图到授课模型的动作中
models.py
from datetime import timedelta
# class Session(models.Model)
end_date = fields.Date(string="End Date", store=True,
compute='_get_end_date', inverse='_set_end_date') #结束日期
@api.depends('start_date', 'duration') #计算end_date结束日期
def _get_end_date(self):
for r in self:
if not (r.start_date and r.duration):
r.end_date = r.start_date
continue
# Add duration to start_date, but: Monday + 5 days = Saturday, so
# subtract one second to get on Friday instead
start = fields.Datetime.from_string(r.start_date)
duration = timedelta(days=r.duration, seconds=-1)
r.end_date = start + duration
def _set_end_date(self):
for r in self:
if not (r.start_date and r.end_date):
continue
# Compute the difference between dates, but: Friday - Monday = 4 days,
# so add one day to get 5 days instead
start_date = fields.Datetime.from_string(r.start_date)
end_date = fields.Datetime.from_string(r.end_date)
r.duration = (end_date - start_date).days + 1
-
练习搜索视图
-
在课程搜索视图中添加按钮,用以筛选当前用户负责的课程,并且作为默认选择。
-
再添加一个分组按钮,用于对当前用户负责的课程进行分组。
<!--搜索视图 Course-->
<record model="ir.ui.view" id="course_search_view">
<field name="name">course.search</field>
<field name="model">openacademy.course</field>
<field name="arch" type="xml">
<search>
<field name="name"/>
<field name="description"/>
<filter name="my_courses" string="My Courses"
domain="[('responsible_id', '=', uid)]"/>
<group string="Group By">
<filter name="by_responsible" string="Responsible"
context="{'group_by': 'responsible_id'}"/>
</group>
</search>
</field>
</record>
<!--动作定义-->
<record model="ir.actions.act_window" id="course_list_action">
<field name="name">Courses</field>
<field name="res_model">openacademy.course</field>
<field name="view_type">form</field>
<field name="view_mode">tree,form</field>
<!--在课程搜索视图中添加按钮,用以筛选当前用户负责的课程,并且作为默认选择 默认选择的规则-->
<field name="context" eval="{'search_default_my_courses': 1}"/>
<field name="help" type="html">
<p class="oe_view_nocontent_create">Create the first course
</p>
</field>
</record>
- 练习甘特图
添加甘特图使用户可以查看授课的日程排期,授课将按讲师分组。
- 创建一个计算字段,表示以小时计算的授课持续时间
- 添加甘特图,并且将甘特图添加到授课模型的action上。
<!--甘特图-->
<record model="ir.ui.view" id="session_gantt_view">
<field name="name">session.gantt</field>
<field name="model">openacademy.session</field>
<field name="arch" type="xml">
<gantt string="Session Gantt" color="course_id"
date_start="start_date" date_delay="hours"
default_group_by='instructor_id'>
<field name="name"/>
</gantt>
</field>
</record>
-
练习图形视图
在授课对象中添加图形视图,为每个课程在条形视图下显示出席人数。 -
添加字段将出席人数这计算字段存储在数据库
-
添加相关图形视图
<!--图形视图-->
<record model="ir.ui.view" id="openacademy_session_graph_view">
<field name="name">openacademy.session.graph</field>
<field name="model">openacademy.session</field>
<field name="arch" type="xml">
<graph string="Participations by Courses">
<field name="course_id"/>
<field name="attendees_count" type="measure"/>
</graph>
</field>
</record>
-
练习看板视图
添加显示按课程分组的授课看板视图(列是课程) -
授课模型中添加整型字段color
-
添加看板视图并更新action
color = fields.Integer()
<!--看板视图-->
<record model="ir.ui.view" id="view_openacad_session_kanban">
<field name="name">openacad.session.kanban</field>
<field name="model">openacademy.session</field>
<field name="arch" type="xml">
<kanban default_group_by="course_id">
<field name="color"/>
<templates>
<t t-name="kanban-box">
<div
t-attf-class="oe_kanban_color_{{kanban_getcolor(record.color.raw_value)}}
oe_kanban_global_click_edit oe_semantic_html_override
oe_kanban_card {{record.group_fancy==1 ? 'oe_kanban_card_fancy' : ''}}">
<div class="oe_dropdown_kanban">
<!-- dropdown menu -->
<div class="oe_dropdown_toggle">
<i class="fa fa-bars fa-lg"/>
<ul class="oe_dropdown_menu">
<li>
<a type="delete">Delete</a>
</li>
<li>
<ul class="oe_kanban_colorpicker"
data-field="color"/>
</li>
</ul>
</div>
<div class="oe_clear"></div>
</div>
<div t-attf-class="oe_kanban_content">
<!-- title -->
Session name:
<field name="name"/>
<br/>
Start date:
<field name="start_date"/>
<br/>
duration:
<field name="duration"/>
</div>
</div>
</t>
</templates>
</kanban>
</field>
</record>
<record model="ir.actions.act_window" id="session_list_action">
<field name="name">Sessions</field>
<field name="res_model">openacademy.session</field>
<field name="view_type">form</field>
<field name="view_mode">tree,form,calendar,gantt,graph,kanban</field>
</record>
工作流和安全
- 练习伪工作流
在授课模型上添加一个字段state,用于定义一个工作流程。授课存在三个可能的状态:Draft(草稿,默认值)、Confirmed(已确认)、Done(已完成)。在授课的form视图中,添加一个只读字段用于显示课程状态,并可以通过按钮来改变状态。有效的状态值迁移包括:
- Draft->Confirmed
- Confirmed->Draft
- Confirmed->Done
- Done->Draft
- 添加一个新的字段state
- 添加状态迁移方法,这个方法可以被form表单的按钮所调用,用以更改授课的状态
- 将相关按钮添加到授课的form视图
- openacademy/models.py
#class Session(models.Model):
state = fields.Selection([
('draft', "Draft"),
('confirmed', "Confirmed"),
('done', "Done"),
], default='draft') #工作流状态
<odoo>
<data>
<!--工作流-->
<record model="workflow" id="wkf_session">
<field name="name">OpenAcademy sessions workflow</field>
<field name="osv">openacademy.session</field>
<field name="on_create">True</field>
</record>
<record model="ir.actions.server" id="set_session_to_draft">
<field name="name">Set session to Draft</field>
<field name="model_id" ref="model_openacademy_session"/>
<field name="code">
model.search([('id', 'in', context['active_ids'])]).action_draft()
</field>
</record>
<!--工作流活动-->
<record model="workflow.activity" id="draft">
<field name="name">Draft</field>
<field name="wkf_id" ref="wkf_session"/>
<field name="flow_start" eval="True"/>
<field name="kind">dummy</field>
<field name="action"></field>
<field name="action_id" ref="set_session_to_draft"/>
</record>
<!--服务器-->
<record model="ir.actions.server" id="set_session_to_confirmed">
<field name="name">Set session to Confirmed</field>
<field name="model_id" ref="model_openacademy_session"/>
<field name="code">
model.search([('id', 'in', context['active_ids'])]).action_confirm()
</field>
</record>
<record model="workflow.activity" id="confirmed">
<field name="name">Confirmed</field>
<field name="wkf_id" ref="wkf_session"/>
<field name="kind">dummy</field>
<field name="action"></field>
<field name="action_id" ref="set_session_to_confirmed"/>
</record>
<record model="ir.actions.server" id="set_session_to_done">
<field name="name">Set session to Done</field>
<field name="model_id" ref="model_openacademy_session"/>
<field name="code">
model.search([('id', 'in', context['active_ids'])]).action_done()
</field>
</record>
<record model="workflow.activity" id="done">
<field name="name">Done</field>
<field name="wkf_id" ref="wkf_session"/>
<field name="kind">dummy</field>
<field name="action"></field>
<field name="action_id" ref="set_session_to_done"/>
</record>
<!-- 工作流流转 -->
<record model="workflow.transition" id="session_draft_to_confirmed">
<field name="act_from" ref="draft"/>
<field name="act_to" ref="confirmed"/>
<field name="signal">confirm</field>
</record>
<record model="workflow.transition" id="session_confirmed_to_draft">
<field name="act_from" ref="confirmed"/>
<field name="act_to" ref="draft"/>
<field name="signal">draft</field>
</record>
<record model="workflow.transition" id="session_done_to_draft">
<field name="act_from" ref="done"/>
<field name="act_to" ref="draft"/>
<field name="signal">draft</field>
</record>
<record model="workflow.transition" id="session_confirmed_to_done">
<field name="act_from" ref="confirmed"/>
<field name="act_to" ref="done"/>
<field name="signal">done</field>
</record>
<record model="workflow.transition" id="session_auto_confirm_half_filled">
<field name="act_from" ref="draft"/>
<field name="act_to" ref="confirmed"/>
<field name="condition">taken_seats > 50</field>
</record>
</data>
</odoo>
-
练习工作流
使用真正的授课工作流替换之前的伪工作流。修改授课的form视图,按钮将调用工作流而不是调用模型的方法。 -
练习自动状态迁移
当超过一半座席被保留时,自动将授课的状态从Draft迁移到Confirmed。
当定义了工作流,需要卸载模块,否则原来定义好的数据无法进入工作流(可以直接修改数据库)
<record model="workflow.transition" id="session_auto_confirm_half_filled">
<field name="act_from" ref="draft"/>
<field name="act_to" ref="confirmed"/>
<field name="condition">taken_seats > 50</field>
</record>
</data>
</odoo>
- 练习服务器动作
用服务器动作替换用于同步授课状态的Python方法。工作流和服务器动作都可以从UI创建。
<record model="ir.actions.server" id="set_session_to_draft">
<field name="name">Set session to Draft</field>
<field name="model_id" ref="model_openacademy_session"/>
<field name="code">
model.search([('id', 'in', context['active_ids'])]).action_draft()
</field>
</record>
<record model="workflow.activity" id="draft">
<field name="name">Draft</field>
<field name="wkf_id" ref="wkf_session"/>
<field name="flow_start" eval="True"/>
<field name="kind">dummy</field>
<field name="action"></field>
<field name="action_id" ref="set_session_to_draft"/>
</record>
<record model="ir.actions.server" id="set_session_to_confirmed">
<field name="name">Set session to Confirmed</field>
<field name="model_id" ref="model_openacademy_session"/>
<field name="code">
model.search([('id', 'in', context['active_ids'])]).action_confirm()
</field>
</record>
<record model="workflow.activity" id="confirmed">
<field name="name">Confirmed</field>
<field name="wkf_id" ref="wkf_session"/>
<field name="kind">dummy</field>
<field name="action"></field>
<field name="action_id" ref="set_session_to_confirmed"/>
</record>
<record model="ir.actions.server" id="set_session_to_done">
<field name="name">Set session to Done</field>
<field name="model_id" ref="model_openacademy_session"/>
<field name="code">
model.search([('id', 'in', context['active_ids'])]).action_done()
</field>
</record>
<record model="workflow.activity" id="done">
<field name="name">Done</field>
<field name="wkf_id" ref="wkf_session"/>
<field name="kind">dummy</field>
<field name="action"></field>
<field name="action_id" ref="set_session_to_done"/>
</record>
- 练习
通过Odoo界面添加访问控制权限
建立一个新用户John Smit
,然后建立OpenAcademy/Session Read
组,并赋予这个组对授课模型的读权限。
- 建立一个新用户
John Smit
通过 设置->用户->用户 - 建立一个新组
session_read
通过 设置->用户->组,这个组拥有对授课模型的读权限 - 编辑
John Smith
用户,把他加入到session_read
组 - 以
John Smith
身份登录系统,检查权限是否正确。
-
练习
通过数据文件添加访问控制权限: -
建立一个组OpenAcademy / Manager,这个组对开放学院的所有模型都有完全权限。
-
让Session和Course对所有用户可读
- 建立新的文件openacademy/security/security.xml用来定义OpenAcademy Manager组
- 编辑文件openacademy/security/ir.model.access.csv来添加对模型的访问权限
- 最后更新openacademy/manifest.py来添加新的数据文件
openacademy/__manifest__.py
注意security.xml顺序,优先加载security.xml 然后加载csv,否则报错
Exception: Module loading openacademy failed: file openacademy/security/ir.model.access.csv could not be processed:
在字段'Group'中没找到匹配的记录外部id 'group_manager'
在字段'Group'中没找到匹配的记录外部id 'group_manager'
在字段'Object'中没找到匹配的记录外部id 'model_scheduler_demo'
在字段'Group'中没找到匹配的记录外部id 'group_manager'
'data': [
'security/security.xml',
'security/ir.model.access.csv',
'views/openacademy.xml',
'views/templates.xml',
'views/partner.xml',
'views/session_workflow.xml',
'demo/demo.xml',
],
openacademy/security/ir.model.access.csv
id,name,model_id/id,group_id/id,perm_read,perm_write,perm_create,perm_unlink
course_manager,course manager,model_openacademy_course,group_manager,1,1,1,1
session_manager,session manager,model_openacademy_session,group_manager,1,1,1,1
course_read_all,course all,model_openacademy_course,,1,0,0,0
session_read_all,session all,model_openacademy_session,,1,0,0,0
openacademy/security/security.xml
<odoo>
<data>
<record id="group_manager" model="res.groups">
<field name="name">OpenAcademy / Manager</field>
</record>
</data>
</odoo>
只能可读,不可修改
- 练习记录规则
为授课模型和OpenAcademy / Manager组添加记录规则,这个记录规则限制只有课程负责人可以对课程进行write和unlink操作,如果课程还没有负责人,这个组的所有用户都可以编辑它。在openacademy/security/security.xml
文件中创建新的规则:
openacademy/security/security.xml
<?xml version="1.0" encoding="UTF-8"?>
<odoo>
<data>
<record id="group_manager" model="res.groups">
<field name="name">OpenAcademy / Manager</field>
</record>
<record id="only_responsible_can_modify" model="ir.rule">
<field name="name">Only Responsible can modify Course</field>
<field name="model_id" ref="model_openacademy_course"/> #模型课程分组
<field name="groups" eval="[(4, ref('openacademy.group_manager'))]"/> # (4,id,_) 连接一个已经存在的记录
<field name="perm_read" eval="0"/>
<field name="perm_write" eval="1"/>
<field name="perm_create" eval="0"/>
<field name="perm_unlink" eval="1"/>
<field name="domain_force">
['|', ('responsible_id','=',False),
('responsible_id','=',user.id)]
</field>
</record>
</data>
</odoo>
只有添加到用户组里面才可以进行读写
向导与国际化
- 练习定义向导
创建一个向导模型,这个向导模型通过many2one关联授课模型,并通过many2many关联合作伙伴模型。添加新文件openacademy/wizard.py
openacademy/models/__init__.py
from . import models
from . import partner
from . import wizard
openacademy/wizard.py
# -*- coding: utf-8 -*-
from odoo import models, fields, api
class Wizard(models.TransientModel):
_name = 'openacademy.wizard'
session_ids = fields.Many2one('openacademy.session',
string="Session", required=True)
attendee_ids = fields.Many2many('res.partner', string="Attendees")
- 练习启动向导
- 为向导定义一个form视图
- 在授课模型的上下文中添加action用于启动向导
- 给向导的session字段定义默认值;使用上下文参数self._context来获取当前授课
openacademy/wizard.py
class Wizard(models.TransientModel):
_name = 'openacademy.wizard'
def _default_session(self):
return self.env['openacademy.session'].browse(self._context.get('active_id'))
session_ids = fields.Many2one('openacademy.session',
string="Session", required=True, default=_default_session)
attendee_ids = fields.Many2many('res.partner', string="Attendees")
openacademy/views/openacademy.xml
<!--定义向导视图-->
<record model="ir.ui.view" id="wizard_form_view">
<field name="name">wizard.form</field>
<field name="model">openacademy.wizard</field>
<field name="arch" type="xml">
<form string="Add Attendees">
<group>
<field name="session_ids"/>
<field name="attendee_ids"/>
</group>
<!--底部-->
<footer>
<!--订阅按钮-->
<button name="subscribe" type="object"
string="Subscribe" class="oe_highlight"/>
<!--取消按钮-->
<button special="cancel" string="Cancel"/>
</footer>
</form>
</field>
</record>
<!--定义向导行为-->
<!--关联session 定义wizard-->
<act_window id="launch_session_wizard"
name="Add Attendees"
src_model="openacademy.session"
res_model="openacademy.wizard"
view_mode="form"
target="new"
key2="client_action_multi"/>
- 练习注册与会者
给向导添加按钮,并且实现相应的方法,将与会者添加到给定的授课。
<footer>
<!--订阅按钮-->
<button name="subscribe" type="object"
string="Subscribe" class="oe_highlight"/>
<!--取消按钮-->
<button special="cancel" string="Cancel"/>
</footer>
- 练习与会者注册多个授课
修改向导模型,以便与会者可以注册到多个授课
class Wizard(models.TransientModel):
_name = 'openacademy.wizard'
def _default_sessions(self):
return self.env['openacademy.session'].browse(self._context.get('active_ids'))
print '------------------------'
print dir(self)
print '------------------------'
#字段
session_ids = fields.Many2one('openacademy.session',
string="Session", required=True)
attendee_ids = fields.Many2many('res.partner', string="Attendees")
@api.multi
def subscribe(self):
for session in self.session_ids:
session.attendee_ids |= self.attendee_ids
return {}
- 练习
翻译一个模块
为已经安装的Odoo模块选择第二语言。使用Odoo提供的功能对模块进行翻译。
- 创建目录
openacademy/i18n/
- 安装任意一种你希望的语言 (设置->翻译->加载翻译 )
- 同步翻译术语(设置->翻译->应用程序术语->同步术语)
- 导出不指定语言的翻译模板文件(设置->翻译->导入/导出->导出翻译),保存在
openacademy/i18n/
- 导出指定语言的翻译文件(设置->翻译->导入/导出->导出翻译),保存在
openacademy/i18n/
- 打开导出的翻译文件(使用任意一款文本编辑软件或者专用的PO文件编辑器,例如POEdit然后翻译其中的术语)
- 在
models.py
文件中,为odoo._
方法添加一个导入声明,并且标记需要翻译的字符串 - 重复3-6的步骤
实际上添加i18n这个文件夹,放入导出的po文件zh_cn.po文件,必须重新安装模块后,整个翻译才会生效
openacademy/models.py
下划线翻译相应的浏览器提示
from datetime import timedelta
from odoo import models, fields, api, exceptions, _
class Course(models.Model):
_name = 'openacademy.course'
default = dict(default or {})
copied_count = self.search_count(
[('name', '=like', _(u"Copy of {}%").format(self.name))])
if not copied_count:
new_name = _(u"Copy of {}").format(self.name)
else:
new_name = _(u"Copy of {} ({})").format(self.name, copied_count)
default['name'] = new_name
return super(Course, self).copy(default)
if self.seats < 0:
return {
'warning': {
'title': _("Incorrect 'seats' value"),
'message': _("The number of available seats may not be negative"),
},
}
if self.seats < len(self.attendee_ids):
return {
'warning': {
'title': _("Too many attendees"),
'message': _("Increase seats or remove excess attendees"),
},
}
def _check_instructor_not_in_attendees(self):
for r in self:
if r.instructor_id and r.instructor_id in r.attendee_ids:
raise exceptions.ValidationError(_("A session's instructor can't be an attendee"))
报表和WebService
- 练习创建授课模型的报表
对于每个授课,报表都将显示它的授课名称,开始和结束时间,以及课程出席人列表。
<?xml version="1.0" encoding="utf-8" ?>
<odoo>
<data>
<!--定义报表-->
<report
id="report_session"
model="openacademy.session"
string="Session Report"
name="openacademy.report_session_view"
file="openacademy.report_session"
report_type="qweb-pdf" />
<template id="report_session_view">
<!--调用子模板-->
<t t-call="report.html_container">
<t t-foreach="docs" t-as="doc">
<t t-call="report.external_layout">
<div class="page">
<!--只能用于格式化记录字段-->
<h2 t-field="doc.name"/>
<p>From <span t-field="doc.start_date"/> to <span t-field="doc.end_date"/></p>
<h3>Attendees:</h3>
<ul>
<t t-foreach="doc.attendee_ids" t-as="attendee">
<li><span t-field="attendee.name"/></li>
</t>
</ul>
</div>
</t>
</t>
</t>
</template>
</data>
</odoo>
- 练习定义一个仪表盘
定义一个仪表盘,这个仪表盘包含了已经建立的图形视图、授课日历视图、课程列表视图(可以选择form视图)。这个仪表盘可以通过菜单中的菜单项使用,并且当选择开放学院主菜单时自动显示在web客户端。
'version': '0.1',
# any module necessary for this one to work correctly
'depends': ['base', 'board'],
# always loaded
'data': [
'views/openacademy.xml',
'views/partner.xml',
'views/session_workflow.xml',
'views/session_board.xml',
'reports.xml',
],
<?xml version="1.0"?>
<odoo>
<data>
<record model="ir.actions.act_window" id="act_session_graph">
<field name="name">Attendees by course</field>
<field name="res_model">openacademy.session</field>
<field name="view_type">form</field>
<field name="view_mode">graph</field>
<field name="view_id"
ref="openacademy.openacademy_session_graph_view"/>
</record>
<record model="ir.actions.act_window" id="act_session_calendar">
<field name="name">Sessions</field>
<field name="res_model">openacademy.session</field>
<field name="view_type">form</field>
<field name="view_mode">calendar</field>
<field name="view_id" ref="openacademy.session_calendar_view"/>
</record>
<record model="ir.actions.act_window" id="act_course_list">
<field name="name">Courses</field>
<field name="res_model">openacademy.course</field>
<field name="view_type">form</field>
<field name="view_mode">tree,form</field>
</record>
<record model="ir.ui.view" id="board_session_form">
<field name="name">Session Dashboard Form</field>
<field name="model">board.board</field>
<field name="type">form</field>
<field name="arch" type="xml">
<form string="Session Dashboard">
<board style="2-1">
<column>
<action
string="Attendees by course"
name="%(act_session_graph)d"
height="150"
width="510"/>
<action
string="Sessions"
name="%(act_session_calendar)d"/>
</column>
<column>
<action
string="Courses"
name="%(act_course_list)d"/>
</column>
</board>
</form>
</field>
</record>
<record model="ir.actions.act_window" id="open_board_session">
<field name="name">Session Dashboard</field>
<field name="res_model">board.board</field>
<field name="view_type">form</field>
<field name="view_mode">form</field>
<field name="usage">menu</field>
<field name="view_id" ref="board_session_form"/>
</record>
<menuitem
name="Session Dashboard" parent="base.menu_reporting_dashboard"
action="open_board_session"
sequence="1"
id="menu_board_session" icon="terp-graph"/>
</data>
</odoo>
- 练习在客户端添加新服务
编写Python程序,用来发送XML-RPC请求到运行Odoo的PC。这个程序将显示全部授课,以及所对应的座位数。也可以为课程创建新的授课。