odoo17 | 模型和基本字段

前言

在上一章的最后，我们能够创建一个Odoo模块。然而，在这一点上，它仍然是一个空壳，不允许我们这样做 存储任何数据。在我们的房地产模块中，我们希望存储与 数据库中的属性（名称、描述、价格、居住面积等）。Odoo框架提供 促进数据库交互的工具。

在继续练习之前，请确保已安装estate房地产模块，即 必须在“应用”列表中显示为“已安装”。(点击启动即可)

模型对象关系映射

目标：使用odoo模型在数据库中创建表：estate_property

$ psql -d rd-demo
rd-demo=# SELECT COUNT(*) FROM estate_property;
count
-------
    0
(1 row)

• Odoo的一个关键组件是ORM层。 该层避免了手动编写大多数 SQL，并提供可扩展性和安全性服务。
• 业务对象被声明为扩展Model的Python类，后者将它们集成到自动化持久化系统中。
• 可以通过在模型定义中设置属性来配置模型。最重要的属性是_name，它是必需的，并定义了Odoo系统中模型的名称。这是一个模型的最小定义:

from odoo import models


class EstateProperty(models.Model):
    _name = 'estate.property'
    _description = '房地产模块'

• 这个定义足以让ORM生成一个名为estate_property的数据库表。按照惯例，所有模型都位于models目录中，每个模型都在自己的Python文件中定义。
• _name = ‘estate.property’ 标识的是模型名称，会在posgres数据库中转化为estate_property表
• _description = ‘房地产模块’ 是模型的描叙信息，可以不写，但是不写的话，启动会出现警告信息。

模型字段

字段用于定义模型可以存储的内容及其存储位置。字段是在模型类中定义为属性：
简单代码示例

from odoo import models,fields


class EstateProperty(models.Model):
    _name = 'estate.property'
    _description = '房地产模块'

    name = fields.Char()

• name字段是一个Char，它将被表示为Python unicode str（即对象的属性）和SQL VARCHAR（即在数据库estate_property 增加名为name类型为VARCHAR的字段）。

模型是如何定义的，以及对应的 Python 是如何定义的文件导入

• 模型在文件estate/models/estate_property.py中定义(代码如下)

from odoo import models,fields


class EstateProperty(models.Model):
    _name = 'estate.property'
    _description = '房地产模块'

    name = fields.Char()

• 在estate/models/__init__.py中导入文件crm_recurring_plan.py(见这里)

from . import estate_property

• 在estate/__init__.py中导入文件夹模型(见这里)

from . import models

字段类型

字段有两大类:

• “简单”的基本字段，它们是直接存储在模型表中的原子值
• 以及“关系”字段，它们链接(相同或不同模型的)记录（后面会讲到模型的关系字段）。

简单的字段示例有Boolean, Float, Char, Text, Date和Selection。

目标：按照下图将几个基本字段添加到表中：estate_property中

 Column       |            Type             | Collation | Nullable |                  Default
--------------------+-----------------------------+-----------+----------+---------------------------------------------
id                 | integer                     |           | not null | nextval('estate_property_id_seq'::regclass)
create_uid         | integer                     |           |          |
create_date        | timestamp without time zone |           |          |
write_uid          | integer                     |           |          |
write_date         | timestamp without time zone |           |          |
name               | character varying           |           |          |
description        | text                        |           |          |
postcode           | character varying           |           |          |
date_availability  | date                        |           |          |
expected_price     | double precision            |           |          |
selling_price      | double precision            |           |          |
bedrooms           | integer                     |           |          |
living_area        | integer                     |           |          |
facades            | integer                     |           |          |
garage             | boolean                     |           |          |
garden             | boolean                     |           |          |
garden_area        | integer                     |           |          |
garden_orientation | character varying           |           |          |
Indexes:
    "estate_property_pkey" PRIMARY KEY, btree (id)
Foreign-key constraints:
    "estate_property_create_uid_fkey" FOREIGN KEY (create_uid) REFERENCES res_users(id) ON DELETE SET NULL
    "estate_property_write_uid_fkey" FOREIGN KEY (write_uid) REFERENCES res_users(id) ON DELETE SET NULL

完整代码如下：

from odoo import models, fields


class EstateProperty(models.Model):
    _name = 'estate.property'
    _description = '房地产模块'

    name = fields.Char(string="名称")
    description = fields.Text(string="描述")
    postcode = fields.Char(string="邮编")
    date_availability = fields.Date(string="可用时间")
    expected_price = fields.Float(string="预期价格")
    selling_price = fields.Float(string="销售价格")
    bedrooms = fields.Integer(string="卧室")
    living_area = fields.Integer(string="居住面积")
    facades = fields.Integer(string="外立面（外墙）")
    garage = fields.Boolean(string="是否有车库")
    garden = fields.Boolean(string="是否有花园")
    garden_area = fields.Integer(string="花园面积")
    garden_orientation = fields.Integer(string="花园朝向")

通用属性

例如 是name字段 不能为空
与模型本身非常相似，字段可以通过传递 作为参数的配置属性：

name = fields.Char(required=True)

某些属性在所有字段上都可用，以下是最常见的属性：
string (str, default: 字段名称)
UI中字段的标签(用户可见)。

required (bool, default: False)
如果为True，则该字段不能为空。它必须有一个默认值，或者在创建记录时总是给定一个值。

help (str, default: ‘’)
在UI中为用户提供长篇帮助工具提示。

index (bool, default: False)
请求Odoo在数据库字段列上创建数据库索引。

自动字段

你可能已经注意到你的模型中有一些你从未定义过的字段。Odoo在所有模型中自动创建一些字段。这些字段由系统管理，不能写入，但如果有需要，可以读取。以下是Odoo在所有模型自动创建的字段：

id (id)
模型记录的唯一标识符。

create_date (Datetime)
记录的创建日期。

create_uid (Many2one)
创建记录的用户。

write_date (Datetime)
记录的最后修改日期。

write_uid (Many2one)
上次修改记录的用户。