PDF形式
このガイドの内容
このガイドでは、 PDF AcroFormテンプレート で n8n 使用 テンプレート.pdf そして formdata.jsonデータキーマップ フォームフィールド名に直接 （ファーストネーム、 苗字など)。出力は PDF のみ。 使用 保つ PDF 編集可能 入力後にフィールドを編集可能にするか、オフにしてフォームをフラット化するかを選択できます。
始める前に
テンプレート.pdf これは、4つの入力項目がある会員登録フォームです。 JSON キーは一致する必要があります 内部AcroForm名画面に表示されるラベルではなく、名前自体です。名前は大文字と小文字を区別します。formdata.json （推奨）、 test.xml、 または テスト.csv3つとも同じ4つの値を提供します。PDFフォームデータは 単一の平面オブジェクト入れ子になっていない HTML 請求書のサンプル。:::注：PDFフォームとPDFフォームへの入力の違い ドキュメント生成（単一） と PDF形式 テンプレート生成エンジンを使用する PDF テンプレートとしてフォームを使用します。既存のフォームに記入するには PDF 生成ワークフローのないAcroFormについては、以下を参照してください。 記入する PDF 形状未知のフィールド名を見つける PDF、 走る フォームデータを抽出する PDFまずはテンプレートから始めましょう。 :::
サンプルファイルパック
以下の4つのファイルをすべてダウンロードしてください。 PDF フォームテンプレートと、それに対応する3つのデータ形式。
サンプルファイルの内容
フォームフィールド template.pdf
サンプルPDFはシンプルなものです 会員登録／入会申込書各AcroFormフィールド名は、データ内のキーに対応しています。
| AcroFormフィールド名 | テンプレートでの典型的な使用例 | サンプル値（formdata.json） |
|---|---|---|
firstname | 名 | ジョン |
lastname | 苗字 | アダムス |
gender | 性別選択 | 女性 |
member | 会員ランク | 基本 |
:::ヒント フィールド名と表示ラベル
AcroForm の名前は多くの場合、スペースなしの小文字です (firstname)、 PDF 「名」が表示されます。値が空白の場合は、 JSON ほとんどの場合、内部フィールド名とは一致しません。 フォームデータを抽出する PDF独自のテンプレートから正確な名前をリストアップします。
:::
すべてのデータファイルにわたるフィールドマッピング
| AcroForm field | JSON key (formdata.json) | XML element (test.xml) | CSV column (test.csv) | Sample value |
|---|---|---|---|---|
firstname | firstname | firstname | firstname | John |
lastname | lastname | lastname | lastname | Adams |
gender | gender | gender | gender | Female |
member | member | member | member | Basic |
Wordや HTML テンプレートには 口ひげのプレースホルダーはありませんエンジンが一致します AcroFormフィールド名へのデータキー 1対1。
ワークフローの概要
Manual Trigger → Read Binary File (template.pdf) → PDF4me Generate Document (Single) → (optional) Write Binary File
| ステップ | n8n ノード | 目的 |
|---|---|---|
| 1 | 手動トリガー | ワークフローをオンデマンドで開始 |
| 2 | バイナリファイルを読み込む | 大量 template.pdf バイナリプロパティへ data |
| 3 | PDF4me → ドキュメント生成（単一） | AcroFormのフィールドに入力する JSON/XML/CSV出力 PDF |
| 4 | バイナリファイルを書き込む または メールを送信する （任意） | 保存または送信 generated_document_output.pdf |
/generate-document-single-template-file-type.png "クリックして拡大")
セット テンプレートファイルの種類 に PDF形式。 出力タイプ は PDF このテンプレートタイプのみに適用されます。
ステップ1：サンプルファイルをダウンロードして配置する
- ダウンロード
template.pdfそしてformdata.jsonから サンプルファイルパック その上。 - 保存
template.pdfどこかで n8n （自己ホスト型の場合はローカルパス、本番環境のトリガーの場合はクラウドストレージ）を読み取ることができます。 - オプションでダウンロード
test.xmlまたはtest.csv他のデータ型をテストするため。
ステップ2： n8n ワークフロー
- で n8n新しいワークフローを作成します。
- 追加する 手動トリガー ノード。
- 追加する バイナリファイルを読み込む トリガーの後のノード。
- 追加 PDF4me → ドキュメント生成（単一） バイナリファイルを読み込んだ後。
- 接続 PDF4me 資格情報。
:::注意：ここではHTMLコードは無効です テンプレートファイル入力タイプ: HTML コード のみ機能します テンプレートファイルの種類 は HTMLPDF形式の場合は、 バイナリデータ、 Base64 弦、 または URL。 :::
ステップ 3: PDF テンプレートを読み込む (Read Binary File）
| 分野 | 価値 |
|---|---|
| ファイルパス | ダウンロードしたファイルのフルパス template.pdf |
| 物件名 | data （デフォルト; として使用される） テンプレートバイナリプロパティ で PDF4me） |
このノードを一度実行し、出力項目がバイナリであることを確認してください。 data ファイル名付き template.pdf。
ステップ4：設定 PDF4me ドキュメント生成（単一）
コア設定
| 分野 | 価値 | 注記 |
|---|---|---|
| 接続するための認証情報 | あなたの PDF4me 資格情報 | 得る API 鍵 |
| リソース | Generate | |
| 操作の生成 | ドキュメント生成（単一） | |
| テンプレートファイルの種類 | PDF形式 | PDF AcroFormフィールドを使用 |
| 出力タイプ | 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
- クリック ワークフローを実行する。
- 開く PDF4me ノード出力。 バイナリオープンな物件
data（generated_document_output.pdf) - 4つの項目すべてが入力されていることを確認してください。
- ファーストネーム → ジョン
- 苗字 → アダムス
- 性別 → 女性
- メンバー → 基本
いずれかのフィールドが空の場合は、 JSON AcroForm 名を持つキー template.pdf キャラクターごとに。
ステップ6：出力を保存または送信する（オプション）
バイナリファイルを書き込む:
| 分野 | 価値 |
|---|---|
| ファイル名 | filled-form-output.pdf |
| データプロパティ名 | data |
| 出力パス | ターゲットフォルダ n8n ホスト |
メール送信： バイナリを添付する data から PDF4me として PDF 添付ファイル。
代替データ形式
選択肢A： JSON バイナリファイルとして(formdata.json）
- 追加 バイナリファイルを読み込む のために
formdata.json（ マージ テンプレートとデータがワークフロー項目を共有する場合、ノードが機能します。 - セット ドキュメントデータ入力タイプ に バイナリデータ、 文書データタイプ に JSON、 文書バイナリプロパティ データフィールドに、 ドキュメントデータファイル名 に
formdata.json。
:::注意 バイナリプロパティ名の衝突
テンプレートとデータの両方でプロパティが使用されている場合 data、一方が他方を上書きします。別々の名前を使用してください (例: template そして formData）または、2 つの Read Binary File ノードからの項目をマージします。
:::
選択肢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 そして貼り付けます（ヘッダー行＋データ行1行）：
firstname,lastname,gender,member
"John","Adams","Female","Basic"
列ヘッダーはAcroFormのフィールド名と直接一致します。
代替テンプレート入力: URL
ホスト template.pdf 公の場で HTTPS URLそして、以下を設定します。
| 分野 | 価値 |
|---|---|
| テンプレートファイル入力タイプ | URL |
| テンプレートファイルのURL | 公開リンク template.pdf |
| テンプレートファイル名 | template.pdf |
Read Binary Fileノードは不要です。データは引き続き貼り付けることができます。 文書データテキスト またはロードされた URL。
生産ワークフローパターン
実務でPDFフォームに記入する一般的な方法Once the sample test works, replace the Manual Trigger with these patterns.
- Webhookは登録ペイロードを受信します。
- ボディフィールドをマッピング JSON AcroForm名と一致するキー。
- PDF4me 塗りつぶし固定
テンプレート.pdfバイナリまたは URL。 - 記入済みのメールまたは保存 PDF。
- 新しい行が出現すると、シートがトリガーされます。
- セット または コード ノードビルド
{"ファーストネーム"： "..."、 ...}。 - PDF4me PDFフォームテンプレートを使用してドキュメント（1つ）を生成します。
- 出力をドライブにアップロードするか、 SharePoint。
- HubSpot / Salesforce の新規コンタクト発生時のトリガー。
- 地図 CRM 不動産
ファーストネーム、苗字など - セット 保つ PDF 編集可能 アーカイブする前に、データを平坦化します。
よくある質問
関連ガイド
- ドキュメント生成（単一）概要: すべてのパラメーター、出力フィールド、およびテンプレートタイプ
- 記入する PDF 形状テンプレート生成エンジンを使用しない専用の AcroForm 入力
- フォームデータを抽出する PDF:任意のフィールド名を一覧表示します PDF 形状