odoo 开发入门教程系列-基本视图

时间:2022-12-07 01:19:46

在上一章中已经看到,odoo能够为给定模型生成默认视图。实际上,默认视图对于业务应用程序来说是不可接受的。相反,我们至少应该以逻辑的方式组织各个字段。

视图是在带有操作和菜单的XML文件中定义的。它们是ir.ui.view model的实例。

在我们的estate模块中,我们需要以逻辑方式组织字段:

  • 在列表(树)视图中,我们希望显示的不仅仅是名称。
  • 在表单视图中,应该对字段进行分组。
  • 在搜索视图中,我们必须能够搜索的不仅仅是名称。具体来说,我们需要"Available"的地产筛选器和按"postcode"分组的快捷方式

List(列表)

参考: 主题关联文档可参考List.

列表视图,也叫树(tree)视图, 以表格的形式显示记录。

视图根元素为<tree>。其最基础版本仅简单的列出要在表中显示的所有字段(其中每个字段都是一列):

<tree string="Tests">
    <field name="name"/>
    <field name="last_seen"/>
</tree>

练习 -- 添加一个自定义列表视图

在合适的XML文件中为estate.property model定义一个列表视图。 一个简单的示例

修改odoo14/custom/estate/views/estate_property_views.xml

<?xml version="1.0"?>
<odoo>
    <record  model="ir.actions.act_window">
        <field name="name">Properties</field>
        <field name="res_model">estate.property</field>
        <field name="view_mode">tree,form</field>
    </record>
    
    <!--本小节添加的内容-->
    <record  model="ir.ui.view">
        <field name="name">estate.property.tree</field>
        <field name="model">estate.property</field>
        <field name="arch" type="xml">
            <tree string="Tests">
                <field name="name" string="Title"/>
                <field name="postcode" string="Postcode"/>
                <field name="bedrooms" string="Bedrooms"/>
                <field name="living_area" string="Living Area"/>
                <field name="expected_price" string="Expected Price"/>
                <field name="selling_price" string="Selling Price"/>
                <field name="date_availability" string="Avalilable Form"/>
            </tree>
        </field>
    </record>
</odoo>

注意:暂时不要添加示例中的 editable="bottom"属性

说明:

<field name="name">自定义列表名称</field>
<field name="model">模型名称,即_name的值</field>

重启服务,浏览器验证,效果如下:

odoo 开发入门教程系列-基本视图

说明:如果未给<field/>添加string属性,则显示如下:

odoo 开发入门教程系列-基本视图

Form(表单)

参考: 主题关联文档可以查看Form.

表单用于创建和编辑单条件记录,其根元素为 <form>,由高层框架元素(groupnotebook)和交互元素 (按钮和字段):

<form string="Test">
    <sheet>
        <group>
            <group>
                <field name="name"/>
            </group>
            <group>
                <field name="last_seen"/>
            </group>
            <notebook>
                <page string="Description">
                    <field name="description"/>
                </page>
            </notebook>
        </group>
    </sheet>
</form>

可以使用常规HTML标记(如"div"和"h1")以及"class"属性(Odoo提供了一些内置类)来微调外观。

一个简单示例.

练习 -- 添加自定义表单视图

在合适的XML文件中为estate.property 定义视图

为了避免每次修改视图时都重新启动服务器,可以在启动服务器时添加--dev-xml,以便只刷新页面就可以查看视图修改,如下:

python odoo-bin --addons-path=custom,odoo/addons -r myodoo -w test123 -d odoo -u estate --dev xml

修改odoo14/custom/estate/views/estate_property_views.xml

<?xml version="1.0"?>
<odoo>
    <record  model="ir.actions.act_window">
        <field name="name">Properties</field>
        <field name="res_model">estate.property</field>
        <field name="view_mode">tree,form</field>
    </record>

    <record  model="ir.actions.act_window">
        <field name="name">Properties</field>
        <field name="res_model">estate.property</field>
        <field name="view_mode">tree,form</field>
    </record>

    <record  model="ir.ui.view">
        <field name="name">estate.property.tree</field>
        <field name="model">estate.property</field>
        <field name="arch" type="xml">
            <tree string="Tests">
                <field name="name" string="Title"/>
                <field name="postcode" string="Postcode"/>
                <field name="bedrooms" string="Bedrooms"/>
                <field name="living_area" string="Living Area"/>
                <field name="expected_price" string="Expected Price"/>
                <field name="selling_price" string="Selling Price"/>
                <field name="date_availability" string="Avalilable Form"/>
            </tree>
        </field>
    </record>
    
    <!--本小节添加的内容-->
    <record  model="ir.ui.view">
        <field name="name">estate.property.form</field>
        <field name="model">estate.property</field>
        <field name="arch" type="xml">
            <form string="estate property form">
                <sheet>
                    <h1>
                        <field name="name"/>
                    </h1>
                    <group>
                        <group>
                            <field name="postcode" string="Postcode" ></field>
                            <field name="date_availability" string="Available From"></field>
                        </group>
                        <group>
                            <field name="expected_price" string="Expected Price"></field>
                            <field name="selling_price" string="Selling Price"></field>
                        </group>
                    </group>
                    <notebook>
                        <page string="Description">
                            <group>
                                <field name="description"></field>
                                <field name="bedrooms"></field>
                                <field name="living_area"></field>
                                <field name="facades"></field>
                                <field name="garage"></field>
                                <field name="garden"></field>
                                <field name="garden_area"></field>
                                <field name="garden_orientation"></field>
                            </group>
                        </page>
                    </notebook>
                </sheet>
            </form>
        </field>
    </record>
