创建定制报告

SQL 视图是一种创建自定义报告的技术，用于显示现有模型的字段和视图无法显示的数据。换句话说，该技术有助于避免仅出于数据分析目的而不必要地创建和计算附加字段。

创建模型

SQL 视图的创建方式与标准模型类似：

from odoo import fields, models


class ModuleReport(models.Model):
    _name = 'module.report'
    _description = "Module Report"
    _rec_name = 'module_field'
    _auto = False

其中属性：

  • _auto = False 表示我们不想将模型存储在数据库中

  • _rec_name 指示模型的哪个字段代表记录的名称（即打开记录的表单视图时将在导航面包屑中使用的名称）

其字段的定义方式与标准模型相同，只是每个字段都标记为 readonly=True。

注解

不要忘记将新模型添加到安全文件中。

填充模型

有两种方法可以填充 SQL 视图的表：

  • 重写 BaseModel.init() 方法，

  • 设置 _table_query 属性。

无论使用哪种方式，都将执行 SQL 查询来填充模型。因此，任何 SQL 命令都可用于收集和/或计算所需的数据，并且您应该记住您正在绕过 ORM（即，如果您还没有阅读 Odoo 的安全性 ，最好通读一遍）。从 SELECT 返回的列将填充模型的字段，因此请确保您的列名称与字段名称匹配，或使用匹配的别名。

在大多数情况下，覆盖 BaseModel.init() 方法是标准且更好的选择。它需要导入 tools ，通常编写如下：

def init(self):
    tools.drop_view_if_exists(self.env.cr, self._table)
    self.env.cr.execute("""CREATE or REPLACE VIEW %s as (
                           SELECT
                              %s
                           FROM
                              %s
        )""" % (self._table, self._select(), self._from()))

tools.drop_view_if_exists 确保执行 SQL 查询时不会创建冲突视图。标准做法是将查询的不同部分分开，以便更轻松地扩展模型。查询如何跨方法分割尚未标准化，但至少 _select 和 _from 方法是常见的，当然，所有这些方法都会返回字符串。

其他资料

Example: a SQL view using an override of BaseModel.init()

使用模型

SQL 视图的视图和菜单项的创建和使用方式与任何其他 Odoo 模型相同。您已准备好开始使用 SQL 视图。玩得开心！

额外提示

小技巧

SQL 视图中的一个常见错误是没有考虑由于表 JOIN 导致的某些数据的重复。使用字段的 aggregator 和/或数据透视视图时，这可能会导致计数错误。最好使用足够的数据测试您的 SQL 视图，以确保结果字段值符合您的预期。

小技巧

如果您不想将某个字段用作度量（即在数据透视表或图表视图中），请向其中添加 store=False ，它将不会显示。