为了让教程更易懂,我们将使用一个简化的例子:创建一个“员工生日列表”视图。这个例子将帮助初学者理解如何在Odoo中创建自定义视图,展示每个员工的姓名和生日。
假设我们有一个employee
模块,里面有一个employee
模型,包含name
(姓名)和birthday
(生日)字段。
目标是创建一个新视图,展示所有员工的姓名和生日,并能够按月份对生日进行分组展示。
1. 定义新视图类型
首先,我们需要在ir.ui.view
中添加一个新的视图类型birthday_list
:
class View(models.Model):
_inherit = 'ir.ui.view'
type = fields.Selection(selection_add=[('birthday_list', 'Birthday List')])
2. 新增视图模式
然后,在ir.actions.act_window.view
中新增一个视图模式,以便我们可以在动作窗口中使用这个新的视图类型:
class ActWindowView(models.Model):
_inherit = 'ir.actions.act_window.view'
view_mode = fields.Selection(selection_add=[('birthday_list', 'Birthday list')],
ondelete={'birthday_list': 'cascade'})
3. 实现数据获取逻辑
我们需要一种方式来组织数据,使其能够按员工的生日月份分组展示:
class Employee(models.Model):
_inherit = 'employee'
@api.model
def get_birthday_data(self):
employees = self.search([])
result_dict = {}
for emp in employees:
month = emp.birthday.month if emp.birthday else 'Unknown'
if month not in result_dict:
result_dict[month] = []
result_dict[month].append({
'name': emp.name,
'birthday': emp.birthday,
})
return result_dict
4. 实现前端JavaScript代码
为了能够在前端展示这些分组数据,我们需要创建几个JavaScript文件来处理模型、视图、控制器、渲染逻辑。
model.js:
odoo.define('employee.BirthdayListModel', function (require) {
'use strict';
var AbstractModel = require('web.AbstractModel');
var BirthdayListModel = AbstractModel.extend({
// Model implementation
});
return BirthdayListModel;
});
controller.js, renderer.js, 和 view.js 文件类似地实现对应的功能,处理用户交互和数据的渲染。
5. 创建QWeb模板
创建一个QWeb模板来定义视图的HTML结构:
<t t-name="BirthdayListView">
<div class="o_birthday_list_view">
<!-- 这里定义视图的HTML结构和数据绑定 -->
</div>
</t>
6. 注册和使用新视图
最后,在模块的XML文件中注册新的视图,并为employee
模型添加这个新视图:
<record id="employee_birthday_list_view" model="ir.ui.view">
<field name="name">Employee Birthday List</field>
<field name="model">employee</field>
<field name="arch" type="xml">
<birthday_list>
<!-- 视图配置 -->
</birthday_list>
</field>
</record>
在动作中添加birthday_list
视图模式,以便用户可以通过UI访问它:
<field name="view_mode">list,birthday_list,form</field>