Odoo search 搜索视图详解与搜索视图工作原理
转载请注明原文地址:https://www.cnblogs.com/ygj0930/p/10826430.html
搜索视图
搜索视图的search标签本身没什么属性可以使用,只要是<search></search>标签之间的内容定义了搜索动作。
1:field
field标签定义了用于搜索过滤的字段有哪些。
searchview中的field字段只是说明了可以用哪些字段来作过滤,并且在搜索框输入时会自动启用搜索字段的模糊搜索功能以供候选。
可有以下几种属性,进一步指定使用某些字段的某些过滤条件进行记录筛选:
- name -- 作为过滤条件的字段名
- string -- 字段的label
- operator -- 默认情况下field会生成[(name, operator, provided_value)]格式的表达式,其中name是字段名,provided_value是用户提供的值,operator属性可被重写默认的运算符(默认情况下是根据字段类型分配,数字型是=,字符型是ilike)
- filter_domain -- 用于搜索的完整的domain表达式,可以用self变量来代表当前记录的当前字段值,当operator和filter_domain同时赋值时,filter_domain有最高优先级
<field name="name" filter_domain="['|', '|', ('明确的字段内容', 'ilike', self), ('shortdesc', 'ilike', self), ('name', 'ilike', self)]" string="Theme"/>
- context -- 上下文的值。【具体用法:待研究】
- groups -- 使该字段只对某些用户组可用。
- widget -- 使用指定的搜索部件(唯一的用例是V8的many2one字段选择插件)
- domain -- 如果用于搜索的字段是 关联字段,使用domain来过滤候选的搜索选项。
2:filter
过滤器,比filed字段更具体。searchview中的field字段只是说明了可以用哪些字段来作过滤,并且在搜索框输入时会自动启用搜索字段的模糊搜索功能以供候选;而filter则更加具体,它的domain属性或context属性,指明了具体的字段值过滤条件,符合条件的记录才会作为最终搜索结果显示出来。
- string (required) -- 过滤器的label
- domain -- 一个domain表达式,被添加到action的domain表达式中,作为搜索的domain表达式一部分,作用于最终的记录过滤。
- context -- 一个python字典对象,被合并到action的domain表达式中,用于传递搜索的domain表达式的值
filter中的context,是dict类型。
a)传递分组依据:
context="{'group_by':'字段'}"
b)为domain表达式传递变量值
context="{'key':value}"
- name -- 过滤器的逻辑名【在action跳转到搜索视图时,可以在context中指明默认启用哪个filter,就是通过name值来启用的】
<record id="action_hr_timesheet_attendance_report" model="ir.actions.act_window"> <field name="context">{'search_default_过滤器name': True}</field> </record>
- help -- 过滤器的描述文字
- groups -- 指定过滤器可用的用户组。
3:separator
分割线。用于将过滤器按组分开,更好看。
4:group
分局布局,用于过滤器比较多的情况下,分组排放。
5:默认搜索
搜索字段和过滤条件可以通过action的context使用search_default_name 配置,对于字段就是需要搜索的值,对过滤器它是一个布尔值:
{ 'search_default_foo': 'acro', 'search_default_bar': 1 } #自动激活bar过滤器,并在foo字段搜索acro
综上,搜索视图的过滤条件制定有2种方式:
1)通过filter的domain属性。表达式的值:
a)可以是具体的明确值;
b)可以是python运算表达式(不过不能取具体记录字段值,可以是python语言本身的一些库函数调用的运算表达式)。
c)可以是一个变量名,变量值则通过context来赋予。一般用于制定默认搜索条件,在context中传递key:value。
<filter name="" string="" domain="[('字段', '比较运算符', 值[值可以是具体的明确值;也可以是python运算表达式(不过不能取具体记录字段值,可以是python语言本身的一些库函数调用的运算表达式)]))]"/>
2)通过action的domain字段:action中的domain表达式,会在跳转时自动应用
<record id="action_" model="ir.actions.act_window"> <field name="name"></field> <field name="res_model"></field> <field name="domain">[(表达式)]</field> </record>
搜索条件的工作原理:
odoo模型中有个方法:read_group(self, domain, fields, groupby, offset=0, limit=None, orderby=False, lazy=True)
该方法用于读取搜索视图上的过滤条件,并使用过滤条件搜索模型记录。
其中,domain是一个list,里面是一个个的表达式,由 action中的domain+fiter中的domain+界面上临时应用的筛选条件 拼接而成。
工作流程为:
action打开tree视图——调用模型的read_group()函数,根据domain条件,调用模型的search(domain)进行检索——把记录集返回界面上呈现;
每当界面上点击了 筛选——过滤器 或 筛选——自定义筛选 ,都会调用一次read_group()函数,重新拼接domain列表,并检索模型数据。【多维分析中也是该逻辑,不过是从sql查询出来的view作为数据源,从中筛选数据】
【可以重写模型的该方法,自定义记录的筛选逻辑。】