Odoo 产品变体搜索功能扩展：为产品模板自定义字段添加搜索支持

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

Odoo 产品变体搜索功能扩展：为产品模板自定义字段添加搜索支持

2025-11-09

浏览次数：次

返回列表

Odoo 产品变体搜索功能扩展：为产品模板自定义字段添加搜索支持

本文旨在指导用户如何在odoo产品变体（`product.product`）列表中，为产品模板（`product.template`）上的自定义字段添加高效的搜索功能。文章将详细阐述如何定义关联字段、配置搜索视图，并着重强调在使用关联字段作为搜索条件时，应正确利用`filter_domain`属性，以避免常见的领域表达式错误，从而实现精准且用户友好的产品变体搜索体验。

在Odoo的实际应用中，我们经常需要在产品变体（product.product）的视图中，根据其关联产品模板（product.template）上的信息进行筛选和搜索。例如，如果我们在产品模板上定义了一个自定义的“型号”字段，并希望在产品变体的列表中直接通过该型号进行搜索，就需要进行一些特定的配置。本教程将详细介绍如何实现这一功能，并纠正常见的配置错误。

1. 定义产品模板上的自定义字段

首先，我们需要在product.template模型上添加一个自定义字段，例如model_number。这个字段将用于存储产品的型号信息。

# /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="产品的型号编码")

说明：

_inherit = 'product.template'：表示我们正在扩展Odoo原生的product.template模型。
model_number = fields.Char(...)：定义了一个字符型字段，用于存储型号。required=True表示该字段为必填项。

2. 在产品变体模型上定义关联字段

由于搜索功能是在product.product视图中进行的，但model_number字段定义在product.template上，我们需要在product.product模型上创建一个关联字段，以便能够直接访问product.template上的model_number。

# /your_module/models/product_product.py

from odoo import fields, models

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

    # 关联到产品模板的model_number字段
    model_number_search = fields.Char(
        related='product_tmpl_id.model_number',
        string='型号',
        readonly=True,
        store=True, # 强烈建议设置为True，以提高搜索性能
        help="关联产品模板的型号，用于搜索"
    )

说明：

_inherit = 'product.product'：扩展product.product模型。
related='product_tmpl_id.model_number'：这是关键。它将model_number_search字段关联到当前产品变体所对应的产品模板（product_tmpl_id）上的model_number字段。
store=True：非常重要。将此属性设置为True，Odoo会在数据库中为model_number_search字段实际存储值。这意味着在进行搜索时，Odoo可以直接查询数据库中的该字段，而不是每次都通过关联关系动态计算，从而显著提高搜索性能。

3. 扩展产品变体搜索视图

现在，我们将在product.product的搜索视图中添加一个搜索字段，允许用户通过model_number_search进行搜索。

<!-- /your_module/views/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>

说明：

inherit_id="product.product_search_form_view"：继承Odoo原生的产品变体搜索视图。
xpath expr="//field[@name='name']" position="after"：在名称搜索字段之后插入我们的自定义搜索字段。
name="model_number_search"：这里引用的是我们在product.product模型上定义的关联字段。
filter_domain="[('model_number_search', 'ilike', self)]"：这是解决问题的关键所在。
- 错误示例分析： 原始代码中使用了domain="[('product_tmpl_id.model_number', 'ilike', self)]"。当在搜索视图的标签上使用domain属性时，Odoo期望这个domain是直接作用于当前模型（product.product）的字段。而('product_tmpl_id.model_number', 'ilike', self)虽然在逻辑上是正确的路径，但Odoo的搜索机制在处理domain属性时，对于这种跨模型的复杂路径解析不够直接，尤其当字段本身是关联字段时，容易导致“Domain on non-relational field ... makes no sense”的错误。
- 正确用法：filter_domain。filter_domain属性专门用于定义当搜索字段被激活时，应该应用到当前模型（product.product）上的实际过滤条件。它允许我们使用当前模型上的字段（包括关联字段），并结合用户输入（self）来构建查询。
- ('model_number_search', 'ilike', self)：表示当用户在“型号”搜索框中输入值时，系统将查找product.product记录中model_number_search字段包含（不区分大小写）用户输入值（self）的记录。

4. 完整的代码示例

为了更好地理解，以下是包含所有必要部分的完整代码结构：

培训招生教育类网站模板(响应式)1.4.2

培训招生教育类网站模板(响应式)安装即用，自带人人站CMS内核，支持响应式，前端banner轮播图文本均已进行可视化配置，伪静态页面生成，支持内容模型、多语言、自定义表单、筛选、多条件搜索等功能，支持多种URL模式及模型。模板特点：1、安装即用，自带人人站CMS内核及企业站展示功能（产品，新闻，案例展示等），并可根据需要增加表单搜索等功能（自带模板） 2、支持响应式 3、前端banner轮播图文

0 查看详情培训招生教育类网站模板(响应式)1.4.2

your_module/__manifest__.py:

{
    'name': "Product Variant Model Search",
    'version': '1.0',
    'category': 'Sales/Product',
    'summary': 'Adds model number search to product variants.',
    'depends': ['product'],
    'data': [
        'security/ir.model.access.csv', # 如果有自定义模型，需要权限文件
        'views/product_template_views.xml', # 如果需要显示在产品模板视图中
        'views/product_product_views.xml',
    ],
    'installable': True,
    'application': False,
    'auto_install': False,
}

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="产品的型号编码")

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,
        help="关联产品模板的型号，用于搜索"
    )

your_module/models/__init__.py:

from . import product_template
from . import product_product

your_module/views/product_template_views.xml (可选，用于在产品模板表单中显示字段):

<odoo>
    <data>
        <record id="product_template_form_view_inherit_model_number" model="ir.ui.view">
            <field name="name">product.template.form.view.inherit.model.number</field>
            <field name="model">product.template</field>
            <field name="inherit_id" ref="product.product_template_form_view"/>
            <field name="arch" type="xml">
                <xpath expr="//field[@name='default_code']" position="after">
                    <field name="model_number"/>
                </xpath>
            </field>
        </record>
    </data>
</odoo>

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>

5. 注意事项与最佳实践

模块依赖（depends）：确保你的模块在__manifest__.py文件中正确声明了对product模块的依赖。
store=True的重要性：如前所述，在关联字段model_number_search上设置store=True对于搜索性能至关重要。如果未设置，每次搜索都将涉及复杂的数据库连接查询，可能导致性能下降。
更新模块：完成代码修改后，务必通过Odoo的应用程序界面（或命令行）更新你的模块，以使新的模型字段和视图定义生效。
filter_domain与domain的区别：
- 在普通的表单或列表视图中，domain用于限制显示哪些记录。
- 在搜索视图的标签中，filter_domain用于定义当用户在该搜索字段中输入内容时，系统应如何过滤记录。它通常与self关键字一起使用，self代表用户输入的搜索值。
字段命名规范：为避免混淆，建议为关联字段使用清晰的命名，例如model_number_search，以区分其在不同模型中的原始字段。