「Odoo 基础教程系列」第四篇——从 Todo 应用开始(3)

2018/08/19 Odoo Tutorial

Powered by @rawpixel

在这一篇教程中,将会涉及到外键字段,可以将两个模型关联起来,然后很方便地获取到对应的数据。

关联字段

这一小节里,我们会给待办事项加上分类,并且这个分类可以让用户自己创建维护。我们需要先创建一个新的模型 TodoCategory,然后将它和待办事项关联起来:

# models.py
class TodoCategory(models.Model):
    _name = 'todo.category'
    _description = '分类'

    name = fields.Char(u'名称')
    task_ids = fields.One2many('todo.task', 'category_id', string=u'待办事项')
    count = fields.Integer(u'任务数量', compute='_compute_task_count')

    @api.depends('task_ids')
    @api.multi
    def _compute_task_count(self):
        pass


class TodoTask(models.Model):
    _name = 'todo.task'
    _description = '待办事项'
    # ...
    category_id = fields.Many2one('todo.category', string=u'分类')

在上面的代码中,我们定义了一个 todo.category 模型,包含三个字段,然后添加了一个 category_id 到待办事项模型中,我们重点来看看 category_idtask_ids 这两个字段。

这两个字段都是关联字段,一个是 Many2one,另一个是 One2many,还有一种我们暂时不会讲到的 Many2many 多对多的关联字段。Many2one 有一个必填的属性 comodel_name 表示要关联的模型的 _name,这个字段的值可能是 0 个或 1 个所关联对象的记录集,我们可以通过这个字段直接获取到所关联的数据对象,而不需要自己去查找对应的实例。另一个关联字段 One2many 同样有必填的属性 comodel_name,同时还有一个 inverse_name 属性,表示的是与当前模型所关联的模型(comodel_name 所指的模型)的 Many2one 字段的字段名,在此例中即 category_id,通过 One2many 字段我们可以直接获取到所有关联了当前记录的数据集。在这个例子中,假设我们有一个分类是「工作」,也就是说我们可以通过工作这个分类的 task_ids 这个字段获取到所有待办事项中 category_id 所关联的分类是「工作」的所有待办事项。

回到我们的代码中,我们看到分类模型中还有一个计算字段 count,我们希望可以看到在一个分类下有多少待办事项,所以需要用到上一篇教程中所讲到的计算字段,这里就当作是复习,一起来完成这个字段的计算逻辑:

# models.py
@api.depends('task_ids')
@api.multi
def _compute_task_count(self):
    for record in self:
        record.count = len(record.task_ids)

这里的逻辑也十分简单,我们只需要通过记录集的实例对象 record 获取到对应的待办事项,然后用 len() 获取 task_ids 的长度即可。

好的,模型已经有了,还差了点什么呢?没错,还少了菜单和视图,这里我们直接给出代码,如果还有不理解怎么创建菜单和视图的小伙伴,记得翻看一下之前的教程内容。

<!-- menus.xml -->
<?xml version="1.0" encoding="utf-8"?>
<odoo>
    <data>
        <!-- 主菜单定义 -->
        <menuitem id="menu_todo" name="Todo"/>
        <menuitem id="menu_todo_submenu" parent="menu_todo" name="待办事项"/>
        <!-- 菜单动作定义 -->
        <record id="action_todo_task" model="ir.actions.act_window">
            <field name="name">待办事项</field>
            <field name="res_model">todo.task</field>
            <field name="view_type">form</field>
            <field name="view_mode">tree,form</field>
            <field name="target">current</field>
        </record>
    
        <record id="action_todo_category" model="ir.actions.act_window">
            <field name="name">分类</field>
            <field name="res_model">todo.category</field>
            <field name="view_type">form</field>
            <field name="view_mode">tree,form</field>
            <field name="target">current</field>
        </record>
        <!-- 子菜单定义 -->
        <menuitem action="action_todo_category" id="submenu_todo_category" name="分类" parent="menu_todo_submenu" sequence="8"/>
        <menuitem action="action_todo_task" id="submenu_todo_task" name="待办事项" parent="menu_todo_submenu" sequence="10"/>
    </data>
</odoo>

