分类

PDF表单填写器

通过JSON编程填写PDF表单字段(文本/复选/单选/下拉)并导出PDF

基于 pdf-lib 实现。支持AcroForm;混合XFA可先移除XFA再填充AcroForm字段。

示例结果

2 个示例

基础注册表单填充

向AcroForm注入文本、复选、单选、下拉和列表字段

pdf-acroform-filler-example1.pdf 查看文件
查看输入参数
{ "pdfFile": "/public/samples/pdf/form-sample-acroform.pdf", "fieldDataJson": "{\"full_name\":\"Alex Doe\",\"agree_terms\":true,\"tier\":\"pro\",\"country\":\"US\",\"hobbies\":[\"Reading\",\"Music\"]}", "removeXfaBeforeFill": true, "flatten": true, "strictMode": false }

保留可编辑字段

填充部分字段并关闭扁平化,输出仍可编辑

pdf-acroform-filler-example2.pdf 查看文件
查看输入参数
{ "pdfFile": "/public/samples/pdf/form-sample-acroform.pdf", "fieldDataJson": "{\"full_name\":\"Taylor Smith\",\"agree_terms\":false,\"country\":\"DE\",\"tier\":\"basic\"}", "removeXfaBeforeFill": true, "flatten": false, "strictMode": false }

Click to upload file or drag and drop file here

Maximum file size: 100MB Supported formats: application/pdf

JSON object where key = field name, value = field value

For hybrid PDFs, remove XFA packet and fill AcroForm fallback

Flatten fields to make result non-editable

Fail immediately when any field cannot be mapped/written

关键信息

分类
PDF Tools
输入类型
file, textarea, checkbox
输出类型
file
样本覆盖
4
支持 API
Yes

概览

PDF表单填写器是一款基于 pdf-lib 开发的专业工具,支持通过 JSON 数据批量填充 PDF 表单字段。它能够精准识别并处理 AcroForm 格式,并针对混合 XFA 结构的 PDF 提供移除 XFA 兼容性选项,确保表单数据准确注入,是自动化处理文档填写的理想选择。

适用场景

  • 需要批量处理大量 PDF 表单,手动填写效率低下时。
  • 需要将系统导出的 JSON 数据直接映射到 PDF 模板中时。
  • 处理包含混合 XFA 结构的旧版 PDF 表单,需要将其转换为标准 AcroForm 格式时。

工作原理

  • 上传目标 PDF 表单文件,系统将自动解析其中的表单字段结构。
  • 在 JSON 输入框中定义字段名称与对应的值,支持文本、复选框、单选按钮及下拉菜单。
  • 根据需求选择是否移除 XFA 结构或对结果进行扁平化处理,点击执行即可生成已填写的 PDF。

使用场景

企业自动化生成合同、协议或入职申请表。
批量处理问卷调查或客户信息采集表单。
将数据库导出的业务数据快速填充至标准化的 PDF 报表模板中。

用户案例

1. 批量注册表单自动化

行政专员
背景原因
需要为新入职的 50 名员工填写统一的个人信息登记表,手动填写极易出错。
解决问题
通过 JSON 批量注入姓名、偏好及协议勾选状态,并锁定表单防止篡改。
如何使用
上传 PDF 模板,在 JSON 区域输入员工信息,勾选“扁平化已填写字段”。
示例配置
{"full_name":"张三","agree_terms":true,"tier":"pro","country":"CN","hobbies":["阅读","音乐"]}
效果
生成一份内容已填好且不可编辑的 PDF 文件,直接分发给员工确认。

2. 保留可编辑的草稿生成

财务助理
背景原因
需要预填发票申请单的部分基础信息,但后续还需要财务人员手动补充金额和日期。
解决问题
填充基础信息的同时保留表单的可编辑性,以便后续二次修改。
如何使用
上传 PDF 模板,输入基础字段 JSON,取消勾选“扁平化已填写字段”。
示例配置
{"full_name":"李四","country":"CN","tier":"basic"}
效果
生成一份已预填基础信息但仍保留交互功能的 PDF,方便后续人工补充。

用 Samples 测试

json, pdf, video

相关专题

常见问题

该工具支持哪些类型的 PDF 表单?

主要支持 AcroForm 标准表单。对于混合了 XFA 结构的 PDF,工具提供了移除 XFA 的选项以确保兼容性。

JSON 数据中的 key 应该如何对应?

JSON 的 key 必须与 PDF 表单中定义的原始字段名称(Field Name)完全一致,否则无法正确映射。

什么是“扁平化”处理?

扁平化处理会将填写的表单字段转换为不可编辑的静态内容,防止他人后续随意修改数据。

如果字段名称无法匹配会怎样?

如果开启了“严格模式”,系统会在无法匹配字段时立即报错;若未开启,则会跳过无法识别的字段。

可以处理复选框和下拉菜单吗?

可以,通过 JSON 传入对应的布尔值(true/false)或选项值,即可自动填充复选框和下拉列表。

API 文档

请求端点

POST /zh/api/tools/pdf-acroform-filler

请求参数

参数名 类型 必填 描述
pdfFile file (需要先上传) -
fieldDataJson textarea JSON object where key = field name, value = field value
removeXfaBeforeFill checkbox For hybrid PDFs, remove XFA packet and fill AcroForm fallback
flatten checkbox Flatten fields to make result non-editable
strictMode checkbox Fail immediately when any field cannot be mapped/written

文件类型参数需要先通过 POST /upload/pdf-acroform-filler 上传获取 filePath,然后将 filePath 传递给对应的文件字段。

响应格式

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
文件: 文件

AI MCP 文档

将此工具添加到您的 MCP 服务器配置中:

{
  "mcpServers": {
    "elysiatools-pdf-acroform-filler": {
      "name": "pdf-acroform-filler",
      "description": "通过JSON编程填写PDF表单字段(文本/复选/单选/下拉)并导出PDF",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=pdf-acroform-filler",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

你可以串联多个工具,比如:`https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`,最多20个。

支持 URL 文件链接或 Base64 编码作为文件参数。

如果遇见问题,请联系我们:[email protected]