一:纪录集API
model中的数据是以集合的形式使用的,因此可以使用集合运算来操作。
-
集合运算符
- record in set返回record是否在set中,record须为单条记录,record not in set反之
- set1 <= set2 返回set1是否为set2的子集
- set1 >= set2 返回set2是否为set1的子集
- set1 | set2 返回set1和set2的并集
- set1 & set2 返回set1和set2的交集
- set1 - set2 返回在集合set1中但不在set2中的记录
集合运算API:
- ids 得到当前记录集合的id列表
- ensure_one() 验证一个记录集合是否只包含一条记录
- exists() 返回当前记录集中真正存在的子集,并把缓存中未删除的部分做标记,可用于判断
if record.exists():
- filtered(func) 返回满足func参数内条件的记录集合,参数可以是一个函数或者用.分隔的字段列表
- sorted(key=None, reverse=False) 返回按key排序之后的记录集,key参数可以是一个返回单个key的函数或字段名称或为空,reverse参数为True时即为倒序
- mapped(func) 将func函数应用到所有记录上,并返回记录列表或集合
二:运行环境API
运行环境保存了很多ORM相关的变量:数据库查询游标、当前用户、元数据,还存有缓存,可使用env
来访问,如:
records.env.user
records.env.cr
records.env.context
更改运行环境:
- sudo() 使用现有数据集创建一个新运行环境,得到一个基于新运行环境的数据集的拷贝
env['res.partner'].sudo().create({'name': "A Partner"})
- with_context()
一个参数时可用于替换当前运行环境的context,多个参数时通过keyword添加到当前运行环境context或单参数时设置的context - with_env() 完整替换当前运行环境
三:ORM API
search() 接收domain表达式参数,返回符合条件的数据集合,可以通过limit,offset参数返回一个子集,还可通过order参数对数据排序。
self.search([('is_company', '=', True), ('customer', '=', True)])
search_count():统计满足条件的数据数量
create() 接收多个字段、值的组合,返回新创建的数据集:
self.create({'name': "New Name"})
write() 接收多个字段、值组合,会对指定数据集的所有记录进行修改,不返回:
self.write({'name': "Newer Name"})
browse() 根据数据的id或者一组id来查找,返回符合条件的数据集合:
self.browse([7, 18, 12])
exists() 得到某个数据集中保留在数据库中的那部分(可用于检查数据集是否为空):
if not record.exists(): raise Exception("The record has been deleted")
ref() 运行环境函数,根据提供的外部id返回对应的数据记录:
env.ref('base.group_public')
ensure_one() 检验某数据集是否只包含单条数据,如果不是则报错:
records.ensure_one()
四:搜索函数
-
search(args[, offset=0][, limit=None][, order=None][, count=False])
根据args参数里的domain表达式来搜索所有记录,参数列表:
1.args:domain表达式,为空时返回所有记录
2.offset (int) 从第几条记录开始取
3.limit (int) 返回记录行数的最大值
4.order (str) 排序的字段
5.count (bool) 当值为True的时候只返回匹配记录的条数 -
search_count(args)
返回根据给定domain表达式参数查询所得到的记录条数 -
name_search(name='', args=, operator='', limit=)
返回根据name条件来查询,并满足args指定的domain表达式的记录集合 -
name (str) -- 用来匹配的name字符串 args (list) -- domain表达式列表 operator (str) -- 用来匹配的操作符,如: 'like' , '='. limit (int) -- 可选参数,最多返回的记录行数
五:字段或视图查询
字段查询:
fields_get([fields][, attributes]) 以数据字典的形式返回字段的定义,通过继承得来的字段也会在其中,string/help/selection属性会自动被翻译 fields参数是字段列表、为空或不传返回所有字段 attributes 可指定字段的属性、为空或不传时返回全部的
视图查询:
fields_view_get([view_id | view_type='']) 返回指定视图的具体组成如:字段,模型,视图结构 参数列表: view_id 视图的id或None view_type 当view_id参数为空时指定视图类型如form,tree等 toolbar 参数为true时将上下文动作包含在内
default_get(fields) 获取指定字段的默认值
name_get() 以列表形式返回每条记录的描述,默认是display_name字段
name_create(name) 相当于调用create方法创建一条新记录而只设置一个display_name