插入并链接 Odoo 数据

可将 Odoo 数据库中的多个元素插入 Odoo 电子表格，即：

• 列表，即来自 列表视图 的数据

• 数据透视表，即来自 枢轴视图 的数据

• 图表，即来自 图形视图 的数据

Each time a list, pivot table, or chart is inserted, a data source is created. This data source connects the spreadsheet to your Odoo database, retrieving up-to-date information every time the spreadsheet is opened, the browser page is reloaded, or data is manually refreshed by clicking Data ‣ Refresh all data from the menu bar.

插入列表 和 插入数据透视表 使用带有 Odoo 特定的 列表功能 和 数据透视表功能 的公式从数据库检索数据，并可在电子表格中进一步操作。可以修改 插入图表 的某些元素，但不能进行数据操作或计算。

注解

来自不同应用程序和模型的列表、透视表和图表可以插入到同一个电子表格中。

小技巧

如果您打算使用全局筛选器在电子表格或统计面板中动态筛选 Odoo 数据，请不要使用相同的条件在数据库中建立初始列表、数据透视表或图表。

也有可能：

• 添加可点击链接 至 Odoo 菜单项、同一电子表格的其他工作表或外部 URL

• insert financial data from your Odoo database using Odoo-specific spreadsheet functions

• 将数据从另一个 Odoo 电子表格、Excel 电子表格或 Google 电子表格直接粘贴到任何 Odoo 电子表格中

数据源

每次在 Odoo 电子表格中插入 列表, pivot table 或 图表 时，都会创建数据源，连接电子表格和数据库中的相关 模型 ，使电子表格中的数据保持最新。

