odoo字段属性列举

罗列一些Odoo中的字段属性,基本包含大部分的属性。

常用字段属性

平平无奇常用字段属性

string:字段的标题,在UI视图标签中使用。它是可选项,如未设置,会通过首字母大写及将空格替换成为下划线来从字段名获取标签。

required:强制字段在用户界面中必填,默认为False。

readonly:让该字段在用户界面为只读,默认为False。

index:在设置为True时,为该字段创建一个数据库索引,有时可供更快搜索使用。 

help:在UI提示工具中显示的解释性文本。  

groups:让字段仅对安全组可见。它是一个包含安全组的XML ID逗号分隔列表的一个字符串。 

store:让计算字段等原本不保存的数据存储在数据库中,设置这个可以使计算字段可被搜索。

copy:标识在复制记录时是否拷贝字段值。对于非关系型字段和Many2one它的默认值是True,对One2many和计算字段它的值为False。

 

default

默认值,也可以是一个用于计算默认值的函数,例如default=_compute_default, _compute_default是模型中定义在字段前一个的方法。

 

related

关联属性,将相关的字段变成关联字段来访问值;

publisher_id = fields.Many2one("res.partner", string="Publisher", ondelete="set null", index=True)
publisher_city = fields.Char(string="Publisher City", related="publisher_id.city")

关联字段实际上是计算字段。它们仅提供⼀种⽅便的快捷语法来从关联模型读取字段值。作为⼀个计算字段,这意味着也可以使⽤store属性。

 

states

states允许用户界面依据state字段的值来动态设置readonly,required和invisible的值。因此,它要求存在一个state字段并在表单视图中使用(即使是隐藏的)。state属性的名称是在odoo硬编码且无法修改的。

 

compute

计算字段,默认为只读,需要定义一个函数以根据情况动态的生成该字段的值。并且该字段默认不能被搜索到。

计算字段在运⾏时动态计算,默认存储,可设置store=True将计算字段存储在数据库,并且此时可被搜索到;ORM使⽤缓存来避免在每次访问值时的低效重计算。它使⽤@depends装饰器来监测缓存值何时应置为⽆效并重新计算,因此, 它需要知道所依赖的其它字段。

date_release = fields.Date(string="Release Date")
# 计算字段,及让计算字段可编辑和可搜索
age_days = fields.Float(string="Days Since Release", compute="_compute_age", inverse="_inverse_age", search="_search_age", store=False, compute_sudo=False)  # compute_sudo 用于需要提权来执行计算的情况

# 值计算逻辑的方法
@api.depends("date_release")
def _compute_age(self):
    today = fields.Date.today()
    for book in self.filtered("date_release"):  # 筛选有 date_release 的书籍
        delta = today - book.date_release
        book.age_days = delta.days

关于计算字段的可编辑与可搜索可查看我的另一篇文章:odoo之技巧集合一-计算字段的可编辑与可搜索

 

ondelete

关联删除属性,决定在关联记录删除时执行什么操作。默认值为"set null",所有值如下:

  • "set null":会将该字段置为空值;
  • "restrice":会阻止关联字段记录的删除;
  • "cascade":导致关联的记录同样被删除;

示例:

partner_id = fields.Many2one("res.partner", ondelete="cascade")

 

context

上下文属性,context对关联字段有效,在点击字段进入关联视图时context会向客户端上下文添加变量。例如,我们可以使用它来为新纪录设置通过该视图创建的默认值。

 

domain

过滤属性,对关联字段有效,用来限制可用的关联记录列表的搜索过滤器。

示例:

category_id = fields.Many2one("library.book.category", string="Category", domain=[('id', 'in', ['4', '5', '6'])])

 

digits

用于Float字段并设置该字段的精度值,精度由总位数和小数位数对来定义。

length = fields.Float(string="长度", digits=(8, 3))。# 总长度为8位,小数位占3位

 

关联字段属性

共有属性

comodel_name

目标模型标识符,对所有关联字段强制使用,可以占位定义而无需使用关键字;

One2many,Many2many

limit

它在One2many和Many2many中使用,对在用户界面级别上用于记录读取的数量这是可选限制;当设置后,最多只能添加和显示n条数据。

author_ids = fields.Many2many("res.partner", string="Authors", limit=10)

One2many

inverse_name

它仅应用于One2many,是反向Many2one关联的目标模型中的字段名;

Many2many

  1. relation:用于Many2many字段。many2many关联表的名称默认使用两个关联模型名按字母排序加上一个_rel后缀来创建。但我们可以使用relation属性来进行覆盖。
  2. column1:这是连接这个模型的关联表中的Many2one字段的名称
  3. column2:这是在关联数据表中连接comodel的Many2one字段的名称 

 

其他字段属性

其他较少使用的字段

translate

在设置为True时,让字段可翻译,它可根据用户的界面语言保持不同值。

company_dependent

让该字段根据公司存储不同值。 

strip_style

和sanitize配合使用,见下个属性。 

sanitize

用于Html字段并去除包含不安全标签的内容。使用它会对输入进行全局清理。如果需要更精细的控制,可以使用一些关键字,仅在启用sanitize时生效。

  • sanitize_tags=True删除⽩名单列表以外的标签(默认项)
  • sanitize_attributes=True删除⽩名单列表以外的标签属性
  • sanitize_style=True删除⽩名单列表以外的样式属性
  • strip_style=True删除所有样式元素
  • strip_class=True删除所有class属性

这⾥所提及的各个⽩名单列表在odoo/tools/mail.py中定义。

 

posted @ 2021-05-06 09:22  YifChan  阅读(1447)  评论(0编辑  收藏  举报