跳到主要内容
PDF4me API集成知识库扩展API 测试员博客
生成文档（单个）

返回主指南：所有模板类型、节点参数和输出字段

PDF表格

本指南涵盖的内容

本指南将引导您完成填写过程。 PDF AcroForm模板 在 n8n 使用 模板.pdf 和 formdata.json数据键映射 直接填写表单字段名称 （名， 姓等等）。输出结果为 PDF 仅有的。 使用 保持 PDF 可编辑 填写后保留字段可编辑状态，或者关闭此功能以扁平化表单。

相关博客文章
目前尚无关于此功能的博客文章——敬请期待。
在此期间，您可以浏览 PDF4me 博客，查看适用于各平台的教程和工作流程。
访问博客 →

开始之前​

PDF 使用 AcroForm 字段
样本 模板.pdf 这是一个包含四个字段的会员表单。 JSON 密钥必须匹配 内部 AcroForm 名称并非屏幕上显示的标签。名称区分大小写。
平面数据对象
使用 formdata.json （受到推崇的）， 测试.xml， 或者 测试.csv这三者都提供相同的四个值。PDF 表单数据是 单个扁平物体不像……那样嵌套 HTML 发票样本。
PDF4me 证书 n8n
创建一个 PDF4me 证书 n8n 并粘贴你的 API 密钥。同一个密钥适用于所有设备。 PDF4me 您实例中的节点。

:::注意：PDF 表单与填写 PDF 表单的区别 生成文档（单个） 和 PDF表格 使用生成模板引擎 PDF 以表格为模板。用于填写任何现有表格 PDF 没有生成工作流程的 AcroForm，请参见 填写 PDF 形式要查找未知数据库中的字段名称 PDF， 跑步 从表单中提取数据 PDF 首先在模板上操作。

:::

示例文件包​

请下载以下全部四个文件。 PDF 表单模板及三种等效数据格式。

示例文件包含哪些内容​

表单字段 template.pdf​

示例 PDF 很简单 会员/注册表格每个 AcroForm 字段名称都对应数据中的一个键：

AcroForm 字段名称模板中的典型用法样本值（formdata.json）
firstname给定的名称约翰
lastname姓亚当斯
gender性别选择女性
member会员级别基本的

:::提示：字段名称与可见标签

AcroForm 名称通常为小写，且不带空格（firstname），即使当 PDF 显示“名字”。如果值为空，则表示您的键为空。 JSON 几乎总是与内部字段名称不匹配。使用 从表单中提取数据 PDF 使用您自己的模板列出确切名称。

:::

所有数据文件中的字段映射​

AcroForm fieldJSON key (formdata.json)XML element (test.xml)CSV column (test.csv)Sample value
firstnamefirstnamefirstnamefirstnameJohn
lastnamelastnamelastnamelastnameAdams
gendergendergendergenderFemale
membermembermembermemberBasic

与 Word 或 HTML 模板，有 没有胡子占位符引擎匹配 AcroForm 字段名称的数据键 一对一。

工作流程概览​

Manual Trigger  →  Read Binary File (template.pdf)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File
步n8n 节点目的
1手动扳机按需启动工作流程
2读取二进制文件负载 template.pdf 进入二元属性 data
3PDF4me → 生成文档（单个）从 AcroForm 填充字段 JSON/XML/CSV输出 PDF
4写入二进制文件 或者 发送电子邮件 （选修的）保存或发送 generated_document_output.pdf
n8n PDF4me“生成文档（单个）”节点中的“模板文件类型”下拉菜单显示，除了 Word、HTML、邮件合并和 Google Docs 选项外，还有 PDF 表单选项。

放 模板文件类型 到 PDF表格。 输出类型 是 PDF 仅适用于此模板类型。

步骤 1：下载并放置示例文件​

  1. 下载 template.pdf 和 formdata.json 从 示例文件包 多于。
  2. 节省 template.pdf 某个地方 n8n 可以读取它（自托管的本地路径，或生产触发器的云存储）。
  3. （可选）下载 test.xml 或者 test.csv 测试其他数据类型。

步骤 2：创建 n8n 工作流程​

  1. 在 n8n创建一个新的工作流程。
  2. 添加一个 手动扳机 节点。
  3. 添加一个 读取二进制文件 触发器之后的节点。
  4. 添加 PDF4me → 生成文档（单个） 读取二进制文件之后。
  5. 连接您的 PDF4me 凭证。

注意：此处的 HTML 代码无效 模板文件输入类型： HTML 代码 仅在以下情况下有效 模板文件类型 是 HTML对于 PDF 表单，请使用 二进制数据， Base64 细绳， 或者 URL.

:::

步骤 3：加载 PDF 模板（Read Binary File）​

场地价值
文件路径下载文件的完整路径 template.pdf
物业名称data （默认值；用作 模板二进制属性 在 PDF4me）

执行此节点一次，并确认输出项显示为二进制。 data 文件名 template.pdf。

步骤 4：配置 PDF4me 生成文档（单个）​

核心设置​

场地价值笔记
用于连接的凭证你的 PDF4me 凭证得到 API 钥匙
资源Generate
生成操作生成文档（单个）
模板文件类型PDF表格PDF 使用 AcroForm 字段
输出类型PDF仅提供 PDF 格式

