Openerp对象字段定义详解

我就是我 2022-08-04 01:48 153阅读 0赞

**OpenERP对象支持的字段类型有:**

基础类型：char, text, boolean, integer, float, date, time, datetime, binary;

Openerp

char: 字符型，size属性定义字符串长度。  
text: 文本型，没有长度限制。  
boolean: 布尔型(true, false)  
integer: 整数。  
float: 浮点型，如 'rate' : fields.float('Relative Change rate',digits=(12,6)), digits定义整数部分和小数部分的位数。  
date: 日期型  
time: 时间型  
datetime: 日期时间型  
binary: 二进制型

复杂类型：selection, function, related, reference；

**selection**

Python代码   ![收藏代码][icon_star.png]

1.  selection: 下拉框字段。定义一个下拉框，允许用户选择值。如：'state': fields.selection((('n','Unconfirmed'),('c','Confirmed')),'State', required=True)，这表示state字段有两个选项('n','Unconfirmed')和('c','Confirmed')。

** function**

Python代码   ![收藏代码][icon_star.png]

1.  \#函数型，该类型的字段，字段值由函数计算而得，不存储在数据表中。其定义格式为：  
2.  fields.function(fnct, arg=None, fnct\_inv=None, fnct\_inv\_arg=None, type='float', fnct\_search=None, obj=None, method=False, store=True)  
3.    
4.  \#· type 是函数返回值的类型。  
5.  \#· method 为True表示本字段的函数是对象的一个方法，为False表示是全局函数，不是对象的方法。如果method=True，obj指定method的对象。  
6.  \#· fcnt 是函数或方法，用于计算字段值。如果method = true, 表示fcnt是对象的方法，其格式如下：def fnct(self, cr, uid, ids, field\_name, args, context)，否则，其格式如下：def fnct(cr, table, ids, field\_name, args, context)。ids是系统传进来的当前存取的record id。field\_name是本字段名，当一个函数用于多个函数字段类型时，本参数可区分字段。args是'arg=None'传进来的参数。  
7.  \#· fcnt\_inv 是用于写本字段的函数或方法。如果method = true, 其格式是：def fcnt\_inv(self, cr, uid, ids, field\_name, field\_value, args, context)，否则格式为：def fcnt\_inv(cr, table, ids, field\_name, field\_value, args, context)  
8.  \#· fcnt\_search 定义该字段的搜索行为。如果method = true, 其格式为：def fcnt\_search(self, cr, uid, obj, field\_name, args)，否则格式为：def fcnt\_search(cr, uid, obj, field\_name, args)  
9.  \#· store 表示是否希望在数据库中存储本字段值，缺省值为False。不过store还有一个增强形式，格式为 store=\{'object\_name':(function\_name,\['field\_name1','field\_name2'\],priority)\} ，其含义是，如果对象'object\_name'的字段\['field\_name1','field\_name2'\]发生任何改变，系统将调用函数function\_name，函数的返回结果将作为参数(arg)传送给本字段的主函数，即fnct。

** related**

Python代码   ![收藏代码][icon_star.png]

1.  \#关联字段，表示本字段引用关联表中的某字段。  
2.  格式为：fields.related(关系字段,引用字段,type, relation, string, ...)，关系字段是本对象的某字段（通常是one2many **or** many2many），引用字段是通过关系字段关联的数据表的字段，type是引用字段的类型，  
3.    
4.  如果type是many2one **or** many2many, relation指明关联表。例子如下：  
5.          'address': fields.one2many('res.partner.address', 'partner\_id', 'Contacts'),  
6.          'city':fields.related('address','city',type='char', string='City'),  
7.          'country':fields.related('address','country\_id',type='many2one', relation='res.country', string='Country'),  
8.    
9.  这里，city引用address的city字段，country引用address的country对象。在address的关联对象res.partner.address中，country\_id是many2one类型的字段，所以type='many2one', relation='res.country'。

**reference**

引用型，格式为：fields.reference(字段名, selection, size, ... )。其中selection是: 1)返回tuple列表的函数，或者 2)表征该字段引用哪个对象(or model)的tuples列表。reference字段在数据库表中的存储形式是（对象名，ID），如(product.product,3)表示引用对象product.product（数据表product\_product）中id=3的数据。reference的例子：  
def \_links\_get(self, cr, uid):  
cr.execute('select object,name from res\_request\_link order by priority')  
return cr.fetchall()  
  
