第 5 章:安全 - 简要介绍

在 上一章 中,我们创建了第一张用于存储业务数据的表。在 Odoo 这样的业务应用中,首先要考虑的问题之一是 who 1 可以访问数据。Odoo 提供了安全机制,允许特定用户组访问数据。

安全这一主题在 限制数据访问 中有更详细的介绍。本章旨在涵盖我们新模块所需的最低限度内容。

数据文件(CSV)

Odoo 是一个高度数据驱动的系统。虽然行为可以通过 Python 代码自定义,但模块的一部分价值在于它加载时设置的数据。加载数据的一种方式是使用 CSV 文件。一个例子是 州/省列表,它在安装 base 模块时加载。

"id","country_id:id","name","code"
state_au_1,au,"Australian Capital Territory","ACT"
state_au_2,au,"New South Wales","NSW"
state_au_3,au,"Northern Territory","NT"
state_au_4,au,"Queensland","QLD"
...
  • id 是一个 external identifier。它可用于引用记录(无需知道其在数据库中的标识符)。

  • country_id:id 通过其 external identifier 来引用国家。

  • name 是省份的名称。

  • code 是省份的代码。

这三个字段 定义 于 res.country.state 模型中。

按照惯例,导入数据的文件位于模块的 data 文件夹中。当数据与安全相关时,它位于 security 文件夹中。当数据与视图和动作相关时(我们稍后会介绍),它位于 views 文件夹中。此外,所有这些文件都必须在 __manifest__.py 文件的 data 列表中声明。我们的示例文件 在 base 模块的清单中定义。

另请注意,数据文件的内容仅在模块安装或更新时加载。

Warning

数据文件按照它们在 __manifest__.py 文件中的顺序依次加载。这意味着如果数据 A 引用了数据 B,则必须确保 B 在 A 之前加载。

以国家省份为例,您会注意到 国家列表 的加载 先于 国家省份列表 。这是因为省份引用了国家。

为什么这些对安全很重要?因为模型的所有安全配置都是通过数据文件加载的,我们将在下一节中看到。

访问权限

参考:与此主题相关的文档可在 访问权限 中找到。

Note

目标:在本节结束时,以下警告不应再出现:

WARNING rd-demo odoo.modules.loading: The models ['estate.property'] have no access rules...

当模型上没有定义访问权限时,Odoo 会判定没有任何用户可以访问数据。日志中甚至会对此进行通知:

WARNING rd-demo odoo.modules.loading: The models ['estate.property'] have no access rules in module estate, consider adding some, like:
id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink

访问权限定义为模型 ir.model.access 的记录。每条访问权限与一个模型、一个群组(或无群组即全局访问)以及一组权限相关联:create、read、write 和 unlink2。此类访问权限通常定义在名为 ir.model.access.csv 的 CSV 文件中。

以下是我们之前的 test_model 的示例:

id,name,model_id/id,group_id/id,perm_read,perm_write,perm_create,perm_unlink
access_test_model,access_test_model,model_test_model,base.group_user,1,0,0,0
  • id 是一个 external identifier。

  • name 是 ir.model.access 的名称。

  • model_id/id 指访问权限所应用于的模型。引用模型的标准方式是 model_<model_name>,其中 <model_name> 是模型的 _name,并将其中的 . 替换为 _。看起来很麻烦?确实如此……

  • group_id/id 指访问权限所应用于的群组。

  • perm_read,perm_write,perm_create,perm_unlink:读取、写入、创建和删除(unlink)权限

Exercise

添加访问权限。

在合适的文件夹中创建 ir.model.access.csv 文件,并在 __manifest__.py 文件中定义它。

为群组 base.group_user 授予读取、写入、创建和删除权限。

提示:日志中的警告消息给了您大部分答案 ;-)

重启服务器后,警告消息应该已经消失了!

现在终于到了 与界面交互 的时候了!

1

即指哪些 Odoo 用户(或用户群组)

‘unlink’ 等同于 ‘delete’