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作为数据源，从中筛选数据】

【可以重写模型的该方法，自定义记录的筛选逻辑。】