通达科技 - 宜兴电脑维护及IT服务外包服务商

数据类型

主数据

主数据通常是模块的技术或业务需求的一部分。换句话说，这些数据通常是模块正常运行所必需的。这些数据将始终在安装模块时安装。

我们之前已经遇到过技术数据，因为我们已经定义了 视图 和 操作。这些是一种主数据。

除了技术数据外，还可以定义业务数据，例如国家、货币、计量单位，以及完整的国家本地化（法律报告、税务定义、账户图表）等等……

演示数据

除了主数据（模块正常工作所需的数据）外，我们还希望拥有演示目的的数据：

• 帮助销售代表快速制作演示文稿。

• 为开发人员准备一组工作数据，以便测试新功能并查看这些新功能与他们可能没有添加的数据的外观。

• 测试数据是否正确加载，且不会引发错误。

• 快速设置大部分要在创建新数据库时使用的功能。

如果您没有明确表示不需要，启动服务器时将自动加载演示数据。这可以在数据库管理器或命令行中完成。

$ ./odoo-bin -h
Usage: odoo-bin [options]

Options:
--version             show program's version number and exit
-h, --help            show this help message and exit

Common options:
  [...]
  --without-demo=WITHOUT_DEMO
                      disable loading demo data for modules to be installed
                      (comma-separated, use "all" for all modules). Requires
                      -d and -i. Default is none
[...]

$ ./odoo-bin --addons-path=... -d db -i account --without-demo=all

数据声明

清单

参考: 有关此主题的文档可以在 模块清单 中找到。

数据可以以 CSV 或 XML 的形式声明。每个包含数据的文件都必须在清单中添加才能加载。

在清单中添加新数据的键是 data （主数据）和 demo （演示数据）。两个值都应该是一个字符串列表，表示声明数据的相对路径。

通常，演示数据位于 demo 文件夹中，视图和操作位于 views 文件夹中，与安全相关的数据位于 security 文件夹中，其他数据位于 data 文件夹中。

如果您的工作目录看起来像这样：

estate
├── data
│   └── master_data.xml
├── demo
│   └── demo_data.xml
├── models
│   ├── *.py
│   └── __init__.py
├── security
│   └── ir.model.access.csv
├── views
│   └── estate_property_offer_views.xml
├── __init__.py
└── __manifest__.py

你的清单应该长这样：

# -*- coding: utf-8 -*-

{
    "name": "Real Estate",
    "depends": [
        ...
    ],
    "data": [
        "security/ir.model.access.csv",  # CSV and XML files are loaded at the same place
        "views/estate_property_offer_views.xml",  # Views are data too
        "data/master_data.xml",  # Split the data in multiple files depending on the model
    ],
    "demo": [
        "demo/demo_data.xml",
    ]
    "application": True,
}

逗号分隔值（CSV）

参考: 有关此主题的文档可以在 CSV 数据文件 中找到。

声明简单数据的最简单方法是使用CSV格式。但是，这种格式在功能方面有限：对于长列表中的简单模型，请使用它，但否则请使用XML。

id,field_a,field_b,related_id:id
id1,valueA1,valueB1,module.relatedid
id2,valueA2,valueB2,module.relatedid

XML

参考: 有关此主题的文档可以在 数据文件 中找到。

当要创建的数据更加复杂时，使用XML可能是有用的，甚至是必要的。

<odoo>
  <record id="id1" model="tutorial.example">
    <field name="field_a">valueA1</field>
    <field name="field_b">valueB1</field>
  </record>

  <record id="id2" model="tutorial.example">
    <field name="field_a">valueA2</field>
    <field name="field_b">valueB2</field>
  </record>
</odoo>

数据扩展

在核心培训中，我们在 第13章：继承 章节中看到我们可以继承 (扩展)一个现有的视图。这是数据扩展的一个特殊情况：任何 数据都可以在一个模块中扩展。

