跳到主要内容
PDF4me API集成知识库扩展API 测试员博客

添加表单字段 PDF 使用 n8n 行动

PDF4me 添加表单字段 PDF 转换静态 PDF 通过将文档转换为交互式、可填写的表单 n8n 自动化工作流程。流程 PDF离开 n8n 触发器、二进制数据、base64 字符串或公共 URL此功能可添加表单字段（文本框、复选框），并支持自定义字段位置、字段名称、默认值、大小控制、页面特定定位和灵活的对齐方式。此解决方案非常适合创建表单模板、生成交互式文档、数据收集表单、创建调查问卷以及需要专业表单字段创建、精确定位和无缝集成的自动化表单设计工作流程。

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

设置​

添加 PDF4me “向表单添加字段” PDF节点到您的 n8n 工作流程并配置所需参数。有关初始设置说明，请参阅我们的 n8n 集成指南。

先决条件：

  • PDF4me API 证书
  • n8n 工作流访问
Get Your API Key

配置：

  1. 添加 PDF4me 节点到工作流
  2. 选择“添加表单字段” PDF“ 行动
  3. 配置输入参数（见下文）
将表单字段添加到 PDF 配置

参数​

“添加表单字段”功能的完整参数列表 PDF 操作。配置这些参数以控制表单字段的添加。

重要的： 标有星号 (***) 的参数是必需的，必须提供这些参数才能使操作正常运行。

范围类型描述例子
输入数据类型***StringPDF 输入格式选择
• 选择您的格式 PDF 文档输入
• PDF4me 支持多种输入类型
• 选项：二进制数据， Base64 字符串，或 URL		Binary Data
输入二进制字段二进制二进制 PDF 文件输入 （二进制数据必填）
• 参考 PDF 来自前一个文件 n8n 节点或文件上传
• 适用于任何 PDF 添加表单字段的文档
• 当输入数据类型为“二进制数据”时为必填项		{{ $binary.data }}
Base64 PDF 内容StringBase64 编码 PDF 输入 （如果适用，则为必填项） Base64 细绳）
• 提供 PDF 内容以 base64 编码字符串的形式呈现
• 支持多种 PDF 表单增强格式
• 当输入数据类型为“Base64 细绳”		JVBERi...
PDF URLString民众 PDF URL 输入 （如果适用，则为必填项） URL）
• 提供公开/开放权限 URL 到 PDF 文件
• 下载并处理文档以添加表单字段
• 当输入数据类型为“URL“		https://abc.com/doc.pdf
初始值***String表单字段默认值
• 设置表单字段的初始或默认文本值
• 当文本出现在字段中时 PDF 已打开
• 为用户提供指导或预填信息		input text
位置 X***数字水平场位置
• 定义表单字段的水平位置（X 坐标）
• 支持对齐设置（左对齐、右对齐、居中对齐）
• 默认值为 0		300
位置 Y***数字垂直场位置
• 定义表单字段的垂直位置（Y 坐标）
• 支持对齐设置（顶部、底部、中间）
• 默认值为 0		300
字段名称***String表单字段标识符
• 为表单字段指定一个唯一的名称
• 用于识别表单数据提取和处理中的字段
• 使用描述性名称以更好地管理表单		Input Field Name
尺寸***数字表单字段大小
• 定义表单字段的大小或字体大小
• 控制表单字段的外观和可用性
• 默认值为 0		4
页数***String目标页面规格
• 将页码索引指定为逗号分隔值或范围
• 例如：“0,1,2-”或“1,2,3-7”
• 如果未指定，则默认处理所有页面		1
表单字段类型***String字段类型选择
• 选择要添加的表单字段类型
• 选项：文本框（文本输入框）、复选框（复选框字段）
不同类型的产品提供不同的功能		TextBox
输出文件名***String输出文件名
• 指定生成的文件的名称 PDF 包含表单字段的文件
• 必须包含 .pdf 扩展名
• PDF4me 确保唯一命名和格式验证		form_fields_output.pdf
输出二进制字段名称***String二进制数据映射
• 定义用于访问生成的数据的变量名 PDF 二进制数据
• 用于后续工作流程操作
• 对工作流程数据流至关重要		data
异步Boolean异步处理
• 启用或禁用异步处理
• 启用此功能后，操作将在后台运行，以获得更佳性能
• 推荐用于企业工作流程和高容量处理		true

