Odoo 13开发者文档：数据文件

本文来自Odoo 13官方文档之开发者文档系列文章

结构

在Odoo 中定义数据的主要方式是通过XML数据文件：主要的XML数据文件的结构如下：

• odoo根元素中的任意数量的操作元素

数据文件单独执行，操作仅能引用之前定义过的操作结果

核心操作

record

record相应地定义或更新数据库记录，有以下属性：

model (必传)

待创建(或更新)的模型名称

id

这条记录的外部标识符。强烈推荐进行提供

• 对于记录的创建，允许随后的修改或引用该记录的定义
• 对于记录修改，为要修改的记录

context

在创建记录时所使用的上下文

forcecreate

在更新模型下是否在记录不存在时进行创建

要求有一个 外部id，默认值为 True。

field

每条记录可由field 标签组成， 定义在创建记录时所设置的值。 不带field的record 会使用所有默认值（创建时）或什么都不做（更新时）。

field 有一个必选属性name ，为所要设置的字段的名称，以及定义值本身的各种方法：

不提供

如果不对字段提供任何值，会对字段设置一个隐式的 False 。可用于清除字段或避免对字段使用默认值。

search

对于关联字段，应当为一个字段模型中的 域。

会运行该域，使用它搜索字段模型并设置搜索的结果为字段值。若字段为Many2one类型我们仅使用第一个结果。

ref

若提供了ref 属性，其值必须为一个有效的外部id，会进行查找并设置为字段值。

大多针对 Many2one 及 Reference 字段

type

若提供了 type 属性，用于解析和转化字段的内容。字段的内容可通过使用file属性的外部文件或通过节点体提供内容。

可用的类型有：

xml, html

提取字段的子内容为单个文档，运行通过表单%(external_id)s所指定的任意 外部id。%% 可用于输出实际的% 符号。

file

确保字段内容为当前模型中的有限文件路径，保存模块,路径 对作为字段值

char

不进行修改直接设置字段内容为字段值

base64

base64-编码字段的内容，通过file 属性合并来加载如图片文件到附件中

int

转化字段的内容为整型并设置其作为字段值

float

转化字段的内容为浮点型并设置其作为字段值

list, tuple

应包含带有相同属性作为field 的任意数量 value 元素，每个元素解析为所生成元组或列表的一项，所生成的集合会设置为字段值

eval

对于前面方法不适用的情况，eval 属性只需运行所提供的Python表达式，并设置结果为字段值。

运行上下文包含各种模型(time, datetime, timedelta, relativedelta)，一个解析外部标识符 (ref) 的函数及可用时针对当前字段的模型对象 (obj)

delete

delete标签可删除任意数量前面定义的记录。有如下属性：

model (必传)

所指定应删除记录的模型

id

要删除记录的 外部id

search

查找要删除模型记录的域

id 及 search 是其独有的

function

function标签通过所提供参数调用模型中的方法。它拥有两个必须参数 model 和 name ，分别指定模型和要调用的方法名。

可以使用eval提供参数 (应运行为一个调用方法所使用的参数序列) 或 value 元素(参见 list 值)。

快捷标签

因为Odoo的一些重要结构模型很复杂又耗时，数据文件提供了更简短的替代方案，使用记录标签来进行定义：

menuitem

通过一些默认值或fallback来定义 ir.ui.menu 记录：

parent

• 如果设置了parent 属性，应当为其它菜单项的 外部id，用作新项的父级
• 若未提供 parent ，尝试解析 name属性为 /– 菜单名的分隔序列并在菜单等级中查找位置。在这一解析中，会自动创建中间菜单
• 否则会将菜单定义为“顶级”菜单项(非 无父级的菜单)

name

若未指定name 属性，尝试从存在的关联动作获取菜单名。否则使用该记录的 id

groups

groups 属性解析为res.groups模型的逗号分隔的外部标识符。若外部标识符有前缀减号(-)，会从菜单组中删除组

action

若指定，action属性应当为在打开菜单时所执行动作的外部标识符

id

菜单项的外部id

template

创建一个QWeb视图 ，仅要求有视图中的 arch 版块，并允许一些可选属性：

id

视图的外部标识符

name, inherit_id, priority

与 ir.ui.view 中的相应字段相同(nb: inherit_id 应为一个外部标识符)

primary

若设置为True 并与 inherit_id合并， 定义该视图为主视图

groups

外部标识符组的逗号分隔列表

page

若设置为 "True"，模型为一个网站页面 (可链接、可删除)

optional

enabled 或 disabled， 视图是否可（在网站界面中）禁用及其默认状态。如未进行设置，视图保持启用状态。

report

使用一些模型值创建一条 IrActionsReport 记录。

大多仅为 ir.actions.report中相应字段的代理属性，但也会自动在报表的model中的More菜单中创建菜单项。

CSV数据文件

XML数据是灵活且自描述的，但在批量创建一些模型的简单记录时会非常啰嗦。

对于这种情况，数据文件也可以使用 csv，常用于访问权限：

• 文件名为 model_name.csv
• 第一行通过特殊字段id作为 外部标识符（用于创建或更新）列出要写入的字段
• 然后每行新建一条记录

这里数据文件的前几行定义美国的州 res.country.state.csv

解析为更为可读的格式：

对于每行（记录）：

• 第一列是要创建或更新的记录的 外部id
• 第二列是要关联的国家对象的外部id (国家对象必须提前定义)
• 第三列是针对res.country.state的 name 字段
• 第四列是针对res.country.state的code 字段