在 PDF 中配置动态表单字段¶

在创建要导入 Sales 应用的自定义 PDF 时，可使用 动态表单字段 自动将 Odoo 数据库中的相关信息（包括名称和价格）填充到 PDF 内容中。

动态表单字段 是可添加到 PDF 表单中的可配置文本字段，Odoo 会自动用与报价单关联的销售订单/产品中的值填充它们。

格式提示¶

为报价单的页眉或页脚设计基础 PDF 模板时，请留意 动态表单字段 的放置位置。使用以下提示可避免文字重叠和其他格式问题：

Odoo 建议使用 Adobe 软件编辑 PDF 表单。页眉和页脚模板中的表单字段是获取 Odoo 中动态值的必要条件。

小技巧

如果 PDF 过大，无法作为电子邮件附件发送，可尝试使用“系统字体”（例如 Arial、Helvetica、Times New Roman）代替自定义字体以减小文件大小。

重要

Odoo 不允许在 PDF 字段名称中使用空格。只能使用字母、数字、连字符或下划线。

注解

以下软件仅为示例，并非对任何特定软件的认可。

要添加动态表单字段，请使用您偏好的 PDF 编辑器。Adobe Acrobat Pro 是最简单且最常用的软件。一些免费开源 PDF 编辑器的示例如下：

请参阅以下说明：

将 PDF 转换为 PDF 表单，然后在需要插入 Odoo 信息的位置添加一个 动态表单字段。双击该字段打开属性，将 Odoo 字段链接到 动态表单字段。

在常规选项卡中，在名称中为 Odoo 字段输入名称。除非该字段需要保持隐藏，直到填充数据后才显示，否则将通用属性设置为可见。

接下来，点击外观选项卡，选择字体大小、字体和文本颜色，使其与模板现有的文本或品牌风格一致。点击选项选项卡，设置文本对齐方式以符合模板的设计。

用 PDF 编辑器打开 PDF，在需要 Odoo 信息的位置添加一个 动态表单字段。打开该字段的属性窗口，将 Odoo 字段链接到 动态表单字段。然后，在该字段的名称中输入 Odoo 字段的名称。

如果可能，配置字体大小、字体和文本颜色，使其与模板现有的文本或品牌风格一致。点击选项选项卡，设置文本对齐方式以符合模板的设计。

此步骤通过指定信息的确切位置，将 PDF 中的任何 动态表单字段 连接到对应的 Odoo 字段。PDF 文件准备好后，保存更改，并通过销售应用 ‣ 配置 ‣ 页眉/页脚将其上传到 Odoo，然后点击上传。

Odoo 会自动检测上传的 PDF 中的 动态表单字段，并显示配置动态字段链接。点击配置动态字段链接，进入表单字段页面。

表单字段名称列会填充 PDF 中的 动态表单字段。路径列指定每个 动态表单字段 对应的 Odoo 字段的路径。

要编辑，点击所需表单字段所在行的路径单元格，并输入 Odoo 字段名称。常见字段名称请参阅常用动态表单字段部分。如何查找 Odoo 字段名称和路径，请参阅查找 Odoo 字段名称或路径部分。

用户可以在 Odoo 中启用开发者模式（调试模式），并将鼠标悬停在所需字段上查看其技术名称，即弹出窗口中的字段值。或者，在开发者模式下，前往设置 ‣ 技术 ‣ 电子邮件模板菜单。在搜索栏中搜索“Sales”，然后打开一个 销售模板，查看可用的动态表单字段及其路径。

若要提取销售订单或产品中不在常用动态表单字段部分中的特定信息，请向 PDF 添加一个名称唯一的 动态表单字段，然后配置路径，使其指向 Odoo 中的所需信息。

配置路径时，使用点（.）表示法指定模型之间的关系。页眉和页脚从当前的 sale_order 模型开始。产品文档的路径从 sale_order_line 开始。

Example

某公司希望在其报价单中显示客户的国家/地区。为了在报价单 PDF 中显示客户的国家/地区，他们在 PDF 模板中使用了动态表单字段名称 invoice_partner_country。将 PDF 上传到销售应用后，他们将表单字段名称的路径设置为：

对于页眉或页脚文档：partner_invoice_id.country_id.name

报价单中客户国家/地区的 Odoo 表单字段路径示例。¶
对于产品文档：order_id.partner_invoice_id.country_id.name

产品文档中客户国家/地区的 Odoo 表单字段路径示例。¶