</odoo>

查看效果

odoo 开发入门教程系列-基本视图

Search(搜索)

参考: 本主题相关文档可参考Search.

搜索视图与列表及表单视图略有不同,因为它们不显示内容。尽管它们适用于特定模型,但它们用于过滤其他视图的内容(通常是聚合视图,比如列表). 除了在使用方面的不同,他们的定义方式是一样的。

搜索视图根元素为<search>。该视图最基础的版本是列出需要快捷方式的所有字段:

<search string="Tests">
    <field name="name"/>
    <field name="last_seen"/>
</search>

Odoo生成的默认搜索视图提供了按name筛选的快捷方式。在自定义搜索视图中添加用户可能过滤的字段是非常常见的。

搜索视图还可以包含<filter>元素,这些元素充当预定义搜索的开关。筛选器必须具有以下属性之一:

  • domain:将给定domain添加到当前搜索
  • dontext:添加一些context到当前搜索,使用group_by按给定字段名称对结果分组。

一个简单的示例.

<record  model="ir.ui.view">
            <field name="name">delivery.carrier.search</field>
            <field name="model">delivery.carrier</field>
            <field name="arch" type="xml">
                <search string="Delivery Carrier">
                    <field name="name" string="Carrier" />
                    <field name="delivery_type"/>
                    <separator/>
                    <filter string="Archived" name="inactive" domain="[('active', '=', False)]"/>
                    <group expand="1" string="Group By">
                        <filter string="Provider" name="provider" context="{'group_by':'delivery_type', 'residual_visible':True}"/>
                    </group>
                </search>
            </field>
        </record>

在进一步练习之前,有必要介绍一下domain概念。

domain

引用: 本主题相关文档可参考 Search domains.

在odoo中,domain对记录上的条件进行编码:domain是用于选择模型记录子集的条件列表。每个条件都是一个包含字段名运算符的三元组。如果指定字段满足作用于值的运算符的条件,则记录满足条件。

例如,当在Product模型上使用时,以下domain选择单价高于1000的所有services

[('product_type', '=', 'service'), ('unit_price', '>', 1000)]

默认情况下,条件与隐式AND组合在一起,这意味着记录匹配一个domain,需要满足domain中的每个条件。逻辑运算符&(AND)、|(OR)和!(NOT)可用于显式组合条件。它们用于前缀位置(运算符插入在其参数之前,而不是插入在参数之间)。例如,选择类型为“服务“或“单价”不介于1000和2000之间的产品

['|',
    ('product_type', '=', 'service'),
    '!', '&',
        ('unit_price', '>=', 1000),
        ('unit_price', '<', 2000)]

选择类型为“服务“且“单价”介于1000和2000之间的产品

['&',('product_type', '=', 'service'),'&',('unit_price', '>=', 1000),('unit_price', '<', 2000)]

等价于

[('product_type', '=', 'service'),('unit_price', '>=', 1000),('unit_price', '<', 2000)]

选择类型为“服务“或者“单价”大于等于1000或者单价小于500的产品

['|', '|', ('product_type', '=', 'service'),('unit_price', '>=', 1000),('unit_price', '<', 500)]

选择名字为 ABC 而且语言编码不为 en_US 而且国家的编码为 be 或者 de

[('name','=','ABC'),
 ('language.code','!=','en_US'),
 '|',('country_id.code','=','be'),
     ('country_id.code','=','de')]

简单一点的写法

[('name','=','ABC'),
 ('language.code','!=','en_US'),
 ('country_id.code','in', ['be', 'de'])]
波兰表示法简介

Odoo是使用了波兰表示法,简单来说,波兰表示法是一种操作符置于操作数前,并且不需要括号仍然能无歧义地解析表达的方法。

