Odoo模型的内置方法(可按需重写)

转载请注明原文地址:https://www.cnblogs.com/ygj0930/p/10826222.html

 

==========模型层面==========

一:_table_exist

        检查该模型对于的数据库表是否存在,是则返回1,否则返回0.

@api.model_cr
    def _table_exist(self):
        pass

 

==========模型记录层面==========

二:create(self,vals)

         记录的创建函数,一般情况下,是根据视图传过来的dict对象,生成模型记录。

         我们可以重写create方法:1)获取vals参数,从中提前数据进行校验、替换;

                                             2)调用super(类,self).create(new_vals) 把新的dict作为参数执行记录创建。

 

三:write(self,vals)

         记录的修改函数,很少重写,参数也是dict。

         

四:read(self,fields)

        记录的查看函数,参数是查看哪些字段,默认是全字段,很少重写。

 

五:unlink(self)

         记录的删除函数,参数是当前数据记录集。一般重写该函数,校验记录的状态等,限制某些记录不能被删除。

 

六:_search(self, args, offset=0, limit=None, order=None, count=False, access_rights_uid=None)

         模型记录的搜索函数,定义了该模型的记录被关联搜索、搜索视图搜索时的条数、排序字段、总数、检索权限等。

 

七:name_get()

     name_get()函数定义了该模型的记录在被关联、搜索时,所显示出来的名字,默认是使用name字段的值。

     如果我们想自定义该模型的记录显示的名称,例如:使用 编码+name字段 显示的复合名称,则可以重写name_get()函数:

    @api.multi
    @api.depends('用于拼接名称字段', 'name')
    def name_get(self):
        """
        名称显示格式。
        """
        new_name = self.用于拼接名称字段 + self.name
        return [(self.id,new_name)]

 

八:name_search()

        name_get()定义了记录如何显示,那么name_search()则定义了记录如何被查找。

        name_search()定义了模型记录在被关联、被搜索时,通过输入的内容进行模糊查找的逻辑。

        默认情况下,是通过查找记录的 name  字段值是否与输入内容类似进行比对查找,我们可以改写模型的name_search()函数,把更多的字段加入比对中去。

    @api.model
    def name_search(self, name, args=None, operator='ilike', limit=查找条数):
        """
        名称模糊搜索。
        """
        args = args or []
        domain = []
        domain.append([(更多检索条件)])
        return super(类名, self).name_search(name, domain + args, operator=operator, limit=limit)

        或直接查找,返回所得记录集的name_get:

@api.model
def  name_search(self,name='',args=None,operator='ilike',limit=100):
    args = args or []
    domain = []
    if name:
        domain = ['|',('name',operator,name),('其他比对字段',operator,name)]
    pos = self.search(domain + args,limit=limit) //使用扩展后的条件进行查找
    return pos.name_get() //把查找结果的name返回

 

九:default_get()

        default_get(fields) 函数用于初始化记录的默认值,对于模型的某些字段如果需要设置默认值,可以重写模型的default_get()函数达到目的。

        例如:从表单中携带上下文信息跳转到向导、跳转到一个模型的新建表单视图等,可以在跳转时往context传递数据,然后在向导模型、被跳转创建的模型中重写default_get方法,从context中提前信息,进行字段默认值的初始化。

    @api.model
    def default_get(self, default_fields):
        result = super(类名, self).default_get(default_fields)
        context_data = self.env.context.get('key')
        //根据context_data进行相关数据查询、处理操作
        result.update({'字段': 默认值}) //更改记录的字段默认值
        return result

 

十:name_create(name)

        相当于只传递name字段值,调用create方法创建一条新记录。

 

十一:fields_get

        字段查询函数,一般不重写:以数据字典的形式返回字段的定义,通过继承得来的字段也会在其中,string/help/selection属性会自动被翻译

fields_get([fields],[attributes]):
    fields参数是字段列表、为空或不传返回所有字段
    attributes 可指定字段的属性、为空或不传时返回全部的

 

==========视图信息层面==========

十二:fields_view_get

        视图查询函数,一般不重写:返回指定视图的具体组成如:字段,所关联的模型,视图结构。

fields_view_get():
    view_id 视图的id或None
    view_type 当view_id参数为空时指定视图类型如form,tree等
    toolbar 参数为true时将上下文动作包含在内

 

十二:get_formview_action

       表单视图获取函数,可以重写该函数,使模型加载某个特定的form视图,甚至可以在加载时传递context值,控制视图的行为。

 

十三:load_views(views,options)

        视图加载函数,可以重写该函数,在加载视图时传递context值,控制视图行为。

 

posted @ 2019-05-07 16:18  keenyeh  阅读(5962)  评论(0编辑  收藏  举报