...  
'ref':fields.reference('Document Ref 2', selection=\_links\_get, size=128),  
...  
上例表示，字段ref可以引用哪些对象类型的resource，可引用的对象类型从下拉框选择。下拉框的选项由函数\_links\_get返回，是(object,name)对的列表，如\[("product.product","Product"), ("account.invoice","Invoice"), ("stock.production.lot","Production Lot")\] 。

关系类型：one2one, one2many, many2one, many2many

**Openerp**

one2one: 一对一关系，格式为：fields.one2one(关联对象Name, 字段显示名, ... )。在V5.0以后的版本中不建议使用，而是用many2one替代。  
  
many2one: 多对一关系，格式为：fields.many2one(关联对象Name, 字段显示名, ... )。可选参数有：ondelete，可选值为"cascade"和"null"，缺省值为"null"，表示one端的record被删除后，many端的record是否级联删除。  
  
one2many: 一对多关系，格式为：fields.one2many(关联对象Name, 关联字段, 字段显示名, ... ),例：'address': fields.one2many('res.partner.address', 'partner\_id', 'Contacts')。  
  
many2many: 多对多关系。例如：  
'category\_id':fields.many2many('res.partner.category','res\_partner\_category\_rel','partner\_id','category\_id','Categories'),  
表示以多对多关系关联到对象res.partner.category，关联表为'res\_partner\_category\_rel'，关联字段为'partner\_id'和'category\_id'。当定义上述字段时，OpenERP会自动创建关联表为'res\_partner\_category\_rel'，它含有关联字段'partner\_id'和'category\_id'。

\*\*   **字段定义的参数  \*\***

**Openerp**

change\_default：别的字段的缺省值是否可依赖于本字段，缺省值为：False。例子(参见res.partner.address)，  
'zip': fields.char('Zip', change\_default=True, size=24),  
  
这个例子中，可以根据zip的值设定其它字段的缺省值，例如，可以通过程序代码，如果zip为200000则city设为“上海”，如果zip为100000则city为“北京”。  
  
readonly: 本字段是否只读，缺省值：False。  
required: 本字段是否必须的，缺省值：False。  
states: 定义特定state才生效的属性，格式为：\{'name\_of\_the\_state': list\_of\_attributes\}，其中list\_of\_attributes是形如\[('name\_of\_attribute', value), ...\]的tuples列表。例子(参见account.transfer)：  
'partner\_id': fields.many2one('res.partner', 'Partner', states=\{'posted':\[('readonly',True)\]\}),  
  
string: 字段显示名，任意字符串。  
translate: 本字段值（不是字段的显示名）是否可翻译，缺省值：False。  
size: 字段长度。  
priority:  
domain: 域条件，缺省值：\[\]。在many2many和many2one类型中，字段值是关联表的id，域条件用于过滤关联表的record。例子：  
'default\_credit\_account\_id': fields.many2one('account.account', 'Default Credit Account', domain="\[('type','!=','view')\]"),  
  
本例表示，本字段关联到对象('account.account')中的，type不是'view'的record。  
  
invisible: 本字段是否可见，即是否在界面上显示本字段，缺省值True。  
selection: 只用于reference字段类型，参见前文reference的说明。

**Openerp**

• Attributs 说明  
•context: 在context 中增加一些变量,这些变量可用于on\_change方法及domain条件式。  
•on\_change: 当本字段值改变时,调用Server端函数。例子:  
on\_change=”onchange\_shop\_id(shop\_id)”.  
•relation:当本字段是一个引用其他数据表的id 时,指定关联数据表名。通常用在related 和  
function 类型的字段中。  
  
• 级联关系:  
•ondelete  
•set null: 删除主记录时候,从记录到主记录的引用置为null。  
•set default: 删除主记录时候,从记录到主记录的引用置为缺省值。  
•cascade: 删除主记录时候,级联删除从记录。  
•restrict: 如果有从记录,不允许删除主记录。  
•no action: 不采取任何动作,即删除主记录,但保留从记录不变。

[icon_star.png]: /images/20220731/c149b4cbb31e49c7b4f4e679ff6c4b31.png