菜单这里我们多增加了一层,聪明的你们应该能够一眼看出来哪里不同了,如果还是没找到,实际运行之后再观察一下菜单的结构吧~

<!-- views.xml -->
<odoo>
    <data>
        <!-- ... -->
        <record id="todo_category_view_tree" model="ir.ui.view">
            <field name="name">todo.category.view_tree</field>
            <field name="model">todo.category</field>
            <field name="type">tree</field>
            <field name="arch" type="xml">
                <tree string="Todo Category">
                    <field name="name"/>
                    <field name="count"/>
                </tree>
            </field>
        </record>
    </data>
</odoo>

OK,来更新一下模块,然后打开看看效果吧,再尝试创建几个分类,并且给待办事项关联上分类。

视图

一切看起来还不错,但是有没有觉得,创建待办事项的表单视图(Form View),以及分类的表单视图,显得有些凌乱了?虽然并不是不能用,但是,我们还是决定要改造一下!

我们先从分类的视图开始,首先可以看到分类中主要的信息就两个——分类的名称和分类下的任务数量。待办事项我们其实不需要从分类中直接去查看,所以我们大可不必把待办事项的记录显示出来,那我们的目标已经很明确了,隐藏分类表单视图中的待办事项记录,和 Tree View 一样,我们把视图先写好:

<!-- views.xml -->
<record id="todo_category_view_form" model="ir.ui.view">
    <field name="name">todo.category.view_form</field>
    <field name="model">todo.category</field>
    <field name="type">form</field>
    <field name="arch" type="xml">
        <form string="Todo Category">
            <sheet>
                <group>
                    <group>
                        <field name="name"/>
                    </group>
                    <group>
                        <field name="count" readonly="True"/>
                    </group>
                </group>
            </sheet>
        </form>
    </field>
</record>

分类表单视图

怎么样,看起来是不是舒服多了~再仔细一想,创建分类其实也只需要填一个名称,能不能不需要跳转到专门的表单视图里去创建咧?那当然是没问题的啦,我们可以让分类直接就在 Tree View 中创建而不需要专门到 Form View 中去:

<!-- views.xml -->
<record id="todo_category_view_tree" model="ir.ui.view">
    <field name="name">todo.category.view_tree</field>
    <field name="model">todo.category</field>
    <field name="type">tree</field>
    <field name="arch" type="xml">
        <tree string="Todo Category" editable="bottom">
            <field name="name"/>
            <field name="count"/>
        </tree>
    </field>
</record>

分类列表视图

其实很简单,我们只需要在分类的 Tree View 中的 <tree /> 标签中加上 editable="bottom" 这个属性即可,超简单有没有!分类的视图的处理,我们就先到这里,再来看看待办事项的表单视图应该怎么弄比较好。

待办事项的表单视图,我们只需要简单地排一下版就好啦,没有复杂的处理:

<!-- views.xml -->
<record id="todo_task_view_form" model="ir.ui.view">
    <field name="name">todo.task.view_form</field>
    <field name="model">todo.task</field>
    <field name="type">form</field>
    <field name="arch" type="xml">
        <form string="Todo">
            <sheet>
                <group>
                    <group>
                        <field name="name"/>
                        <field name="category_id"/>
                        <field name="is_done"/>
                    </group>
                    <group>
                        <field name="priority"/>
                        <field name="deadline"/>
                        <field name="is_expired" readonly="True"/>
                    </group>
                </group>
            </sheet>
        </form>
    </field>
</record>

待办事项表单视图

视图部分,就先到这里,这还只是很基础的一小部分内容,后面还会有更多关于视图部分的特性,在我们用到的时候将会给大家讲解。

今天这篇教程的内容就先到这里了,教程中的代码会更新在我的 GitHub 仓库中。

仓库地址:Odoo-Tutorial-Demo


知识共享许可协议

声明:本站的所有文章,都采用知识共享署名-非商业性使用-禁止演绎 3.0 中国大陆许可协议进行许可。

注意:若未作说明,则本文为「TNK」原创。转载务必注明出处

本文永久地址:https://ruterly.com/2018/08/19/Odoo-basic-tutorial-04/

Search

    Table of Contents