如何为 Odoo 新建 ONLYOFFICE 表单模板：详细指南

2024年08月05日作者: Mona

通过新发布的 ONLYOFFICE 模板应用，您可以使用 Odoo 中的数据和字段自动创建表单。尽管有现成的模板，例如发票和销售单据模板，但从头开始创建新模板可能具有挑战性，尤其是对于新用户而言。在本指南中，您将学习如何为各种 Odoo 模块创建新的 ONLYOFFICE 模板。

开始前的准备

要开始创建表单，您需要安装一个正在运行的 Odoo 实例、一个 ONLYOFFICE 文档实例和 ONLYOFFICE 模板应用。本文详细介绍了此集成，并解释了如何使用。

如果您已将 ONLYOFFICE 模板与 Odoo 平台集成，那么就可以创建新的表单模板、编辑现有模板，并根据 Odoo 中的数据和字段打印已完成的表单模板。

让我们了解如何为 Odoo 的一个模块创建新的表单模板。例如，人力资源部门的辞职信模板。

第1步：切换到开发者模式

建议在 Odoo 中启用开发人员模式，然后创建新的表单模板。为此，请单击 Home 菜单中的 Settings 图标，在 General Settings 中找到 Developer tools，然后单击 Activate the developer mode，然后会自动返回至 Home 菜单。

第2步：新建 ONLYOFFICE 模板

下一步，在 Templates 模块中创建一个新的 ONLYOFFICE 模板。从 Home 菜单启动ONLYOFFICE Templates 应用程序，然后单击模块左上角的 New 按钮。

单击 New 按钮，便可通过该应用从头开始创建新模板。或者，您可以使用 Upload your file 按钮从本地驱动器上传文件。新创建的表单模板将显示在模块中。

在创建新模板时，选择所需的 Odoo 模型至关重要。你的选择取决于你要创建什么。如果选择了错误的模型，则模板将无法按预期工作。

要确定您需要选择的模型名称，您可以在 Odoo 中查看相应记录的 URL 地址。为此，请转到所需的 Odoo 模块，打开任何带有 Print with ONLYOFFICE 按钮的记录，然后查看 URL 地址以找到提示。

在我们的例子中，我们想创建一个辞职信模板。这就是为什么我们转到 Employees 模块，选择一个可用记录并查看其 URL 地址。必需的值为 hr.employee

现在复制此值并返回到模板创建窗口。在 Select Model 字段中输入复制的值，然后单击 Enter。 hr.employee 值对应于 Employee 模型，因此将自动为我们的新模板选择此模型。不要忘记输入模板名称，然后从头开始创建新模板或使用可用选项之一从您的设备上传新文件。您的模板将显示在 Templates 模块中。

第 3 步：编辑新的 ONLYOFFICE 模板

现在，您的模板已创建完毕，请从 Templates 模块中打开它，并使用 ONLYOFFICE 编辑器的功能编辑其内容。您可以输入文本、添加页眉和页脚、插入对象以及使用各种格式设置工具。

当 PDF 模板的最终版本准备就绪时，您可以继续下一步，并根据 Odoo 数据插入可填写的字段。

第 4 步：使用 ONLYOFFICE 模板应用插入可填写字段

现在，您需要在模板中插入可填写字段，以便 ONLYOFFICE 应用在打印模板时可以使用 Odoo 数据。这个过程乍一看可能看起来很复杂，但不要担心。当你理解了主要原理时，这将是小菜一碟。

使用 ONLYOFFICE 应用，您可以根据某些 Odoo 参数自动添加必填字段。由于开发者模式已开启，每个 Odoo 模块中的所有字段都将有一个问号，以帮助您找到所需的参数。具体而言，您需要来自 Field 和 Model 参数的信息。

在我们的模板中，将包含有关员工的信息。这就是为什么您需要转到 Employees 模块并打开其中一条记录。模板中的第一个字段可以是 Manager ，它将在两周的通知中显示员工的经理姓名。因此，将鼠标光标指向 Manager 旁边的问号，您将看到一些参数。

您需要的是：

Field： parent_id
Model： hr.employee

您需要了解这些参数才能在模板中插入正确的字段。返回到您的模板，然后单击要添加第一个字段的位置。在左侧面板上，插入 parent_id 并在列表中找到它。它属于 Employee 模块，该部分有很多可用字段。

现在在 Employee 模分中找到 Manager 。这是必填字段。当您单击它时，该字段将自动添加到您的模板中，并使用特定的 Odoo 键。

现在，您刚刚插入了第一个字段。使用相同的算法，根据需要添加任意数量的字段。

现在，当您在单击 Action 菜单中的 Print with ONLYOFFICE 按钮后选择此模板时，可以使用 Odoo 数据完成它。

提示：如何在 ONLYOFFICE 应用中查找 Odoo 字段

根据以下提示，会更容易找到所需的 Odoo 字段：

提示 1. 当您打算在 ONLYOFFICE 编辑器中添加 Odoo 字段时，您首先需要知道其类型。在开发者模式下，您可以在 Model 参数下查看类型。

提示 2. 如果字段的类型是 one2many / many2many / many2many /many2one ，则表示此字段中的值是具有自己的字段的单独实体。此类字段将作为单独的部分显示在 ONLYOFFICE 编辑器的左侧面板上。当您打开此部分时，此实体的所有相关字段也将显示出来。

例如，假设您需要将员工的地址添加到模板中。使用开发者模式，您会发现此字段的名称是 address_id，其类型是 many2one。这是一个独立的实体，具有自己的属性（字段），您也可以在 ONLYOFFICE 编辑器中查看和找到这些属性。

单击 Internal link 按钮（箭头），访问 Odoo 中的所有相关字段。

在此 Address 记录中，您可以查看地址实体的字段，然后在 ONLYOFFICE 编辑器中使用其名称找到它们。例如，让我们找到并插入 Tax ID 字段。它的名字是 vat，属于 address_id 板块。在 ONLYOFFICE 编辑器的左侧面板上，找到 address_id 板块，打开此部分并找到名为 vat 的字段。

使用相同的算法，您可以轻松找到并添加具有one2many / many2many / many2many / many2one 类型的 Odoo 字段。

提示 3. 如果字段的 Model 值指定的模型不是来自 URL 地址的模型，则需要查找一个子板块。在这种情况下，该部分中的键将与模型同名。

如何在 ONLYOFFICE 模板中创建表单

ONLYOFFICE 应用程序有一个实用的功能，可以更轻松地处理表单。如果您想创建一个包含表单的模板（例如，带有待售商品列表的发票），则不必为所有行插入字段。您只需在 ONLYOFFICE 编辑器中创建一个表单，并使用其 ID 插入与主要 Odoo 字段对应的字段，例如描述、数量、单价、税费、金额等。