Constraints

提示

设置约束规则，来防止用户输入不正确的数据。

odoo提供两种约束方式：

Python constraint
SQL constraint

SQL 约束通常比 Python 约束更有效。当性能很重要时，始终首选 SQL 而不是 Python 约束。

SQL constraint

在Model中通过_sql_constraints属性定义。

该属性包含一个含字符串的三元组列表：(name, sql_definition, message)

其中name是有效的SQL约束名称，sql_definition是table_constraint表达式，message是错误信息。

举个栗子：

_sql_constraints = [
        ('check_percentage', 'CHECK(percentage >= 0 AND percentage <= 100)',
         'The percentage of an analytic distribution should be between 0 and 100.'),
        ('unique name', 'UNIQUE(name)', 'The name already exists.')
    ]

危险

⚠️当你在已有数据的模型上新增约束且存在已有数据不满足约束时，升级模块会失败并弹出类似于以下的错误信息，你需要对不满足约束的数据进行处理后来执行升级应用新的约束。

ERROR rd-demo odoo.schema: Table 'estate_property_offer': unable to add constraint 'estate_property_offer_check_price' as CHECK(price > 0)

Python constraint

SQL 约束是确保数据一致性的有效方法。但是，可能需要进行更复杂的检查，这需要 Python 代码。

python约束通过@api.constraints(*args)装饰器来调用，修饰器指定约束中涉及哪些字段，当修改这些字段中的任何一个时，将自动评估约束。如果不满足该方法的不变性，则该方法应引发异常。（注意函数中的self代表记录集，通过循环遍历来处理。）

python constraint 有以下需要注意的点：

仅支持简单字段名称，不支持点缀名称（例如关系字段的字段 partner_id.customer ）将被忽略。
仅当修饰方法中声明的字段包含在 create或 write 调用中时才会触发。这意味着视图中不存在的字段不会在记录创建期间触发调用。重写 create 是必要的，以确保约束始终被触发（例如，测试是否缺少值）。

举个栗子：

from odoo.exceptions import ValidationError

...

@api.constrains('date_end')
def _check_date_end(self):
    for record in self:
        if record.date_end < fields.Date.today():
            raise ValidationError("The end date cannot be set in the past")
    # all records passed the test, don't return anything

SQL constraint​

Python constraint​

SQL constraint

Python constraint