
本文旨在指导用户如何在odoo产品变体(`product.product`)列表中,为产品模板(`product.template`)上的自定义字段添加高效的搜索功能。文章将详细阐述如何定义关联字段、配置搜索视图,并着重强调在使用关联字段作为搜索条件时,应正确利用`filter_domain`属性,以避免常见的领域表达式错误,从而实现精准且用户友好的产品变体搜索体验。
在Odoo的实际应用中,我们经常需要在产品变体(product.product)的视图中,根据其关联产品模板(product.template)上的信息进行筛选和搜索。例如,如果我们在产品模板上定义了一个自定义的“型号”字段,并希望在产品变体的列表中直接通过该型号进行搜索,就需要进行一些特定的配置。本教程将详细介绍如何实现这一功能,并纠正常见的配置错误。
1. 定义产品模板上的自定义字段
首先,我们需要在product.template模型上添加一个自定义字段,例如model_number。这个字段将用于存储产品的型号信息。
# /your_module/models/product_template.pyfrom odoo import fields, modelsclass 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.pyfrom odoo import fields, modelsclass 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进行搜索。
product.product.search.form.view.inherit product.product
说明:
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. 完整的代码示例
为了更好地理解,以下是包含所有必要部分的完整代码结构:
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, modelsclass ProductTemplate(models.Model): _inherit = 'product.template' model_number = fields.Char(string='型号', required=True, help="产品的型号编码")
your_module/models/product_product.py:
from odoo import fields, modelsclass 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_templatefrom . import product_product
your_module/views/product_template_views.xml (可选,用于在产品模板表单中显示字段):
product.template.form.view.inherit.model.number product.template
your_module/views/product_product_views.xml:
product.product.search.form.view.inherit product.product
5. 注意事项与最佳实践
模块依赖(depends):确保你的模块在__manifest__.py文件中正确声明了对product模块的依赖。store=True的重要性:如前所述,在关联字段model_number_search上设置store=True对于搜索性能至关重要。如果未设置,每次搜索都将涉及复杂的数据库连接查询,可能导致性能下降。更新模块:完成代码修改后,务必通过Odoo的应用程序界面(或命令行)更新你的模块,以使新的模型字段和视图定义生效。filter_domain与domain的区别:在普通的表单或列表视图中,domain用于限制显示哪些记录。在搜索视图的标签中,filter_domain用于定义当用户在该搜索字段中输入内容时,系统应如何过滤记录。它通常与self关键字一起使用,self代表用户输入的搜索值。字段命名规范:为避免混淆,建议为关联字段使用清晰的命名,例如model_number_search,以区分其在不同模型中的原始字段。
结论
通过本文的详细步骤,你现在应该能够成功地在Odoo产品变体列表中,为产品模板上的自定义字段添加搜索功能。关键在于理解并正确使用product.product上的关联字段以及搜索视图中filter_domain属性的机制。遵循这些最佳实践,可以有效地扩展Odoo的功能,提升用户体验和数据检索效率。
以上就是Odoo 产品变体搜索功能扩展:为产品模板自定义字段添加搜索支持的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1378769.html
微信扫一扫
支付宝扫一扫