每个数据源都由可通过 数据 菜单访问的属性定义。数据源由各自的 （数据透视表）、 （列表） 或 （图表） 图标标识，后跟 ID 和名称，例如， (#1)产品销售分析。

点击数据源可在电子表格右侧的窗格中打开相关属性。

小技巧

• 右键点击插入的列表或透视表的任意单元格，然后点击 :icon:`ioi-view-list` 查看列表属性 或 :icon:`ioi-view-pivot` 查看枢轴属性，或点击插入的图表右上方的 (菜单) 图标，然后点击 编辑 也可打开属性窗格。

• 打开特定数据源的属性后，即使在电子表格选项卡之间导航，也会保持打开状态。要关闭属性窗格，请点击窗格右上角的 （关闭） 图标。

注解

删除插入的列表或数据透视表，或删除插入该列表或数据透视表的工作表，不会删除底层数据源。插入列表或数据透视表的数据源只能通过数据源的属性删除。

在 数据 菜单中的警告会指出电子表格中不再出现相应列表或透视表的任何数据源。

另一方面，删除插入的图表也会删除底层数据源。

插入列表

重要

在电子表格中插入列表之前，请确保列表符合您的需求。考虑哪些字段应该可见，以及如何对记录进行筛选和/或排序。这会影响电子表格的加载时间和用户友好性。

插入列表：

1. 在数据库中打开相关列表视图后，点击视图名称旁边的 （操作） 图标，然后点击 电子表格 ‣ 在电子表格中插入列表。

   注解

   要只插入特定记录，请选择相关记录，点击屏幕顶部中央的 操作 按钮，然后点击 :icon:`ioi-view-list`插入电子表格。

2. 在打开的窗口中，根据需要编辑 列表名称。

   列表名称用于工作表名称以及 列表属性 中。

   

3. 如有需要，可编辑要插入的记录数量（即行数）。

   默认情况下，显示的数字是列表第一页可见的记录数量。例如，如果列表包含 150 条记录但只有 80 条可见，则该字段将显示 80。

   注解

   虽然通过与数据库的连接，列表中的数据可以保持更新，但已插入的列表不会自动扩展以容纳新的记录（例如，新的产品类别或新的销售人员）。

   如果预计会添加新记录，请考虑在插入列表时添加额外的行。也可以在插入电子表格后 手动添加记录/行 。

   Example

   您的公司目前有十个产品类别，您将此列表插入到电子表格中。如果创建了第11个产品类别，而您插入的列表只有十行，那么新类别将被插入到电子表格的适当位置，从而移除一个现有类别。

   避免这种情况的一个方法是在插入列表时 添加额外的行。

4. 点击 空白电子表格 或选择应在哪个现有电子表格中插入列表。

   注解

   新的电子表格会保存在 Odoo 文件管理 应用程序中的 我的云盘 个人工作区，或者，如果电子表格已启用 文件集中化 ，则会保存在 电子表格 工作区。

5. 点击 确认。

列表会插入电子表格中的一个新工作表。底栏的工作表选项卡显示列表名称，后跟列表 ID，如 按总数计算的报价（列表 #1）。屏幕右侧的窗格显示 :ref:` 列表属性 <spreadsheet/insert/list-properties>`。

小技巧

• To view an individual record of an inserted list, right-click on any cell of the relevant row, then click See record. To return to the spreadsheet, click the name of the spreadsheet in the breadcrumbs at the top of the view.

• 要切断插入列表与数据库之间的联系，请选择整个列表，点击右键并选择 :guilabel:`复制，然后再次点击右键并选择 选择性粘贴 ‣ 粘贴为值。

• 请勿修改工作表名称中的列表 ID，因为已插入的列表会在电子表格的整个生命周期中保留此 ID。该列表 ID 将用于从数据库中检索数据的 电子表格函数。

列表函数

When a list is inserted into a spreadsheet, the following functions are used to retrieve the header and field values, respectively:

=ODOO.LIST.HEADER(list_id, field_name)
=ODOO.LIST(list_id, index, field_name)

该函数的参数如下：

• list_id：插入列表时分配的 ID。电子表格中插入的第一个列表被分配为列表 ID 1，第二个被分配为列表 ID 2，等等。

• 索引：标识插入前记录在列表中出现的行。第一行的索引为 1，第二行的索引为 2，等等。

• field_name：字段的技术名称。

小技巧

点击单个单元格后，相关公式会显示在公式栏中。要同时显示电子表格中的所有公式，请点击菜单栏上的 视图 ‣ 显示 ‣ 公式。下面的示例显示了用于检索列表标题和数值的函数。

列表属性

插入列表时，列表属性会显示在屏幕右侧。您可以随时通过 数据 菜单访问这些属性，方法是点击相关列表（前缀为 （列表） 图标，或右键点击列表上的任意位置并点击 查看列表属性。

下面显示的是列表属性，其中一些属性可以编辑：

• 列表 #：列表 ID。在电子表格中插入其他列表时，会按顺序分配列表 ID。

• 列表名称：列表名称。如有需要，可对其进行编辑。请注意，编辑列表属性中的列表名称不会修改工作表名称中显示的列表名称，反之亦然。

• 模型：从中提取数据的模型。

• 列：插入列表时可见的模型字段。

• 域：用于确定显示哪些记录的规则。点击 编辑 domain 添加或编辑规则。

  注解

  When global filters are used, this domain is combined with the selected values of the global filter before the data is loaded into the spreadsheet.

• 排序：数据的排序方式（如适用）。要添加排序规则，请点击 添加，选择字段，然后选择排序方式是 升序 还是 降序。点击 （删除） 图标，删除排序规则。

To duplicate or delete a list’s data source, click the (gear) icon, then click Duplicate or Delete as relevant.

管理插入的列表

Once a list from an Odoo database has been inserted into an Odoo spreadsheet, you can:

• add records, i.e., rows

• add fields, i.e., columns

• duplicate the list to create a new, identical data source

• delete the list and its underlying data source

向列表添加记录/行

要向列表添加记录，请使用以下方法之一：

• Select the last row of the table, then hover over the blue square until the plus icon appears. Click and drag down to add the desired number of rows. The cells of the new rows are populated with the appropriate formula to retrieve the list values. If there is corresponding data in your database, the cells are populated.

  

• 将光标定位在工作表的左上角单元格，从菜单栏点击数据 ‣ 重新插入列表，然后选择适当的列表。在弹出窗口中，指示要插入的记录数并点击确认。更新的列表将被插入，覆盖先前的列表。

小技巧

上述方法也可用于向电子表格表格添加额外的空白行。这对于您预期数据库中将生成额外记录的列表很有用，例如新产品类别或新销售人员。

向列表添加字段/列

要向列表添加字段/列：

1. 选择应插入新列的右侧或左侧的列。

2. 从菜单栏点击插入 ‣插入列，然后点击左侧列或右侧列，或右键单击然后根据需要点击在左侧插入列或在右侧插入列。

3. 复制任何列的标题单元格，将其粘贴到新列的标题单元格中，然后按Enter。

4. 双击新的标题单元格，然后点击公式末尾引号中显示的字段名称；相关模型的所有字段技术名称列表将出现。

   

5. 选择适当的字段名称并按Enter。字段的标签将显示在标题中。

   小技巧

   要了解字段的技术名称，请导航到相关视图，激活开发者模式，然后将鼠标悬停在字段标签旁边的问号上以检查字段名称。

6. 选中标题单元格后，双击右下角的蓝色方块。列的单元格将填充适当的公式以检索列表值。如果数据库中有相应的数据，单元格将被填充。

复制列表

通过列表属性复制列表会创建一个额外的数据源。这允许在一个电子表格中对相同的数据执行不同的操作。

With the list properties open, click the (gear) icon then Duplicate.

新数据源将分配下一个可用的列表 ID。例如，如果在此期间没有插入其他列表，则复制*列表 #1* 将创建*列表 #2*。

与插入列表时不同，复制的列表不会自动插入到电子表格中。要插入它，请执行以下步骤：

1. 通过点击电子表格左下角的（添加工作表）图标添加新工作表。

2. 从菜单栏点击数据 ‣ 重新插入列表，然后选择适当的列表。

3. 定义要插入的记录数，然后点击确认。

4. Edit the List Name in the properties pane if needed.

5. 右键点击工作表标签，选择重命名并输入新的工作表名称，以重命名工作表。

注解

通过复制和粘贴插入的列表或复制已插入列表的工作表来复制列表不会创建新的数据源。因此，对列表属性所做的任何更改都会影响列表的任何副本。

删除列表

要彻底删除电子表格中的列表及其底层数据源，请按任意顺序执行以下步骤：

• 使用您偏好的方式（如键盘命令、电子表格菜单或删除工作表）删除表格。这将清除数据的可视化呈现。

• 在相关列表的 属性面板 中，点击 （齿轮） 图标，然后点击 删除。这将从电子表格中删除列表的数据源。

插入数据透视表

小技巧

Converting an inserted pivot table to a dynamic pivot table allows you to add, remove, and manipulate dimensions (i.e., columns and rows) and measures. It is therefore possible to insert a basic pivot table with minimal configuration, convert it to a dynamic pivot table, then refine it directly in the spreadsheet.

插入数据透视表：

1. 在数据库中打开相关透视图后，点击 在电子表格中插入。

2. 在弹出的窗口中，按需编辑 透视表名称。

   该名称用于工作表名称和 数据透视表属性。

   

3. 点击 空白电子表格，或选择目标现有电子表格。

   注解

   新的电子表格会保存在 Odoo 文件管理 应用程序中的 我的云盘 个人工作区，或者，如果电子表格已启用 文件集中化 ，则会保存在 电子表格 工作区。

4. 点击 确认。

数据透视表插入电子表格中的新工作表。据透视表的名称，后跟数据透视表 ID，如 按销售团队进行销售分析（透视 #1）。屏幕右侧的窗格显示：ref:数据透视表属性<spreadsheet/insert/pivot-table-properties>。

小技巧

• To view the records referenced by an individual cell of a pivot table, right-click on the cell, then click See record. To return to the spreadsheet, click the name of the spreadsheet in the breadcrumbs at the top of the view.

• 要切断插入的数据透视表和数据库之间的联系，请选择整个数据透视表，点击右键并选择 :guilabel:`复制，然后再次点击右键并选择 特殊粘贴 ‣ 粘贴为值。

• 请勿修改工作表名称中的数据透视表 ID，因为插入的数据透视表会在电子表格的整个生命周期中保留此 ID。该数据透视表 ID 将用于从数据库检索数据的 电子表格函数 中。

透视表函数

An inserted pivot table that has not been converted to a dynamic pivot table uses the following functions to retrieve the header and field values, respectively:

=PIVOT.HEADER(pivot_id, [domain_field_name, …], [domain_value, …])
=PIVOT.VALUE(pivot_id, measure_name, [domain_field_name, …], [domain_value, …])

函数参数说明如下：

• pivot_id：插入数据透视表时分配的 ID。插入到电子表格中的第一个数据透视表分配数据透视表 ID 1，第二个分配 ID 2，依此类推。

• measure_name：被测量指标的技术名称，后跟聚合类型，例如`product__qty:sum`。

• domain_field_name：用作维度的字段技术名称，例如`user_id`；若维度是时间段，则为日期字段技术名称后跟时间段，例如`date_order:month`。

• domain_value：记录的ID；若维度是时间段，则为目标日期或时间段。

小技巧

点击单个单元格时，公式栏会显示相关公式（如适用）。要同时显示电子表格中的所有公式，请点击菜单栏中的 视图 ‣ :icon:`fa-eye 显示 ‣ 公式。以下示例展示了用于获取静态数据透视表标题和值的函数。

数据透视表属性

插入数据透视表后，数据透视表属性会显示在屏幕右侧。您可以随时通过 数据 菜单访问这些属性，方法是点击相关的数据透视表，前面有 （数据透视表） 图标，或右击数据透视表上的任意位置并点击 查看数据透视表属性。

可查看（部分可编辑）的透视表属性包括：

• 透视表#：数据透视表ID。随着在电子表格中插入更多透视表，ID会按顺序分配。

• 名称：数据透视表名称。可按需编辑。注意：在属性中修改名称不会改变工作表标签显示的名称，反之亦然。

• 模型：从中提取数据的模型。

• 列`和 :guilabel:`行：用于分类或分组模型数据的维度。

• 度量值：基于所选维度进行测量或分析的内容。

  小技巧

  若尝试修改刚插入电子表格的透视表的列、行或度量值，屏幕右上方将显示错误提示。

  

  要操作数据透视表属性，请将静态透视表转换为 动态数据透视表。

• 域：用于确定显示哪些记录的规则。点击 编辑 domain 添加或编辑规则。

  注解

  When global filters are used, this domain is combined with the selected values of the global filter before the data is loaded into the spreadsheet.

要 复制 或 删除 数据透视表的数据源，请点击 (齿轮) 图标，然后点击 复制`或 :icon:`fa-trash删除。

管理插入的数据透视表

将 Odoo 数据库中的数据透视表插入 Odoo 电子表格后，您可以：

• :ref:` 将其转换为动态透视表 <spreadsheet/dynamic-pivot-tables/create>` 以便能够操作尺寸和度量值

• 复制数据透视表 以创建新的相同数据源

• 删除数据透视表及其基础数据源

复制数据透视表

通过数据透视表的属性复制数据透视表，可创建一个额外的数据源。这样就可以在一个电子表格中对相同的数据进行不同的操作。

For example, you can see the same data aggregated by different dimensions or use global filters to offset the date and create pivot tables that compare the current period’s data with a previous period.

要复制数据透视表，请执行以下步骤：

1. 打开 数据透视表属性 时，点击 （齿轮） 图标，然后点击 复制。

   复制的数据透视表会自动插入电子表格中的新工作表，并在右窗格中打开数据透视表属性。

2. 如果需要，在属性窗格和工作表选项卡中编辑 名称 。

新数据源被分配给下一个可用的数据透视表 ID。例如，若期间未插入其他数据透视表，复制*透视表#1*将创建*透视表#2*。

注解

• 通过复制粘贴或复制工作表来复制已插入的数据透视表时，不会创建新的数据源。因此，对数据透视表属性所做的任何修改都会影响其所有副本。

• When a pivot table is duplicated, the new pivot table is by default a dynamic pivot table.

删除数据透视表

要彻底删除电子表格中的数据透视表及其底层数据源，请按任意顺序执行以下步骤：

• 使用您偏好的方式（如键盘命令、电子表格菜单或删除工作表）删除表格。这将清除数据的可视化呈现。

• 在相关数据透视表的 属性面板 中，点击 (齿轮) 图标，然后点击 删除。此操作将移除数据透视表的数据源。

插入图表

将 Odoo 数据库中的图表插入电子表格的操作流程：

1. 在数据库中打开目标图表视图，点击 插入到电子表格。

2. 在弹出的窗口中编辑 :guilabel:`图表名称`（可选）。

3. 点击 空白电子表格 或选择目标现有电子表格。

   注解

   新的电子表格会保存在 Odoo 文件管理 应用程序中的 我的云盘 个人工作区，或者，如果电子表格已启用 文件集中化 ，则会保存在 电子表格 工作区。

4. 点击 确认。

Charts are inserted on the first sheet of the spreadsheet. A pane on the right side of the screen shows the chart properties, where various aspects of the chart’s configuration and design can be modified.

小技巧

点击图表数据点（如 Jessica Childs）可打开数据库中对应的列表视图。

插入可点击链接

添加指向相关或支持信息的链接可以使您的报表或仪表板更加用户友好和高效。

您可以从任何电子表格单元格插入可点击链接到：

• Odoo 菜单项

• 同一电子表格中的另一个工作表

• 外部 URL

注解

• 点击指向菜单项的链接与通过应用中的 Odoo 菜单导航提供相同的结果，例如，菜单项销售/订单/报价单对应于导航到销售 ‣ 订单 ‣ 报价单时的默认视图。

• 也可以从视图本身开始在电子表格中插入指向模型特定视图的可点击链接。但是，由于此方法会在新工作表中插入每个新链接，因此从电子表格开始创建指向特定视图的链接会更高效。

您可以从任何图表插入可点击链接到 Odoo 菜单项。

从单元格插入可点击链接

要从单元格插入可点击链接：

1. 从菜单栏点击插入 ‣链接，或右键单击单元格，然后点击插入链接。接下来，根据所需结果，执行以下操作之一：

   • 点击（菜单）图标，然后点击链接到 Odoo 菜单。从列表中选择相关的菜单项，或点击搜索更多以从所有菜单项列表中选择。点击确认。

   • 点击（菜单）图标，然后点击链接工作表，然后从当前电子表格中选择相关工作表。

   • 在链接下，输入 URL。

2. 在文本字段中输入或编辑链接的标签。

3. 点击 确认。

从图表插入可点击链接

要从图表插入可点击链接到 Odoo 菜单项：

1. 将鼠标悬停在图表框的右上角，然后点击（菜单）图标，然后点击编辑。图表属性将出现在屏幕右侧。

2. At the bottom of the Configuration tab of the chart properties pane, click under Link to Odoo menu, then select a menu.

将鼠标悬停在图表框的右上角，可以看到已添加一个新的（外部链接）图标。

插入财务数据

在构建报表和统计面板时，包含某些会计相关数据可能很有用，例如科目 ID、特定科目的贷方和借方以及税务年度的开始和结束日期。

Odoo 特定的电子表格函数允许您从数据库中检索此类会计数据并将其插入到电子表格中。