介绍
如果您曾经在 Odoo 中保存过表单并看到某个字段变为红色，那么您已经遇到了 必填字段 机制。这是 Odoo 数据模型中最基本的特性之一，也是确保业务工作流程中数据质量的最简单方法之一。
无论您是为销售团队配置 Odoo，设置自定义模型，还是在进行技术 Odoo 开发项目，了解 required 属性的工作原理将帮助您构建更可靠的流程。
本指南涵盖了一切：字段在 Odoo 框架中的行为，如何使用 Odoo Studio 或 Python 代码进行配置，何时使用它，以及需要注意的错误。
Odoo 中的必填字段是什么
在 Odoo 中，required 属性是一个字段级约束，防止记录被保存，除非该字段包含值。它适用于几乎所有 Odoo 字段类型：文本字段、数字字段、选择字段、many2one 字段、日期等。
它是 Odoo 数据模型的核心部分，也是进行 Odoo 自定义时最常用的属性之一。将字段设置为必填是防止数据库中不完整或不一致数据的第一道防线。
它在界面中的表现
在 Odoo 用户界面中，必填字段与可选字段在视觉上有所区分。当表单处于编辑模式时，必填字段通常会显示一个微妙的视觉指示器。当用户尝试在未填写必填字段的情况下保存记录时，Odoo 会将该字段高亮显示为红色，并显示警告信息。
这种行为在网络界面中是一致的。用户会看到即时、清晰的反馈，这减少了提交不完整记录的机会。
静态与动态必填
在 Odoo 中，有两种方法可以使字段成为必填。第一种是 静态必填：该字段始终是强制性的，无论如何。第二种是 动态必填：该字段仅在满足某些条件时变为强制性，这些条件基于同一记录中其他字段的值。
这两种方法在 Odoo 开发中都被定期使用。选择取决于您的业务逻辑。
字段如何工作
理解 required 属性在技术层面的工作原理有助于您正确应用它，并在出现问题时进行调试。
应用级强制执行
一个让许多 Odoo 用户感到惊讶的重要细节是：required 属性是在 应用级 强制执行的，而不是在数据库级别。这意味着在创建或写入记录时，Odoo ORM 会检查该约束，在数据到达数据库之前。
当您在字段上设置 required=True 时，默认情况下不会向底层 PostgreSQL 列添加 NOT NULL 约束。验证发生在 Python 中，在 Odoo ORM 层内。
在实践中，这意味着直接插入到数据库中的数据（绕过 Odoo）将不会被所需约束捕获。始终通过 ORM 或 API 与您的 Odoo 数据库字段进行交互，以享受这种保护。
当约束被违反时会发生什么
当用户尝试保存一个必填字段为空的表单时，会发生两件事：
- 该字段在界面中变为红色，Odoo 显示验证消息
- 保存操作被阻止，直到该字段被填写
如果您通过编程触发验证（例如，通过 XML-RPC API 或服务器操作），Odoo 会引发一个 ValidationError，并附带一条消息，指明缺少哪个必填字段。
使用域动态必填
在 Odoo 框架中，required 属性可以通过视图级表达式变为条件性。在 Odoo 16 及更早版本中，这是通过视图 XML 中的 attrs 属性完成的：
<field name="x_delivery_date" attrs="{'required': [('order_type', '=', 'delivery')]}" />在 Odoo 17 及更高版本中，语法通过在视图中的字段标签上直接使用 required 表达式得到了简化：
<field name="x_delivery_date" required="order_type == 'delivery'" />这些条件规则存在于视图层，而不是模型层。这是一个重要的区别：模型级的 required=True 始终强制执行约束，而视图级表达式仅在特定的界面上下文中适用。
与 ORM 和 API 的交互
在 Odoo ORM 中，当您在模型上调用 create() 或 write() 时，ORM 会在执行数据库操作之前检查所有 required=True 的字段。如果缺少必填字段或将其设置为 False，Odoo 会引发 ValidationError。
这同样适用于通过 XML-RPC API 创建记录。模型定义中标记为必填的任何字段必须在传递给 create 方法的数据字典中提供，否则调用将因错误而失败。
业务用例
必填字段在标准 Odoo 中随处可见，在自定义配置中同样有用。以下是来自实际业务工作流程的五个具体示例，其中将字段设置为必填确实产生了显著的影响。
1. CRM：潜在客户的客户细分必填
销售团队希望确保每个潜在客户在移入管道之前都被分配到一个客户细分。没有必填字段，销售代表往往会跳过这一步，导致后续无法按细分报告潜在客户来源。
通过将 CRM 潜在客户表单上的自定义 "客户细分" 选择字段标记为必填，团队确保数据在输入时始终被捕获。没有细分，无法保存。
2. 销售：订单上的送货地址必填
对于发货实物商品的公司来说，送货地址至关重要。在某些 Odoo 配置中，送货地址字段默认不是必填的，这意味着可以在没有送货地址的情况下确认订单。
在销售订单表单上将送货地址字段设置为必填，防止在物流团队获得所需信息之前确认订单。这消除了履行过程中常见的错误来源。
3. 库存：接收时必填批次或序列号
对于在受监管行业（食品、制药、电子产品）中运营的公司来说，跟踪接收商品的批次号不是可选的。Odoo 通过产品上的跟踪设置原生支持这一点，有效地在库存移动期间强制要求提供批次或序列号。
在收据表单上的自定义字段，例如质量控制参考，设置该字段为必填可以确保仓库团队在接收过程中不会忘记记录信息。
4. 会计：供应商账单上必填成本中心
财务团队通常需要将每一项支出分配到一个成本中心以进行预算跟踪。如果没有强制执行，会计或采购经理可能会留下空白字段，从而在财务报告中造成漏洞。
在供应商账单表单中添加一个指向成本中心模型的必填 many2one 字段，确保没有账单可以在没有此分配的情况下发布。这种 Odoo 自定义的实施速度快，并对数据完整性产生直接影响。
5. 人力资源：入职前必填合同类型
在 Odoo 中管理员工入职的人力资源团队通常希望在员工记录最终确定之前记录合同类型。员工表单上的必填字段可以防止人力资源团队在繁忙的入职期间无意中保存不完整的员工记录。
创建或自定义字段
在 Odoo 中标记字段为必填有两种主要方法：使用 Odoo Studio 进行无代码方法，或编写 Python 代码以获得完全控制。根据您的上下文，两者都是有效的。
使用 Odoo Studio
Odoo Studio 是内置的无代码工具，让您可以在没有任何开发的情况下配置字段。当您打开 Studio 并选择表单上的字段时，您将在右侧的字段属性面板中看到一个 "必填" 切换开关。
启用此切换开关会在视图中将字段标记为必填，并在模型级别存储约束。这是处理简单情况的最快方法，无需技术知识。它适用于标准 Odoo 字段和通过 Odoo Studio 添加的自定义字段。
Studio 的限制在于它仅配置静态必填约束。对于基于其他字段值的动态必填行为，您需要直接编辑视图 XML 或使用技术方法。
技术方法：Python 字段
在自定义 Odoo 模块中，声明一个必填字段只需在字段定义中添加 required=True。这是 Odoo Python 字段开发中的标准模式：
from odoo import fields, models
class SaleOrder(models.Model):
_inherit = 'sale.order'
x_customer_segment = fields.Selection(
selection=[
('smb', 'SMB'),
('enterprise', 'Enterprise'),
('public', 'Public Sector'),
],
string='Customer Segment',
required=True,
)
x_cost_center_id = fields.Many2one(
comodel_name='account.analytic.account',
string='Cost Center',
required=True,
)通过这种方法，约束在模型级别强制执行，这意味着无论使用哪个视图或接口创建记录，它都适用。无法通过访问不同视图来绕过它。
动态必填字段在视图 XML 中
当必填约束仅在某些条件下适用时，应在视图级别而不是模型级别添加它。在 Odoo 16 中：
<field name="x_cost_center_id"
attrs="{'required': [('order_type', '=', 'invoiced')]}" />在 Odoo 17 中：
<field name="x_cost_center_id"
required="order_type == 'invoiced'" />这是一个仅限视图的约束。它比模型级别的必填约束宽松，因为它仅在通过包含此定义的特定视图编辑记录时适用。
通过 API 创建必填字段
如果您使用 XML-RPC API 创建字段（如 Odoo 数据与 API 集合中的其他文章所述），您可以在调用 create 时在 ir.model.fields 上设置 required。这是 Odoo 开发者指南中程序化自定义的标准部分：
models.execute_kw(ODOO_DB, uid, ODOO_API_KEY,
'ir.model.fields', 'create',
[{
'name': 'x_customer_segment',
'field_description': 'Customer Segment',
'model_id': model_id,
'ttype': 'selection',
'selection': "[('smb', 'SMB'), ('enterprise', 'Enterprise')]",
'required': True,
'state': 'manual',
}]
)这一步骤创建了字段并在一个步骤中强制执行所需的约束，这在自动化部署工作流中对于创建字段的 Odoo 场景非常有用。
最佳实践
将字段标记为必填似乎很简单，但要有效地使用它需要一些思考。以下是一些可以节省时间并防止用户沮丧的实践。
1. 仅在字段确实需要时才将其标记为必填
过度要求字段是最常见的 Odoo 配置错误之一。如果用户无法完成表单，因为某个字段是必填的，但信息尚不可用，他们会寻找变通方法（例如输入占位符值），这会损坏您的数据。
在将字段标记为必填之前，问自己：在输入时此信息是否总是可用？如果答案不是明确的“是”，考虑在后期将其标记为必填（例如，在确认时而不是在创建时）或使用动态必填。
2. 使用基于阶段的验证而不是始终必填
对于具有多个步骤的工作流，例如 CRM 机会或制造订单，通常最好在特定阶段强制执行必填字段，而不是从一开始就强制执行。这通常通过 Python 约束或自动化操作来完成，这些操作在记录移动到给定阶段时检查字段值。
这种模式比从第一天起就将每个字段都标记为必填更灵活且用户友好。
3. 在合理的情况下将必填字段与默认值配对
如果某个字段是必填的，并且在大多数情况下有一个合理的默认值，请在字段定义上设置 default。这减少了不需要更改默认值的用户的摩擦，同时确保字段永远不会为空。
4. 对于关键数据，优先使用模型级必填
对于真正关键的数据（如会计信息、监管标识符或强制性标识符），在 Python 中在模型级别强制执行约束，而不仅仅是在视图级别。视图级别的必填约束可以被绕过，如果记录是通过 API 或不包含约束的不同视图创建的。
5. 向最终用户传达必填字段
当您向现有表单添加新的必填字段时，正在进行工作流程的用户可能会感到惊讶。在部署之前，请向您的团队传达更改，特别是如果现有记录在下次编辑时可能无法通过验证。
6. 使用空值和部分数据进行测试
在部署带有新必填字段的配置之前，请始终使用空值和部分数据测试完整的工作流程。这包括通过网页界面、通过API以及通过任何创建Odoo记录的自动化操作或集成进行测试。这是任何负责任的Odoo技术教程中的基本步骤。
常见陷阱
即使是经验丰富的Odoo实施者也会遇到必填字段的问题。知道需要注意什么将节省调试时间并防止痛苦的回滚。
陷阱1：在已有记录的模型上将字段设为必填
如果您在一个已经包含数千条记录的模型的字段上添加required=True，而这些记录没有该字段的值，那么在下次编辑这些记录时可能会遇到问题。用户在填写新必填字段之前将无法保存任何更改。
在对现有字段部署必填约束之前，请始终检查现有记录是否已经有值。如果没有，请先进行数据迁移以填充该字段。
陷阱2：混淆视图级别和模型级别的必填
在视图中将字段设置为必填（无论是通过Studio还是视图XML）并不会在模型级别强制执行约束。通过API、不同视图或导入创建的记录将完全绕过视图级别的必填约束。
如果您需要强制约束，请在Python字段定义中设置required=True。这是Odoo字段教程社区中经常被误解的一点，它在生产中造成了真正的数据质量问题。
陷阱3：自动化或计划操作中的必填字段
当自动化操作或计划操作以编程方式创建记录时，必须为所有必填字段提供值。如果该操作是在添加必填字段之前编写的，则在部署必填约束后，它将开始静默失败或出现模糊错误。
在向现有模型添加必填字段后，始终检查所有自动记录创建代码。
陷阱 4：导入缺少必填字段的数据
通过 CSV 或 Odoo 导入工具导入记录时，导入文件中缺少的必填字段将导致导入失败。这实际上是正确的行为，但这让习惯于导入部分数据的用户感到惊讶。
在您的导入模板中始终包含所有必填字段。在您的数据导入指南中记录哪些字段是必填字段是一个好习惯。
陷阱 5：使用必填字段而不是 Python 约束进行复杂验证
属性 required 仅检查字段是否为空。它不会验证内容或字段之间的关系。对于更复杂的验证（例如，确保日期在未来，或确保两个字段一致），请在 Python 中使用 @api.constrains 装饰器。
仅仅将业务逻辑编码到必填字段中会导致灵活性差、难以维护的配置。
结论
必填字段 属性是 Odoo 中最简单的工具之一，但它对数据质量有着真正的影响。使用得当，它确保在业务流程的正确时刻始终捕获关键信息。使用不当，它会让用户感到沮丧，并创造出使数据不可靠而非更可靠的变通方法。
关键是理解模型级和视图级必填约束之间的区别，明确哪些字段确实需要强制执行，并提前考虑约束在自动化工作流和 API 集成中的行为。
无论您是在遵循 Odoo 开发者指南、进行完整的 Odoo 自定义项目，还是仅仅在 Odoo Studio 中调整表单，了解必填属性都是值得的。这是区分干净的 Odoo 实施与在上线六个月后引发头痛的实施之间的细节之一。
需要帮助进行 Odoo 实施吗？
在 Dasolo，我们帮助公司在所有业务职能和复杂性层面实施、定制和优化 Odoo。无论您需要帮助设计稳健的数据模型、配置验证规则，还是构建自定义模块，我们的团队都为每个项目带来了技术和功能方面的专业知识。
如果您对必填字段或Odoo设置的其他方面有疑问，我们乐意提供帮助。 请与我们联系 让我们谈谈您正在构建的内容。