当您在新模块中向现有模型添加新字段时，您可能希望在依赖模块中创建的记录上填充这些字段。这可以通过给出要扩展的记录的 xml_id 来完成。它不会替换它，在这种情况下，我们将为两个记录设置给定值的 field_c 。

<odoo>
  <record id="id1" model="tutorial.example">
    <field name="field_c">valueC1</field>
  </record>

  <record id="id2" model="tutorial.example">
    <field name="field_c">valueC2</field>
  </record>
</odoo>

ref

相关字段可以使用 ref 键进行设置。该键的值是要链接的记录的 xml_id 。请记住， xml_id 由首次声明数据的模块的名称组成，后跟一个点，后跟记录的 id （如果您在声明模块中，则只使用 id 也可以）。

<odoo>
  <record id="id1" model="tutorial.example">
    <field name="related_id" ref="module.relatedid"/>
  </record>
</odoo>

eval

要分配给字段的值并不总是一个简单的字符串，您可能需要计算它。它还可以用于优化相关值的插入，或者因为约束强制您批量添加相关值。请参见: 添加X2many字段 。

<odoo>
  <record id="id1" model="tutorial.example">
    <field name="year" eval="datetime.now().year+1"/>
  </record>
</odoo>

search

有时候，你需要调用ORM来进行 search 。这在CSV格式中是不可行的。

<odoo>
  <record id="id1" model="account.move.line">
    <field name="account_id" search="[
      ('user_type_id', '=', ref('account.data_account_type_direct_costs')),
      ('company_id', '=', obj().env.company.id)]
    "/>
  </record>
</odoo>

在这段代码片段中，这是必需的，因为主数据取决于安装的本地化设置。

function

在加载数据时，您可能还需要执行Python代码。

<function model="tutorial.example" name="action_validate">
    <value eval="[ref('demo_invoice_1')]"/>
</function>

添加 X2many 字段

参考: 与此主题相关的文档可以在 Command 中找到。

如果您需要在 One2many 或 Many2many 字段中添加相关数据，您可以使用 Command 方法来实现。

<odoo>
  <record id="id1" model="tutorial.example">
    <field name="related_ids" eval="[
        Command.create({
            'name': 'My name',
        }),
        Command.create({
            'name': 'Your name',
        }),
        Command.link(ref('model.xml_id')),
    ]"/>
  </record>
</odoo>

访问数据

有多种方式可以访问主/演示数据。

在Python代码中，您可以使用 env.ref(self, xml_id, raise_if_not_found=True) 方法。它返回与您指定的 xml_id 相关联的记录集。

在 XML 中，您可以像这样使用 ref 键

<odoo>
  <record id="id1" model="tutorial.example">
    <field name="related_id" ref="module.relatedid"/>
  </record>
</odoo>

它将调用ref方法，并将返回的记录的id存储在类型为 tutorial.example 且id为 id1 的记录的 related_id 字段中。

在 CSV 中，列的标题必须以 :id 或 /id 结尾。

id,parent_id:id,name
"child1","module.parent","Name1"
"child2","module.parent","Name2"
"child3","module.parent","Name3"

在SQL中，情况更加复杂，请参阅 高级部分。

高级

什么是XML id？

由于我们不想在数据库的每个SQL表中都有一个列 xml_id ，因此我们需要一种机制来存储它。这是通过 ir.model.data 模型完成的。

它包含了记录的名称（ xml_id ），以及定义它的模块，定义它的模型和它的id。

没有更新

使用 noupdate 标志创建的记录在升级创建它们的模块时不会被更新，但如果它们不存在，则会被创建。

<odoo noupdate="1">
  <record id="id1" model="model">
    <field name="fieldA" eval="True"/>
  </record>
</odoo>

导入为SQL

在某些情况下，直接在SQL中进行导入是有意义的。但是，这是不鼓励的，因为它绕过了ORM的所有功能，包括计算字段（包括元数据）和Python约束。

• 它可以帮助大大加快导入时间 with huge files.

• 对于更复杂的导入，例如 translations。

• 有时候需要 初始化数据库。