运算顺序
以二元运算为例,从左至右读入表达式,遇到一个操作符后跟随两个操作数时,则计算之,然后将结果作为操作数替换这个操作符和两个操作数;重复此步骤,直至所有操作符处理完毕。

举个例子:

['|','&','|',a,b,c,'&',d,e]

其中a,b,c,e,f,g 分别是不带逻辑运算符的表达式,表达式的运算顺序:

1、['|','&','|',a,b,c,'&',d,e]
 
2、['|','&',(a | b),c,'&',d,e]
 
3、['|',((a | b) & c),'&',d,e]
 
4、['|',((a | b) & c),(d & e)]
 
5、[(((a | b) | c) | (d & e))]

如果我们要做到这个效果

A and (B or C) and D and E

先从里面开始,把or提前

A and (or B C) and D and E

把里面的and提前,去掉括号

and A or B C and D E

所以最后的domain可以这样写

A, '|', B, C, D, E

当然,我们也可以把表达式写得更容易看一点,如下:

A, D, E, '|', B, C

练习

添加定义搜索视图

在合适的XML中为 estate.property 模型定义一个搜索视图

添加过滤和分组

添加以下内容到之前创建就的搜索视图

  • 一个显示avaliable地产的过滤器,也就说,state应该为 “New“ 或者“Offer Received”。
  • 按"postcode"分组的能力

修改odoo14/custom/estate/views/estate_property_views.xml

<?xml version="1.0"?>
<odoo>
    <record  model="ir.actions.act_window">
        <field name="name">Properties</field>
        <field name="res_model">estate.property</field>
        <field name="view_mode">tree,form</field>
    </record>

    <record  model="ir.actions.act_window">
        <field name="name">Properties</field>
        <field name="res_model">estate.property</field>
        <field name="view_mode">tree,form</field>
    </record>

    <record  model="ir.ui.view">
        <field name="name">estate.property.tree</field>
        <field name="model">estate.property</field>
        <field name="arch" type="xml">
            <tree string="Tests">
                <field name="name" string="Title"/>
                <field name="postcode" string="Postcode"/>
                <field name="bedrooms" string="Bedrooms"/>
                <field name="living_area" string="Living Area"/>
                <field name="expected_price" string="Expected Price"/>
                <field name="selling_price" string="Selling Price"/>
                <field name="date_availability" string="Avalilable Form"/>
            </tree>
        </field>
    </record>

    <record  model="ir.ui.view">
        <field name="name">estate.property.form</field>
        <field name="model">estate.property</field>
        <field name="arch" type="xml">
            <form string="estate property form">
                <sheet>
                    <h1>
                        <field name="name"/>
                    </h1>
                    <group>
                        <group>
                            <field name="postcode" string="Postcode" ></field>
                            <field name="date_availability" string="Available From"></field>
                        </group>
                        <group>
                            <field name="expected_price" string="Expected Price"></field>
                            <field name="selling_price" string="Selling Price"></field>
                        </group>
                    </group>
                    <notebook>
                        <page string="Description">
                            <group>
                                <field name="description"></field>
                                <field name="bedrooms"></field>
                                <field name="living_area"></field>
                                <field name="facades"></field>
                                <field name="garage"></field>
                                <field name="garden"></field>
                                <field name="garden_area"></field>
                                <field name="garden_orientation"></field>
                            </group>
                        </page>
                    </notebook>
                </sheet>
            </form>
        </field>
    </record>

    <!--本小节添加的内容-->
    <record  model="ir.ui.view">
        <field name="name">estate.property.search</field>
        <field name="model">estate.property</field>
        <field name="arch" type="xml">
            <search string="Estate Property">
                <!-- 搜索 -->
                <field name="name" string="Title" />
                <field name="postcode" string="Postcode"></field>
                <separator/>
                <!-- 筛选 -->
                <filter string="Available" name="state" domain="['|',('state', '=', 'New'),('state', '=', 'Offer Received')]"></filter>
                <filter name="bedrooms" domain="[('bedrooms', '>', 3)]"></filter>
                <filter name="bedrooms and selling_price" domain="[('bedrooms', '>', 2),('selling_price', '>=', 1000)]"></filter>
                <!-- 分组 -->
                <group expand="1" string="Group By">
                    <filter string="朝向" name="garden_orientation" context="{'group_by':'garden_orientation'}"/>
                </group>
            </search>
        </field>
    </record>
</odoo>

重启服务,验证效果

odoo 开发入门教程系列-基本视图

作者:授客

全国软件测试QQ交流群:7156436


Git地址:https://gitee.com/ishouke