输出​

输出参数​

范围类型描述例子
文件名StringPDF4me 生成的文件名 - 成功处理的文件的完整文件名 PDF 包含具有正确扩展名的表单字段的文档。 PDF4me 确保唯一命名并验证文件格式合规性，以便与下游流程无缝集成。form_fields_output.pdf
mimeTypeStringPDF4me MIME 类型标识符 - 标准化 MIME 生成的类型 PDF 文件，始终设置为 application/pdf 经过 PDF4me的处理引擎。这确保了所有系统和应用程序都能正确处理和识别文件。application/pdf
文件大小数字PDF4me 文件大小（字节） 生成的确切大小 PDF 文件大小以字节为单位，用于存储规划、带宽优化和文件传输监控。对企业文档管理和工作流自动化至关重要。121883
成功BooleanPDF4me 表单字段添加状态指示器 - 指示表单字段添加过程成功或失败的布尔标志。返回 true 为了成功运营和 false 针对任何错误，在自动化工作流程中实现强大的错误处理能力。true
信息StringPDF4me 表单字段添加状态消息 - 描述表单字段添加过程的结果消息。为成功操作提供清晰的状态消息，并为故障排除提供详细的错误信息。Form fields added to PDF successfully
字段名StringPDF4me 表单字段标识符 - 添加到表单中的字段名称 PDF 文档。此标识符与字段创建期间使用的字段名称参数相匹配，对于表单数据提取和字段管理至关重要。Test Box
表单字段类型StringPDF4me 字段类型确认 - 成功添加到表单中的字段类型 PDF 文档。确认操作过程中创建的字段类型（文本框、复选框、单选按钮、组合框）。TextBox
初始值StringPDF4me 字段默认值 - 表单字段的初始或默认文本值。此值会在表单字段中显示。 PDF 打开后，会为用户提供指导或预填信息。input
位置ObjectPDF4me 场位置坐标 - 表单字段在页面上的确切位置，包含从页面边缘测量的 X 和 Y 坐标（以点为单位）。{"x": 200, "y": 200}
尺寸数字PDF4me 场地大小确认 - 应用于表单字段的大小或字体大小。这确认了在创建字段期间配置的字段尺寸和外观设置。3
页面StringPDF4me 目标页面确认 - 表单字段成功添加后的页码。确认字段在文档中的具体位置。"1"

N8N 行动反应​

这 PDF4me 添加表单字段 PDF API 返回的结果可以以多种格式查看。请选择最符合您需求的视图：

JSON 回复格式

原始 JSON 来自 API：

[
  {
    "success": true,
    "message": "Form fields added to PDF successfully",
    "fileName": "form_fields_output.pdf",
    "mimeType": "application/pdf",
    "fileSize": 121883,
    "fieldName": "Test Box",
    "formFieldType": "TextBox",
    "initialValue": "input ",
    "position": {
      "x": 200,
      "y": 200
    },
    "size": 3,
    "pages": "1"
  }
]

用例​

数字表单创建和转换**​

  • 将纸质表格转换为交互式数字表格 PDF 包含可填写字段的表单
  • 向现有文档添加表单字段，用于数据收集和用户输入
  • 创建用于调查、申请和反馈收集的自定义表单模板

文档增强和交互性​

  • 通过添加交互元素增强静态文档，以提高用户参与度。
  • 在现有系统中增加数据收集功能 PDF 文件和报告
  • 将文档转换为可填写表单，以便进行自动化数据处理。

工作流程自动化和数据收集​

  • 自动创建表单，实现标准化数据收集流程
  • 将表单字段添加功能集成到文档处理工作流程中
  • 为各种业务流程和应用程序创建动态表单

获取帮助​

n8n Integration Guiden8n SampleGetting Started