メインガイドに戻る：すべてのテンプレートタイプ、ノードパラメータ、および出力フィールド

メールマージ

このガイドの内容

このガイドでは、 定番のWord差し込み印刷テンプレート で n8n 使用 simple_mail_merge_template.docx そして sample_mail_merge_data.jsonテンプレートはWordを使用しています マージフィールド プレースホルダー（非 <<[フィールド]>> または口ひげ {{分野}}) データは JSON 配列 受信者ごとにオブジェクトが1つずつ。ドキュメント生成（単一）の場合は、以下を使用します。 1列配列内。出力は PDF または Word。

始める前に

Wordの差し込み印刷フィールド

サンプル simple_mail_merge_template.docx Wordの差し込み印刷（差し込みフィールドの挿入）で作成されました。フィールド名は ファーストネーム、 苗字、 性別、そして メンバー一致しなければならない JSON まさに鍵です。

JSON 配列データ

使用 sample_mail_merge_data.json （推奨）、 test.xml、または テスト.csvメールマージデータは オブジェクトの配列1つのドキュメントに、単一のオブジェクトを含む配列を貼り付けます。

PDF4me 資格情報 n8n

作成する PDF4me 資格情報 n8n そしてあなたの API キー。同じキーがすべての場所で機能します PDF4me インスタンス内のノード。

→ 手に入れよう API 鍵

:::注：メールマージとPDF4me Wordテンプレートの比較 メールマージ これは、従来の差し込み印刷フィールド（MERGEFIELD）を使用して作成された Word 文書用です。 PDF4me Wordテンプレート 使用する <<[fieldName]>> 通常のLINQ構文 .docxテンプレートの作成方法に合ったタイプを選択してください。1つのメールに複数の受信者を送る場合 API 呼び出し、使用文書を生成する（複数）その代わり。 :::

サンプルファイルパック

以下の4つのファイルをすべてダウンロードしてください。Word形式の差し込み印刷テンプレート1つと、それに対応する3つのデータ形式が含まれています。

simple_mail_merge_template.docx

Wordの差し込み印刷テンプレート（4つのフィールド）

sample_mail_merge_data.json

JSON 受信者行が1つだけの配列（推奨）

サンプルファイルの内容

マージフィールド `simple_mail_merge_template.docx`

サンプルは単純なものです 会員証 4つの定番Word差し込み印刷フィールド付き：

Merge field name	Typical label in template	Sample value (sample_mail_merge_data.json)
`firstname`	Given name	John
`lastname`	Family name	Adams
`gender`	Gender	Female
`member`	Membership tier	Basic

:::ヒント差し込みフィールド名を確認する方法 Microsoft Wordで、 Alt+F9 フィールドコードを切り替えるには、メールマージフィールドは次のように表示されます。 { MERGEFIELD firstname } スタイルコード。 マージフィールド あなたの JSON鍵。 :::

すべてのデータファイルにわたるフィールドマッピング

