odoo17开发教程（4）：模块module和model中的字段类型

原创已于 2024-05-07 15:44:15 修改 · 1.9k 阅读

18 ·

CC 4.0 BY-SA版权

文章标签：

#odoo17 #开源erp #开源crm

于 2024-03-11 17:22:47 首次发布

odoo17入门开发教程专栏收录该内容

23 篇文章

订阅专栏

本文介绍了如何在Odoo17中使用ORM实现数据库交互，通过创建模型和字段来存储房产相关信息，如名称、价格等，并概述了自动字段和配置选项。后续将涉及__manifest__.py文件和权限管理。

之前的文章我们已经了解了模块的基础构成，然而，此时它仍然是一个空壳，无法存储任何数据。在我们的房地产模块中，我们希望在数据库中存储与房产相关的信息（名称、描述、价格、居住面积......）。Odoo 框架提供了促进数据库交互的工具。

对象关系映射

Odoo的一个关键组件是ORM层。该层可避免手动编写大多数 SQL，并提供可扩展性和安全服务。

业务对象被声明为扩展 Model 的 Python 类，从而将它们集成到自动持久化系统中。

模型可通过在定义中设置属性进行配置。最重要的属性是 _name，这是必填项，它定义了模型在 Odoo 系统中的名称。以下是模型的最低定义：

from odoo import models

class TestModel(models.Model):
    _name = "test_model"

这个定义足以让 ORM 生成一个名为 test_model 的数据库表。按照惯例，所有模型都位于 models 目录中，每个模型都在自己的 Python 文件中定义。

model中的字段

字段用于定义模型可以存储的内容和存储位置。字段在模型类中定义为属性，例如：

from odoo import fields, models

class TestModel(models.Model):
    _name = "test_model"
    _description = "Test Model"

    name = fields.Char()

name 字段是一个 Char，它将表示为 Python unicode str 和 SQL VARCHAR。

字段分为两大类：“简单”字段（直接存储在模型表中的原子值）和“关系”字段用来链接记录（相同或不同模型的））

字段示例包括布尔、浮点、字符、文本、日期和选择(Boolean, Float, Char, Text, Date and Selection)

我们的表estate_property（房产属性）需要以下这些字段：

Field	Type
name	Char
description	Text
postcode	Char
date_availability	Date
expected_price	Float
selling_price	Float
bedrooms	Integer
living_area	Integer
facades	Integer
garage	Boolean
garden	Boolean
garden_area	Integer
garden_orientation	Selection

你可以使用下面的代码真正创建一个estate_property表，新建models/estate_property.py:

from odoo import models, fields, api

class EstateProperty(models.Model):
    _name = "estate_property"
    _description = "Estate Property"
    
    name = fields.Char(required=True)
    description = fields.Text()
    postcode = fields.Char()
    date_available = fields.Date()
    expected_price = fields.Float(required=True)
    selling_price = fields.Float()
    bedrooms = fields.Integer()
    living_area = fields.Integer()
    facades = fields.Integer()  # 外墙
    garage = fields.Boolean()
    garden = fields.Boolean()
    garden_area = fields.Integer()
    garden_orientation = fields.Selection([
        ("north", "North"),
        ("south", "South"),
        ("east", "East"),
        ("west", "West"),
    ])

与模型本身一样，字段也可以通过传递配置属性作为参数来进行配置：

name = fields.Char(required=True)

有些属性适用于所有字段，以下是最常见的属性：
string（str，默认：字段名）
字段在用户界面中的标签（用户可见）。

required （bool，默认值：False）
如果为 True，则字段不能为空。它必须有一个默认值，或者在创建记录时始终给定一个值。

help （str，默认值：''）
在用户界面中为用户提供帮助提示。

index（bool，默认值：False）
请求 Odoo 为列创建数据库索引。