模板输入（来自读取二进制文件）​

场地价值
模板文件输入类型二进制数据
模板二进制属性data
模板文件名template.pdf

文档数据（粘贴 JSON 数据） formdata.json）​

场地价值
文档数据输入类型文本
文档数据类型JSON
文档数据文本粘贴全部内容 formdata.json （见下方方框）
{
  "firstname": "John",
  "lastname": "Adams",
  "gender": "Female",
  "member": "Basic"
}

输出选项​

场地价值何时使用
保持 PDF 可编辑在收件人仍应编辑已填写的字段。 PDF
保持 PDF 可编辑离开 （默认）将表单字段扁平化为静态内容
二进制数据输出名称data （默认）输出的二进制属性 PDF

步骤 5：执行并验证 PDF​

  1. 点击 执行工作流程。
  2. 打开 PDF4me 节点输出。 二进制开放属性 data （generated_document_output.pdf）。
  3. 请确认所有四个字段均已填写：
    • 名 → 约翰
    • 姓 → 亚当斯
    • 性别 → 女性
    • 成员 → 基本

如果任何字段为空，请比较您的 JSON 带有 AcroForm 名称的键 template.pdf 逐个角色进行。

步骤 6：保存或发送输出（可选）​

写入二进制文件：

场地价值
文件名filled-form-output.pdf
数据属性名称data
输出路径在您的目标文件夹中 n8n 主持人

发送电子邮件： 附加二进制文件 data 从 PDF4me 作为 PDF 依恋。

替代数据格式​

选项A： JSON 文件为二进制文件（formdata.json）​

  1. 添加 读取二进制文件 为了 formdata.json （使用 合并 如果模板和数据共享工作流项，则为节点）。
  2. 放 文档数据输入类型 到 二进制数据， 文档数据类型 到 JSON， 文档二进制属性 添加到您的数据字段中， 文档数据文件名 到 formdata.json。

:::注意：二进制属性名称冲突

如果模板和数据都使用属性 data一个会覆盖另一个。请使用不同的名称（例如： template 和 formData或者合并来自两个“读取二进制文件”节点的条目。

:::

选项B： XML （test.xml）​

放 文档数据类型 到 XML 并粘贴：

<?xml version="1.0" encoding="UTF-8"?>
<Person>
    <firstname>John</firstname>
    <lastname>Adams</lastname>
    <gender>Female</gender>
    <member>Basic</member>
</Person>

元素名称与 AcroForm 字段名称匹配， JSON 钥匙。

选项C： CSV （test.csv）​

放 文档数据类型 到 CSV 并粘贴（标题行 + 一行数据）：

firstname,lastname,gender,member
"John","Adams","Female","Basic"

列标题与 AcroForm 字段名称直接匹配。

备选模板输入： URL​

主持人 template.pdf 在公共场合 HTTPS URL然后设置：

场地价值
模板文件输入类型URL
模板文件 URL公开链接 template.pdf
模板文件名template.pdf

不需要“读取二进制文件”节点。数据仍然可以粘贴为 文档数据文本 或从 URL。

生产工作流程模式​

生产环境中填写 PDF 表单的常用方法Once the sample test works, replace the Manual Trigger with these patterns.
Webhook 表单提交
  1. Webhook 接收注册有效载荷。
  2. 将主体字段映射到 JSON 键与 AcroForm 名称匹配。
  3. PDF4me 填充固定 模板.pdf 来自二进制或 URL。
  4. 通过电子邮件发送或存储填写完毕的信息。 PDF。
Google Sheets 行 PDF
  1. 工作表在新行出现时触发。
  2. 放 或者 代码 节点构建 {“名”： ”...”， ...}。
  3. PDF4me 使用 PDF 表单模板生成文档（单个）。
  4. 上传输出到云端硬盘或 SharePoint。
CRM 联系会员 PDF
  1. HubSpot/Salesforce 在新联系人出现时触发。
  2. 地图 CRM 属性 名， 姓， ETC。
  3. 放 保持 PDF 可编辑 先压平再归档。

常见问题解答​

How is Pdf Form different from Fill a PDF Form?+
Generate Document (Single) with Pdf Form is part of the generate template workflow (same node as Word and HTML). Fill a PDF Form is a dedicated Forms operation for any PDF with AcroForm fields. Both map keys to field names; choose Generate when Pdf Form is your Template File Type in a generate pipeline.
Why are some fields blank in the output?+
JSON keys must match AcroForm field names exactly, including case. firstname works; FirstName or first_name usually does not. Run Extract Form Data From PDF on template.pdf to list internal names before mapping CRM or webhook data.
Should I turn Keep PDF Editable on or off?+
On: fields remain editable (useful for review workflows). Off: fields are flattened into static text (better for final archival or when recipients should not change values). Default is Off.
Can Pdf Form output Word or HTML?+
No. When Template File Type is Pdf Form, Output Type is PDF only.
JSON vs XML vs CSV: which should I use?+
JSON is simplest for n8n expressions and webhooks. XML and CSV in the sample pack use the same four keys. All formats map one value per AcroForm field name.

相关指南​

Back to overviewFill a PDF Form