介紹
二開(kāi)時(shí)模型創(chuàng)建完畢并配好視圖后對(duì)于基本的CRUD操作不需要再在代碼中實(shí)現(xiàn),框架會(huì)自動(dòng)提供這些功能,但如果我們的開(kāi)發(fā)需求不僅僅是對(duì)當(dāng)前對(duì)象的CRUD時(shí),就需要在框架原來(lái)方法的基礎(chǔ)上擴(kuò)展出一些自己所需要的操作。
odoo8以前與odoo8以后使用兩種不同的model接口形式(odoo8兩者都可使用),odoo8以前old api中,記錄ids和上下文環(huán)境均通過(guò)參數(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對(duì)象,用于與數(shù)據(jù)庫(kù)記錄無(wú)關(guān)的邏輯方法,例如:create方法。
@api.multi
封裝關(guān)聯(lián)多個(gè)數(shù)據(jù)記錄的Model對(duì)象,用于與數(shù)據(jù)庫(kù)記錄關(guān)聯(lián)的處理方法。
@api.one
封裝關(guān)聯(lián)單條數(shù)據(jù)記錄的Model對(duì)象,用于與單條數(shù)據(jù)庫(kù)記錄關(guān)聯(lián)的處理方法。
@api.onchange
頁(yè)面Fields值變更觸發(fā)的調(diào)用方法,見(jiàn)下文中onchange
@api.constrains
對(duì)添加數(shù)據(jù)自定義約束。
@api.constrains(‘field_name1’,’field_name2’,…) def _check_field(self):
# 校驗(yàn)方法 不符合校驗(yàn)條件拋出異常
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:列表可指定要讀取的屬性名稱(chēng)
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 頁(yè)面變更觸發(fā)事件
頁(yè)面Field值發(fā)生變更時(shí)由前端js框架觸發(fā)調(diào)用,一般用于控制頁(yè)面元素聯(lián)動(dòng)。
原型:def onchange(self, values, field_name, field_onchange)
default_get 設(shè)置缺省值
原型:def default_get(self, fields_list)
name_get 設(shè)置記錄顯示名
原型:def name_get(self)