介紹
二開時模型創(chuàng)建完畢并配好視圖后對于基本的CRUD操作不需要再在代碼中實現(xiàn)沮明,框架會自動提供這些功能,但如果我們的開發(fā)需求不僅僅是對當(dāng)前對象的CRUD時窍奋,就需要在框架原來方法的基礎(chǔ)上擴展出一些自己所需要的操作荐健。
odoo8以前與odoo8以后使用兩種不同的model接口形式(odoo8兩者都可使用),odoo8以前old api中琳袄,記錄ids和上下文環(huán)境均通過參數(shù)傳入def old_api (self, cr, uid, ids, context)
摧扇,比較凌亂,不建議使用挚歧。以下內(nèi)容均為new api內(nèi)容扛稽。
api裝飾器
@api.model
封裝不關(guān)聯(lián)數(shù)據(jù)記錄的Model對象,用于與數(shù)據(jù)庫記錄無關(guān)的邏輯方法,例如:create方法滑负。
@api.multi
封裝關(guān)聯(lián)多個數(shù)據(jù)記錄的Model對象在张,用于與數(shù)據(jù)庫記錄關(guān)聯(lián)的處理方法。
@api.one
封裝關(guān)聯(lián)單條數(shù)據(jù)記錄的Model對象,用于與單條數(shù)據(jù)庫記錄關(guān)聯(lián)的處理方法矮慕。
@api.onchange
頁面Fields值變更觸發(fā)的調(diào)用方法帮匾,見下文中onchange
@api.constrains
對添加數(shù)據(jù)自定義約束。
@api.constrains(‘field_name1’,’field_name2’,…) def _check_field(self):
# 校驗方法 不符合校驗條件拋出異常
model方法
create 創(chuàng)建記錄
原型:def create(self, vals)
vals:記錄屬性值字典
search 查找記錄
原型:def search(self, args, offset=0, limit=None, order=None, count=False)
args:domain格式的條件列表痴鳄;offset:結(jié)果忽略條數(shù)瘟斜;limit:最大查詢條數(shù)
read 讀取記錄屬性值
返回指定ids記錄的指定fields字段值,采用列表加字典的數(shù)據(jù)結(jié)構(gòu)([{},{},…])返回痪寻。
原型:def read(self, fields=None, load='_classic_read'):
fields:列表可指定要讀取的屬性名稱
search_read
原型:def search_read(self, domain=None, fields=None, offset=0, limit=None, order=None)
用法即search方法與read方法相結(jié)合螺句。
unlink 刪除記錄
原型:def unlink(self)
write 修改記錄
原型:def write(self, vals)
vals:修改屬性值字典
onchange 頁面變更觸發(fā)事件
頁面Field值發(fā)生變更時由前端js框架觸發(fā)調(diào)用,一般用于控制頁面元素聯(lián)動橡类。
原型:def onchange(self, values, field_name, field_onchange)
default_get 設(shè)置缺省值
原型:def default_get(self, fields_list)
name_get 設(shè)置記錄顯示名
原型:def name_get(self)