Odoo中为产品变体界面添加产品模板字段搜索功能指南

本教程详细指导如何在odoo的产品变体（`product.product`）列表中，通过关联字段实现对产品模板（`product.template`）上自定义字段的搜索功能。文章将涵盖自定义字段定义、关联字段创建，并重点解析在搜索视图中使用`filter_domain`而非`domain`的关键区别，解决常见错误，确保搜索功能正确生效。

在Odoo的实际应用中，我们经常需要在产品变体（product.product）的列表或搜索界面中，根据产品模板（product.template）上的特定字段进行筛选。由于product.product是product.template的子模型，直接在product.product的搜索视图中引用product.template的字段需要特定的处理方式。本教程将详细讲解如何实现这一功能，并纠正常见的错误用法。

1. 在产品模板中定义自定义字段

首先，我们需要在product.template模型上定义一个自定义字段。这个字段将存储我们希望在产品变体界面中进行搜索的数据。

# 文件: your_module/models/product_template.py

from odoo import fields, models

class ProductTemplate(models.Model):
    _inherit = 'product.template'

    model_number = fields.Char(string='型号', required=True, help="产品的型号或SKU")

在上述代码中，我们通过继承product.template模型，添加了一个名为model_number的字符型字段，用于存储产品的型号信息。

2. 在产品变体模型中创建关联字段

为了让product.product模型能够直接访问product.template上的model_number字段，我们需要在product.product模型上创建一个关联（related）字段。这个关联字段将作为在product.product搜索视图中引用的桥梁。

# 文件: your_module/models/product_product.py

from odoo import fields, models

class ProductProduct(models.Model):
    _inherit = 'product.product'

    # 关联到产品模板的型号字段
    model_number_search = fields.Char(
        related='product_tmpl_id.model_number',
        string='型号搜索',
        readonly=True,
        store=True, # 设置为True，以便在数据库中存储，提高搜索性能
        help="产品模板的型号，用于在产品变体界面进行搜索"
    )

字段属性说明：

• related='product_tmpl_id.model_number'：这是核心部分，它将此字段关联到当前产品变体所对应的产品模板的model_number字段。
• readonly=True：由于这是一个关联字段，其值由product.template上的源字段决定，因此通常设置为只读。
• store=True：将此字段的值存储在product.product表的数据库中。虽然不是强制性的，但对于频繁进行搜索的字段，将其存储可以显著提高搜索性能，避免每次查询都进行跨表连接。

3. 修改产品变体搜索视图

现在我们已经准备好了自定义字段和关联字段，下一步是在product.product的搜索视图中添加一个搜索框。这一步是整个实现过程中最容易出错的地方，尤其是在domain和filter_domain的选择上。

正确的XML代码示例如下：

百度文心百中

百度大模型语义搜索体验中心

22

查看详情

<!-- 文件: your_module/views/product_product_views.xml -->

<odoo>
    <data>
        <record id="product_product_search_form_view_inherit" model="ir.ui.view">
            <field name="name">product.product.search.form.view.inherit</field>
            <field name="model">product.product</field>
            <field name="inherit_id" ref="product.product_search_form_view"/>
            <field name="arch" type="xml">
                <xpath expr="//field[@name='name']" position="after">
                   <field name="model_number_search" string="型号"
                           filter_domain="[('model_number_search', 'ilike', self)]"/>
                </xpath>
            </field>
        </record>
    </data>
</odoo>

关键点：filter_domain与domain的区别

这是解决原始问题并确保搜索功能正常工作的核心。

• domain属性： 当你在<field>标签中使用domain属性时，Odoo期望这个域表达式能够直接应用于当前字段或其直接关联。例如，如果model_number_search是一个存储在product.product模型上的常规字段，那么domain="[('model_number_search', 'ilike', self)]"是有效的。然而，当你尝试使用类似domain="[('product_tmpl_id.model_number', 'ilike', self)]"这样的表达式时，Odoo会报错，因为它认为你正在一个非关系字段（model_number_search本身）上应用一个涉及多级关联的域。self在这里代表用户在搜索框中输入的字符串。

• filter_domain属性：filter_domain是专门为这种场景设计的。它允许你定义一个独立的域表达式，该表达式将应用于当前模型的记录集，并且可以使用搜索字段的输入值（self）作为条件。

  • 当用户在model_number_search字段对应的搜索框中输入文本时，self变量将包含该文本。
  • filter_domain="[('model_number_search', 'ilike', self)]"告诉Odoo，将用户输入的值（self）用于筛选product.product模型上的model_number_search字段，查找包含该值的记录。
  • 由于model_number_search字段已经通过related属性关联到了product.template的model_number，因此这个筛选最终会作用于产品模板的型号。

简而言之，domain通常用于字段的静态筛选或依赖于其他字段的简单筛选，而filter_domain则用于构建动态的、更复杂的搜索条件，特别是当搜索字段本身并不直接对应数据库列，或者需要根据用户输入构建跨字段的查询时。

4. 部署与测试

完成上述代码修改后，你需要：

1. 将你的Odoo模块添加到Odoo的插件路径中。
2. 通过Odoo的应用程序界面（“Apps”菜单）升级你的模块。
3. 导航到“销售” -> “产品” -> “产品变体”列表视图。
4. 在搜索栏中，你应该能看到新添加的“型号”搜索框。输入型号信息进行测试，确认搜索功能是否正常。

总结

通过本教程，我们学习了如何在Odoo的产品变体界面中，为产品模板上的自定义字段添加搜索功能。关键步骤包括：在product.template上定义自定义字段，在product.product上创建指向该字段的关联字段，以及最重要的是，在搜索视图中正确使用filter_domain属性来构建搜索条件。理解domain和filter_domain之间的区别，是解决此类Odoo开发问题的关键。正确运用filter_domain不仅能避免错误，还能提供灵活且高效的搜索体验。

以上就是Odoo中为产品变体界面添加产品模板字段搜索功能指南的详细内容，更多请关注php中文网其它相关文章！