Merge field	JSON key (sample_mail_merge_data.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

PDF4me Word Templateとは異なり、 <<[フィールド]>> タグとは異なります。 HTML口ひげ構文はありません。エンジンバインド JSON Wordの差し込みフィールド名のキー 1対1。

ワークフローの概要

Manual Trigger  →  Read Binary File (simple_mail_merge_template.docx)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File

ステップ	n8n ノード	目的
1	手動トリガー	ワークフローをオンデマンドで開始
2	バイナリファイルを読み込む	大量 `simple_mail_merge_template.docx` バイナリプロパティへ `data`
3	PDF4me → ドキュメント生成（単一）	テンプレートをマージします + JSON 配列、出力 PDF または Word
4	バイナリファイルを書き込むまたはメールを送信する（任意）	保存または送信 `generated_document_output.pdf`

n8n PDF4meの「ドキュメント生成（単一）」ノードにあるテンプレートファイルタイプのドロップダウンリストには、Word、HTML、PDFフォーム、Googleドキュメントのオプションからメールマージが表示されます。 — セット **テンプレートファイルの種類** に **メールマージ**。選ぶ **PDF** または **Word** のために **出力タイプ**。

ステップ1：サンプルファイルをダウンロードして配置する

ダウンロード simple_mail_merge_template.docx そして sample_mail_merge_data.json からサンプルファイルパックその上。
テンプレートをどこかに保存してください。 n8n （自己ホスト型の場合はローカルパス、本番環境のトリガーの場合はクラウドストレージ）を読み取ることができます。
オプションでダウンロード test.xml または test.csv 他のデータ型をテストするため。

ステップ2： n8n ワークフロー

で n8n新しいワークフローを作成します。
追加する 手動トリガー ノード。
追加する バイナリファイルを読み込む トリガーの後のノード。
追加 PDF4me → ドキュメント生成（単一） バイナリファイルを読み込んだ後。
接続 PDF4me 資格情報。

:::注意：ここではHTMLコードは無効です テンプレートファイル入力タイプ: HTML コード のみ機能します テンプレートファイルの種類 は HTMLメールマージには、 バイナリデータ、 Base64 弦、または URL。 :::

ステップ 3: Word テンプレートを読み込む (`Read Binary File`）

設定する バイナリファイルを読み込む ノード:

分野	価値
ファイルパス	ダウンロードしたファイルのフルパス `simple_mail_merge_template.docx`
物件名	`data` （デフォルト; として使用される）テンプレートバイナリプロパティで PDF4me）

このノードを一度実行し、出力項目がバイナリであることを確認してください。 data ファイル名付き simple_mail_merge_template.docx。

ステップ4：設定 PDF4me ドキュメント生成（単一）

コア設定

分野	価値	注記
接続するための認証情報	あなたの PDF4me 資格情報	得る API 鍵
リソース	`Generate`
操作の生成	ドキュメント生成（単一）
テンプレートファイルの種類	メールマージ	クラシックなWord差し込みフィールドテンプレート
出力タイプ	PDF または Word	PDF 共有のため。 Word 受信者が結合された文書を編集する場合

テンプレート入力（バイナリファイル読み込みから）

分野	価値
テンプレートファイル入力タイプ	バイナリデータ
テンプレートバイナリプロパティ	`data`
テンプレートファイル名	`simple_mail_merge_template.docx`

ドキュメントデータ（JSON配列を貼り付け） `sample_mail_merge_data.json`）

分野	価値
ドキュメントデータ入力タイプ	文章
文書データタイプ	JSON
文書データテキスト	内容全体を貼り付ける `sample_mail_merge_data.json` （下記のブロックを参照）

[
  {
    "firstname": "John",
    "lastname": "Adams",
    "gender": "Female",
    "member": "Basic"
  }
]

:::重要 JSONは配列である必要がありますメールマージデータは JSON 配列受信者が1人であっても。配列内の1つのオブジェクトは、[ドキュメントの生成（単一）]で1つの結合ドキュメントを生成します。 :::

出力オプション

分野	価値
保つ PDF 編集可能	出力タイプが PDF
バイナリデータ出力名	`data` （デフォルト）

ステップ5：実行して出力を確認する

クリック ワークフローを実行する。
開く PDF4me ノード出力。 バイナリオープンな物件 data （generated_document_output.pdf または .docx)
4つの差し込みフィールドすべてに入力されていることを確認してください。
- ファーストネーム → ジョン
- 苗字 → アダムス
- 性別 → 女性
- メンバー → 基本

フィールドが空白の場合は、 JSON Wordテンプレート内の差し込みフィールド名に対応するキー（WordではAlt+F9）。

ステップ6：出力を保存または送信する（オプション）

バイナリファイルを書き込む:

分野	価値
ファイル名	`mail-merge-output.pdf`
データプロパティ名	`data`
出力パス	ターゲットフォルダ n8n ホスト

メール送信： バイナリを添付する data から PDF4me として PDF または Word 添付ファイル。

代替データ形式

選択肢A： JSON バイナリファイルとして(`sample_mail_merge_data.json`）

追加 バイナリファイルを読み込む のために sample_mail_merge_data.json （ マージ テンプレートとデータがワークフロー項目を共有する場合、ノードが機能します。
セット ドキュメントデータ入力タイプ に バイナリデータ、 文書データタイプ に JSON、 文書バイナリプロパティ データフィールドに、 ドキュメントデータファイル名 に sample_mail_merge_data.json。

:::注意バイナリプロパティ名の衝突テンプレートとデータの両方でプロパティが使用されている場合 data、一方が他方を上書きします。別々の名前を使用してください (例: template そして mergeData）または、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>

要素名は、マージフィールド名およびJSONキーと一致します。

オプションC： CSV （`test.csv`）

セット 文書データタイプ に CSV そして貼り付けます（ヘッダー行＋データ行1行）：

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

列ヘッダーは、差し込みフィールド名と直接一致します。

代替テンプレート入力: URL

ホスト simple_mail_merge_template.docx 公の場で HTTPS URLそして、以下を設定します。

分野	価値
テンプレートファイル入力タイプ	URL
テンプレートファイルのURL	公開リンク `simple_mail_merge_template.docx`
テンプレートファイル名	`simple_mail_merge_template.docx`

Read Binary Fileノードは不要です。データは引き続き貼り付けることができます。 文書データテキスト またはロードされた URL。

生産ワークフローパターン

本番環境でメールマージを実行する一般的な方法Once the sample test works, replace the Manual Trigger with these patterns.

Googleスプレッドシートの行を文字に合わせる

新しい行が出現すると、シートがトリガーされます。
コード または セット ノードは行をラップします JSON 配列： [{"ファーストネーム"： "..."、 ...}]。
PDF4me 固定のメールマージ simple_mail_merge_template.docx。
統合されたメール PDF 受取人へ。

Webhook登録フォーム

Webhookはフォームペイロードを受信します。
ボディフィールドをマッピングしてキーをマージします（ファーストネーム、 苗字など）。
1つのアイテムを作成する JSON ドキュメントデータテキストの配列。
出力を保存またはメールで送信 PDF。

一括マージ（受信者多数）

連絡先をエクスポート JSON 配列（一人につき一つのオブジェクト）。
切り替えて文書を生成する（複数） 1つ PDF 行ごと。
1回の実行で結合ファイルが1つだけ必要な場合は、「ドキュメント生成（単一）」を選択してください。

よくある質問

How is Mail Merge different from PDF4me Word Template?+

Mail Merge uses classic Word MERGEFIELD placeholders created in Word mail merge. PDF4me Word Template uses <<[fieldName]>> LINQ syntax in a regular .docx. Pick the type that matches how your template was authored. Data for Mail Merge is typically a JSON array.

Why must JSON be an array?+

Mail merge is designed for one or more recipient rows. Generate Document (Single) uses the first row when you pass one object in the array. Generate Documents (Multiple) processes every row and returns multiple output files.

Why is a merge field blank?+

JSON keys must match MERGEFIELD names exactly, including case. firstname works; FirstName or first_name usually does not. Toggle field codes in Word (Alt+F9) to read the internal name.

PDF or Word output?+

Choose PDF for emailing, archiving, or printing. Choose Word when the recipient needs to edit the merged document after generation. Both work with the same template and JSON array.

JSON vs XML vs CSV: which should I use?+

JSON arrays are the most natural fit for mail merge in n8n. XML and CSV in the sample pack carry the same four values for a single recipient. All formats map one value per merge field name.

始める前に​

サンプルファイルパック​

サンプルファイルの内容​

マージフィールド simple_mail_merge_template.docx​

すべてのデータファイルにわたるフィールドマッピング​

ワークフローの概要​

ステップ1：サンプルファイルをダウンロードして配置する​

ステップ2： n8n ワークフロー​

ステップ 3: Word テンプレートを読み込む (Read Binary File）​

ステップ4：設定 PDF4me ドキュメント生成（単一）​

コア設定​

テンプレート入力（バイナリファイル読み込みから）​

ドキュメントデータ（JSON配列を貼り付け） sample_mail_merge_data.json）​

出力オプション​

ステップ5：実行して出力を確認する​

ステップ6：出力を保存または送信する（オプション）​

代替データ形式​

選択肢A： JSON バイナリファイルとして(sample_mail_merge_data.json）​

選択肢B： XML （test.xml）​

オプションC： CSV （test.csv）​

代替テンプレート入力: URL​

生産ワークフローパターン​

よくある質問​

関連ガイド​