odoo17 | 模型和基本字段

心已赠人 2024-02-05 21:23 17阅读 0赞

## 前言 ##

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

在继续练习之前，请确保已安装estate房地产模块，即 必须在“应用”列表中显示为“已安装”。(点击启动即可)  
![在这里插入图片描述][ef98226dbeba488994cb770fe86dfa88.png]

## 模型对象关系映射 ##

**目标**：使用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中

完整代码如下：

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)**  
创建记录的用户。