Odoo如何管理模块数据

odoo作为世界排名第一的开源ERP系统，经过十几年发展，目前全世界odoo的使用者超过两百万人。odoo的底层结构强大，系统功能繁多，如销售，财务，库存等等，那么这些模块到底是如何进行数据管理，才能保证各个模块功能正常，数据正确而不错乱啦？接下来就让我们一起来看看吧。本节我们将一起学习如何在安装时添加可提供数据的插件模块。

技术准备

运行正常的odoo平台，具体环境搭建各位小伙伴可以自行搜索，这里就不过多赘述了。。。

使用CSV文件加载数据

首先我们一起来看看使用CSV文件加载数据，它的优势在于它是使用标准导出函数导出的数据格式。

准备工作

两个简单的基础模型

如何实现

在__manifest__.py中的data里添加security/ir.model.access.csv：

然后添加权限，

id：权限id，默认规则是access_模块名_类名

name：权限名，默认规则是模块名.类名

model_id:id：固定写法，规则是model_模块名_类名，其他地方引用权限会用这个id

group_id:id：组id，这里的base.group_user是系统内置组，即员工.员工组，创建账户时，默认属于这个组。所以给这个组赋权限，相当于给新账户的默认权限

perm_read：读权限（1是有权限，0是无权限）

perm_write：写权限（1是有权限，0是无权限）

perm_create：增加权限（1是有权限，0是无权限）

perm_unlink：删除权限（1是有权限，0是无权限）

运行原理

仅需将所有数据文件放到声明文件的数据列表中。odoo会通过文件扩展名来确定其文件类型。CSV文件的一个特别之处在于它必须匹配所导入的模型名称，本例中，该模型为 ir.model.access。第一行应为精确匹配模型字段名称的列名的头部。在通过CSV文件编写many2one字段时，odoo首先尝试将字段值解释为XML ID。如无点号，odoo会将当前模块名添加为命名空间，并在 ir.model.data中查找结果。如若失败，会使用字段值来作为参数调用模型的name_search函数，获取第一条返回的结果。如依然失败，该行被视为无效，odoo抛出错误。

扩展知识

也可通过CSV文件来导入one2many和many2many字段，但会有些麻烦。通常，最好是分别创建记录然后在XML文件中设置关联，或者通过另一个CSV文件来设置关联。

如果确需在同一个文件中创建关联记录，对数据列进行排序来让标量字段居左、关联模型字段居右，列头包含待关联字段名及所关联的模型字段，由冒号分隔：

上述例子中创建一个名为my group的组，可以通过在组记录的右侧添加列来写入更多的字段。如果需要关联多条记录，重复该行并修改右侧列为对应值。因odoo会为空列填写前一行的值，所以无需拷贝所有数据，添加一行时，对想要填充值的关联模型字段以外的字段只需使用空值。

使用XML文件加载数据

上述中，我们已经学会了如何使用CSV文件加载数据，接下来，我们会通过XML文件来添加另一种类型的数据。我们添加一条书和作者的演示数据。还会添加在模块中添加出版社作为常规数据。

如何实现

按照如下步骤创建两个XML文件并在__manifest__.py文件中进行关联。

在你的声明文件中的demo版块中添加一个名为 data/demo.xml的文件：

在该文件中添加如下内容：

在声明文件的data版块中添加一个名为data/data.xml 的文件：

在data/data.xml 文件中加入如下 XML 内容：

此时如果更新模块，可以看到我们添加的书的记录，点击进去就可以看到作者名和出版社

运行原理

XML数据文件使用<record>标签来创建数据表中一行。<record>标签有两个必填属性：id和model。对于 id 属性，即为外部ID，可以通过ref函数来调用，model属性引用模型的_name属性。然后，使用<field>元素来填入数据库中列，这在你所命名的模型中定义。模型还决定哪些字段是必填的并且定义了默认值。在这种情况下，无需显式地给这些字段赋值。

有两种方式在模块的声明文件中注册XML文件。一种是通过data键，另一种是通过demo键。data键中的数据文件在每次安装或更新模块时进行加载。而demo键中的XML文件仅在对数据库启用了演示数据时才会加载。

第1步中，我们使用了demo键在声明文件中注册了XML数据文件。因为使用的是demo键，XML文件仅在对数据库启用了演示数据时才会加载。

在第2步中，<field>元素可以在为标量值时可包含简单文本值。如果需要传递一个文件的内容（例如设置图片时），使用<field>元素的file属性并传递相对插件路径的文件名。

设置引用有两种方式。最简单的一种是使用ref属性，可用于many2one字段，仅需包含所要引用记录的XML ID。对于one2many和many2many字段，我们需要使用eval属性。这是一种通用目的属性，可用于运行Python代码来作为字段值使用，例如使用strftime(‘%Y-01-01’)来填充date字段。one2many和many2many中应使用三个元素元组列表，元组的第一个值决定所要采取的操作。在eval属性内，我们可以访问一个名为ref的函数，它返回以字符串传入的XML ID 对应的数据库ID。这让我们不需要知道在不同的数据库中原始ID是否不同，也可直接引用记录，如下所示：

(2, id, False)：它会删除通过数据库 id 所关联的记录。元组的第三个元素被忽略。

(3, id, False)：它通过id取消记录的one2many字段关联。注意这个操作不会删除原记录，已有记录保持原样。元组的最后一个元素也被忽略。

(4, id, False)：它添加一个已有记录 id的关联，元组的最一个元素被忽略。这应该是最常使用到的，通常伴有ref函数来通过其XML ID来获取记录的数据库 ID。

(5, False, False)：它会切断所有关联，但仍保持所关联的记录的完整性。

(6, False, [id, …])：它会清除当前引用的记录来将它们替换为 ID 列表中包含的记录。元组的第二个元素被忽略。

第3和第4步同前两步，只是使用data键来取代了demo键。这表示每次安装或升级模块时都会加载这些XML文件。

重要：注意数据文件中的顺序很重要，并且数据文件中的记录仅能引用该文件之前列表中数据文件所定义的记录。这也是为什么需要保持查看模块是否在空数据库中安装，因为在开发过程中，会经常在各处添加记录，能够使用的前提是后续所定义记录通过前几次更新已存在于数据库中。

扩展知识

字段元素还可以包含function元素，它调用模型中的方法来提供字段值。参见在XML文件中调用函数一节，其中我们仅通过调用函数来在应用中直接绕过加载机制并写入数据库，

前述列表中没有包含0和1，因为在载入数据时这两者并没有什么用处。为保持完整性，说明如下：

(0, False, {‘key’: value})：它会新建所引用模型的记录，字段值由第3个位置参数的字典填写。元组的第二个元素被忽略。因为这些记录不包含XML ID并在每次更新模块时运行，会导致重复数据，最好避免使用。

(1, id, {‘key’: value})：它可用于写入已关联的记录。由于上述的同样原因，应避免在XML文件中使用这种语法。

在XML文件中调用 函数

可以通过XML文件创建各种类型的记录，但有时生成包含一些业务逻辑的数据会很困难。我们可能会希望用户在生产环境中安装依赖模块时修改记录。例如，假设你想要创建一个模块来在线展示书籍。my_library模块已有图片封面字段。设想在新的模块中你实现了缩减图像大小以及在新的缩略图字段中存储它的逻辑。现在在用户安装这一模块时，可能已有图书和图像了。不太可能在XML文件中通过<record>标签生成缩略图。在这种情况下，可以通过<function>标签调用模型方法。