ドキュメントを生成する（シングル） n8n

ドキュメント生成（単一） は n8n ノードによる PDF4me 単語を融合する、 HTML、 PDF フォーム、メールマージ、または Google Docs テンプレート JSON、 XML、 または CSV ワークフロー実行ごとに1つの完成文書を作成するためのデータを提供します。署名済みの契約書、パーソナライズされた手紙、またはカスタムコードなしでオンデマンドレポートを作成する場合に使用できます。

このノードの機能

PDF4me: ドキュメントの生成（単一） 1 つのテンプレートを 1 つのデータセットとマージし、1 つの完成ドキュメントを返します。 n8n 実行します。5 つのテンプレート タイプをサポートします (PDF4me Wordテンプレート、 HTMLPDFフォーム、メールマージ、 Google Docs）と3つのデータ形式（JSON、 XML、 CSVテンプレートはバイナリデータを介して入力されます。 Base64貼り付けた HTML コード（HTML のみ）、または URL; データはテキスト、バイナリデータ、 Base64、 または URL単一の契約書、パーソナライズされた手紙、オンデマンドレポート、または単発の文書に最適です。リスト駆動型のバッチには、 文書を生成する（複数）。

関連ブログ記事

この機能に関するブログ記事はまだありません。近日公開予定です。

その間、PDF4me ブログを閲覧して、あらゆるプラットフォームのチュートリアルやワークフローをご覧ください。

ブログをご覧ください →

テンプレートの種類を選択してください

あなたに合ったガイドを選んでください テンプレートファイルの種類 で n8n ノード。各ページには、正確なサンプルテンプレート、データファイル（JSON、 XML、 CSV）、推奨されるフィールド値、および迅速なテストワークフロー。

PDF4me Wordテンプレート

標準 .docx 口ひげのプレースホルダー付き。出力 PDF または Word. 含まれる テンプレート.docx + data.json。

HTML

HTML ファイルまたは貼り付け HTML コード出力 HTML 請求書のみ。 HTML + JSON データ。

PDF形式

アクロフォーム PDF テンプレート。出力 PDF のみ。 テンプレート.pdf + formdata.json。

メールマージ

Wordの差し込み印刷フィールド。出力 PDF または Word. 含まれる simple_mail_merge_template.docx。

Google Docs

Google Docs エクスポートスタイル .docx出力 PDF または Word. 含まれる google-docs-template.docx。

認証 API リクエスト

毎 PDF4me ノード n8n 有効な 接続するための認証情報. 作成または選択して、 PDF4me API ワークフローがテンプレートマージ要求を安全に認証できるようにするためのキー。

Get your API Key

見逃してはならない重要な事実

実行ごとに1つのドキュメント、出力アイテムは1つ

各実行は正確に1を返します n8n バイナリデータ出力名(デフォルト)の下にバイナリファイルを1つ運ぶアイテム データ) レコードのリストから一度に複数のファイルを生成するには、代わりに「ドキュメントの生成 (複数)」を使用するか、このノードをループで囲みます。

HTML コードは HTML-only ですが、ドロップダウンにはどこにでも表示されます。

テンプレートファイル入力タイプリスト HTML テンプレート ファイル タイプごとにコードがありますが、テンプレート ファイル タイプが次の場合にのみ有効です。 HTMLWord、PDFフォーム、メールマージ、または Google Docsバイナリデータを使用する、 Base64 文字列、または URL。

プレースホルダー名はデータキーと完全に一致する必要があります

口ひげスタイルのプレースホルダー（{{名前}}) または Word の差し込みフィールドは、キーと一致する必要があります JSON/XML または列ヘッダー CSV不一致は、何も警告なしに空の値として表示されます。

デフォルトの Word パス: Word テンプレート (バイナリ) + JSON テキストデータ + PDF 出力

HTML パス: 貼り付け済み HTML コード + XML/JSON データ + HTML 出力

ドキュメント生成（単一）に必要なパラメータは何ですか？

必須 n8n UI: 接続に使用する認証情報、テンプレートファイルタイプ、テンプレートファイル入力タイプ、ドキュメントデータ入力タイプ、ドキュメントデータタイプ、および出力タイプ（常に表示されます。選択肢はテンプレートファイルタイプによって異なります）。条件付き必須フィールド（テンプレートバイナリプロパティ、テンプレート Base64 コンテンツ、 HTML コード、テンプレートファイル URL（ドキュメントデータテキスト、ドキュメントバイナリプロパティなど）は、親の入力タイプが選択されている場合にのみ表示されます。 PDF 編集可能、バイナリデータ出力名、およびテンプレートファイル名（バイナリデータ入力用）はオプションであり、適切なデフォルト値が設定されています。

パラメータ	必須	その機能	例
Template File Type	Required	Format of the template. Choose PDF4me Word Template (.docx), HTML (file or pasted code), Pdf Form (PDF with form/merge fields), Mail Merge (Word mail-merge), or Google Docs (Google Docs export style). Default is `PDF4me Word Template`.	PDF4me Word Template
Output Type	Required	Format of the rendered document. Word, Mail Merge, and Google Docs accept PDF or Word (default PDF). HTML accepts HTML only. Pdf Form accepts PDF only.	PDF
Template File Input Type	Required	How the template is supplied. Binary Data reads from a previous node (most common). Base64 String accepts an encoded template. HTML Code accepts pasted raw HTML (HTML template type only). URL downloads the template from a public link. Default is `Binary Data`.	Binary Data
Template Binary Property	Conditional	Name of the binary property on the incoming n8n item that holds the template file. Required when Template File Input Type is Binary Data. Defaults to data.	data
Template Base64 Content	Conditional	Base64-encoded template content. Required when Template File Input Type is Base64 String.	UEsDBBQAAAAI...
HTML Code	Conditional	Raw HTML body with mustache placeholders like {{title}}, {{heading}}, {{content}}. Required when Template File Input Type is HTML Code (and only valid when Template File Type is HTML). The node wraps the snippet in a basic <html> shell if missing.	<h1>{{title}}</h1>
Template File URL	Conditional	Publicly reachable HTTPS URL to the template file. Required when Template File Input Type is URL.	https://example.com/template.docx
Template File Name	Conditional	Filename of the template. Optional with Binary Data (falls back to the uploaded filename or a default like template.docx, template.html, template.pdf based on template type). Required for Base64 String, HTML Code, and URL.	template.docx
Document Data Input Type	Required	How the data is supplied. Text accepts JSON, XML or CSV pasted directly. Binary Data reads a data file from a previous node. Base64 String accepts an encoded data file. URL downloads the data file from a public link. Default is `Text`.	Text
Document Data Type	Required	Format of the data payload. JSON for object/array, XML for XML documents, CSV for comma-separated rows. Drives both validation and the placeholder examples shown in the UI. Default is `JSON`.	JSON
Document Data Text	Conditional	Raw JSON, XML, or CSV payload. Required when Document Data Input Type is Text. The node validates JSON parses, XML looks like XML, and CSV is non-empty.	{"name":"John Doe","email":"[email protected]"}
Document Binary Property	Conditional	Name of the binary property on the incoming n8n item that holds the data file. Required when Document Data Input Type is Binary Data. Defaults to data.	data
Document Base64 Content	Conditional	Base64-encoded data file. Required when Document Data Input Type is Base64 String.	eyJuYW1lIjoiSm9obiJ9
Document Data File URL	Conditional	Publicly reachable HTTPS URL to the data file. Required when Document Data Input Type is URL.	https://example.com/data.json
Document Data File Name	Conditional	Filename for the data file. Optional with Binary Data (falls back to data.json based on type). Required for Base64 String and URL.	data.json
Keep PDF Editable	Optional	Only shown when Output Type is PDF. Keeps AcroForm fields editable in the generated PDF when enabled. Default is `No` (flattened).	No
Binary Data Output Name	Optional	Name of the binary property the output item exposes. Default is data. The node sets the download filename automatically as generated_document_output.<ext>.	data

テンプレートファイルタイプのオプション

テンプレートの種類は5つあります。選択によって、 出力タイプ オプションが表示され、 テンプレートファイルの入力タイプ 実用的です。サンプルファイルとフィールドごとの設定については、上記のマッチングガイドを開いてください。

PDF4me Wordテンプレート

デフォルト .docx テンプレート。出力 PDF または Word。 ガイドを見る →

HTML

ファイルまたは貼り付け済み HTML コード。出力 HTML のみ。 ガイドを見る →

PDF形式

PDF フォームフィールド付き。出力 PDF のみ。 ガイドを見る →

メールマージ

Wordの差し込み印刷スタイル。出力 PDF または Word。 ガイドを見る →

Googleドキュメント

Google Docs 輸出 .docx出力 PDF または Word。 ガイドを見る →

テンプレートファイルタイプのドロップダウンメニュー n8n ノード

テンプレートによる出力タイプ

テンプレートファイルの種類	出力タイプの選択肢	デフォルト
PDF4me Word Template	PDF, Word	PDF
Mail Merge	PDF, Word	PDF
Google Docs	PDF, Word	PDF
HTML	HTML only	HTML
Pdf Form	PDF only	PDF

Wordファミリーのテンプレートの場合、出力タイプのドロップダウンメニューが表示されます。 PDF （デフォルト）または Word

テンプレートファイル入力タイプのオプション

テンプレートをノードに挿入する方法を選択してください。この選択によって、後続のフィールドが変更されます。

テンプレートファイル入力タイプ。バイナリデータ、 Base64 弦、 HTML コード、または URL

バイナリデータデフォルト: 前のノードからのファイル

Google Drive Download などの前のノードからテンプレートを直接読み取ります。 HTTP リクエスト、またはバイナリファイルの読み込み。設定 テンプレートバイナリプロパティ バイナリフィールド名（デフォルト） データ) テンプレートファイル名 オプションであり、指定された場合はアップロードされたファイル名が使用されます。

Base64文字列Base64-エンコードされたテンプレート

base64文字列を貼り付けるかマッピングして テンプレートのBase64コンテンツ。 テンプレートファイル名 拡張子がテンプレートファイルの種類（.docx、.html、.pdf）と一致するように、この設定が必要です。

HTMLコードペースト生 HTML 列をなして （HTML のみ）

テンプレート ファイル タイプが HTML全部または一部を入力してください HTML プレースホルダー付き {{タイトル}}、 {{コンテンツ}}ノードはそれを基本的な <html> 欠落している場合はシェルを装備してください。 テンプレートファイル名 必須です (例: テンプレート.html)

URL公開リンクからダウンロード

提供する HTTPS URL で テンプレートファイルのURL。 PDF4me テンプレートを直接取得します。 URL オープン（認証なし）で テンプレートファイル名 拡張子がテンプレートタイプと一致するように、これは必須です。

ドキュメントデータ入力タイプのオプション

データがノードに入力される方法を選択します。

ドキュメントデータ入力タイプ。テキスト、バイナリデータ、 Base64 文字列、または URL

文章デフォルト:データをインラインで貼り付ける

データを型または式マップして 文書データテキストノードが検証します JSON 解析、 XML のように見える XML、 そして CSV 空ではない。 UI ドキュメントデータ型に一致するプレースホルダーの例を表示します。

バイナリデータ前のノードのデータファイルを使用する

セット 文書バイナリプロパティ バイナリフィールド名（デフォルト） データテンプレートとデータバイナリのプロパティ名が同じアイテムから取得されている場合、それらが衝突しないように注意してください。必要に応じてマージノードを使用してください。

Base64文字列Base64エンコードされたデータファイル

すべてを提供する .json、 .xml、 または .csv ファイルをbase64として ドキュメントのBase64コンテンツ。 ドキュメントデータファイル名 拡張子がデータ型と一致するように、これは必須です。

URL公開リンクからダウンロード

セット ドキュメントデータファイルのURL 公衆に HTTPS URL の JSON、 XML、 または CSV ファイル。 ドキュメントデータファイル名 が必要です。

ドキュメントデータタイプのオプション

データペイロードのフォーマットを選択してください。これにより、検証と、テキスト入力用に表示されるインラインプレースホルダーの例が駆動されます。

文書データ型。 JSON、 XML、 または CSV （シングルサポート） CSV（複数はそうではない）

JSONデフォルト: オブジェクトまたは配列データ

テンプレートのプレースホルダーと一致するキーを持つオブジェクトを渡します。例: {"名前":"ジョン","メールアドレス":"[email protected]","items":[...]}ノードはペイロードが解析されることを検証します JSON.parse。

XMLXML 書類

送信 XML テンプレートエンジンがバインドできるドキュメント、例: <?xml version="1.0"?><root><name>John</name></root>. ノードはペイロードが以下で始まるかどうかを確認します < および >。

CSVカンマ区切り値

パス CSV ヘッダー行を含む本文、例: 名前、メールアドレス\nジョン・ドゥ、[email protected]ノードは、トリミング後にペイロードが空でないことを確認します。 CSV 単一操作でのみ利用可能です。複数操作では受け付けません。 CSV。

出力フィールド

成功したランは1 n8n 持ち運んでいるアイテム JSON メタデータとバイナリファイル。

分野	タイプ	内容物
success	Boolean	True when the document was generated successfully. Use to route error-handling branches.
fileName	String	Generated filename, set automatically to generated_document_output.<ext> based on Output Type (pdf, docx, html).
mimeType	String	MIME type of the output: application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, or text/html.
fileSize	Number	Size of the generated file in bytes.
data	Binary	The generated document, in the chosen Output Type, under the property named in Binary Data Output Name (default `data`). Pass into Write Binary File, Email, or any cloud-storage upload.

ドキュメント生成（シングル）の設定方法 n8n？

1. 追加 PDF4me あなたの n8n ワークフローを設定します。 リソース に 生成する そして 操作の生成 に ドキュメント生成（単一）。
2. で 接続するための認証情報選択してください PDF4me 認証情報またはクリック 新しい認証情報を作成する そしてあなたの API 鍵。
3. セット テンプレートファイルの種類 に PDF4me Wordテンプレート （デフォルト）、 HTML、 PDF形式、 メールマージ、 または Google Docs。
4. セット 出力タイプ. 単語ファミリーテンプレートは受け入れます PDF または Word; HTML 受け入れる HTML PDF形式のみ PDF のみ。
5. セット テンプレートファイル入力タイプ に バイナリデータ （デフォルト）、 Base64 弦、 HTML コード （HTML のみ）、または URL そして、一致するテンプレートフィールドに加えて テンプレートファイル名 必要に応じて。
6. セット ドキュメントデータ入力タイプ に 文章 （デフォルト）ペイロードを貼り付けて 文書データテキストまたはバイナリデータを選択します。 Base64 文字列、または URL データファイルを提供してください。
7. セット 文書データタイプ に JSON （デフォルト）、 XML、 または CSV つまり、検証とプレースホルダーが一致するということです。
8. 出力する場合 PDF テンプレートにはフォーム フィールドがあり、 保つ PDF 編集可能 必要に応じて。
9. 離れる バイナリデータ出力名 として data 下流ノードで別のプロパティ名が必要な場合を除き、ノードを実行し、単一の出力項目を「バイナリファイル書き込み」、「電子メール」、または「クラウドストレージ」にルーティングします。

典型的な構成

ワークフローの例Common n8n workflow patterns using Generate Document (Single).

Wordテンプレート + CRMからのJSON。署名済み契約書

1. A CRM 取引が「完了-落札」とマークされたときに、ウェブフックが起動します。
2. Googleドライブのダウンロードノードは、標準契約テンプレートを取得します。 .docx （バイナリデータ、プロパティ） データ)
3. PDF4me ドキュメント生成（単一）は、テンプレートファイルタイプ PDF4me Word テンプレート、出力タイプで実行されます。 PDFドキュメントデータ入力タイプ：テキスト。 文書データテキスト は、取引ペイロードをマッピングする式です。 JSON。
4. 署名要求ノードは生成された PDF DocuSignへ。

貼り付けたコードからHTMLメール形式のドキュメントを作成する

1. スケジュールトリガーは、平日の毎朝実行されます。
2. 1 HTTP リクエストノードは JSON 昨日の要約 KPIs。
3. PDF4me ドキュメント生成（単一）はテンプレートファイルタイプで実行されます HTMLテンプレートファイル入力タイプ HTML コード。 HTML 本体はノードに貼り付けられます {{タイトル}}、 {{見出し}}、 {{コンテンツ}} プレースホルダー。出力タイプは HTML。
4. メール送信ノードは生成された HTML 経営陣向け配信リストへのメール本文に直接記載する。

テンプレートとデータは両方ともファイルとして（マージ済み） n8n）

1. 一方のノードがテンプレートをダウンロードし、もう一方のノードがデータファイルをダウンロードします。マージノードがそれらを結合し、両方のバイナリを1つのアイテムに格納します。
2. PDF4me ドキュメント生成（シングル）は、テンプレートファイル入力タイプバイナリデータで実行されます（テンプレートバイナリプロパティ テンプレートフィールド名に設定）およびドキュメントデータ入力タイプバイナリデータ（文書バイナリプロパティ データフィールド名に設定します。
3. セット ドキュメントデータファイル名 データファイルに名前が付けられていない場合 data.json。
4. 出力 PDF 注文IDをファイル名として、SharePointドキュメントライブラリに保存されます。

すべてURL上にあります。ホストされたテンプレートとホストされたデータ

1. Webhookトリガーは、外部の課金システムから発火します。
2. PDF4me テンプレートファイル入力タイプでドキュメント生成（単一）が設定されています URL （テンプレートファイルのURL S3上の.docxファイルを参照し、ドキュメントデータ入力タイプを指定します。 URL （ドキュメントデータファイルのURL 生成されたものを指す customer.json)
3. データファイルの拡張子にドキュメントデータタイプを一致させて、 テンプレートファイル名 そして ドキュメントデータファイル名 それで PDF4me それらを適切に処理する。
4. 出力 PDF Dropboxにアップロードされ、Outlook経由でメールで送信されます。

編集可能なフィールドが保持されたPDFフォームテンプレート

1. Typeformからの送信によってワークフローが開始されます。
2. PDF4me ドキュメント生成（単一）は、テンプレートファイルタイプ Pdf フォーム、出力タイプで実行されます。 PDFテンプレートファイル入力タイプバイナリデータ（ PDF フォームテンプレートはドライブから取得します。ドキュメントデータはフォームペイロードです。 JSON 文章。
3. 保つ PDF 編集可能 受信者が自動入力されたフィールドを修正または追加できるように、この機能はオンになっています。
4. 生成された PDF 申請者には確認のため電子メールで送付されます。

実践的なヒント

Placeholders must align with data keys

Mustache {{name}} in the template must match "name" in JSON or the matching XML tag / CSV header. Mismatches render as empty silently.

HTML Code is HTML-only

The dropdown shows HTML Code for every template type but the node rejects it unless Template File Type is HTML.

"No binary data found" errors

Double-check Template Binary Property and Document Binary Property names. The Merge node from a fan-in workflow can rename binary properties.

Invalid JSON stops the run

Document Data Text with Document Data Type JSON is parsed with JSON.parse. Malformed payloads fail early; validate with a Code node if the JSON is dynamic.

Use Multiple for batches

To produce many files from a list of records in one execution, switch to Generate Documents (Multiple). For ad-hoc batches you can also wrap Single in a Loop Over Items node.

Keep PDF Editable only matters for PDF

The toggle appears only when Output Type is PDF. For Word or HTML output it is ignored.

チートシート

分野	価値
Resource	Generate
Operation	Generate Document (Single)
Template File Type	PDF4me Word Template
Output Type	PDF
Template File Input Type	Binary Data
Template Binary Property	data
Document Data Input Type	Text
Document Data Type	JSON
Document Data Text	(your inline JSON payload)
Binary Data Output Name	data (or generated-document)
Credentials	PDF4me API credential

よくある質問

Which template types does Generate Document (Single) support?+

Five: PDF4me Word Template (.docx with mustache placeholders), HTML (file or pasted code), Pdf Form (PDF with form / merge fields), Mail Merge (Word mail-merge style), and Google Docs (Google Docs export style).

What data formats are accepted?+

JSON, XML, and CSV. Pick Document Data Type to match your data, then choose how to supply it: Text (paste inline), Binary Data (from a previous node), Base64 String, or URL.

When does HTML Code appear in Template File Input Type?+

It appears in the dropdown for every Template File Type, but the node only accepts HTML Code when Template File Type is HTML. For Word, Pdf Form, Mail Merge, or Google Docs, use Binary Data, Base64 String, or URL instead.

What Output Type can I pick for each template?+

PDF4me Word Template, Mail Merge, and Google Docs accept PDF or Word (default PDF). HTML accepts HTML only. Pdf Form accepts PDF only.

Can I generate many documents in one run?+

No, Generate Document (Single) renders exactly one document per execution. To batch a list of records into many files in a single run, use Generate Documents (Multiple). To process records sequentially with the Single node, wrap it in a Loop Over Items.

What happens if my JSON in Document Data Text is invalid?+

The node validates with JSON.parse and fails the run with a format error before calling the API. Validate dynamic JSON with a Code node upstream if you expect untrusted input.

How does the output filename get set?+

Automatically as generated_document_output.<ext> based on Output Type. The download is exposed under Binary Data Output Name (default data) so you can rename it in Write Binary File or any upload node downstream.

Should I turn on Keep PDF Editable for every PDF output?+

No, only when the recipient needs to edit the generated form fields. With Keep PDF Editable off (default), the form is flattened into static text on the final PDF, which is the right choice for delivered records like signed contracts or final invoices.

関連アクション

文書を生成する（複数）

同じテンプレートエンジンだが、1回の実行で多数のファイルを生成する JSON 配列または繰り返し XML レコード。テンプレートの種類が少ない (Word、 HTML、 PDF のみ）そしていいえ CSV。

PDFフォームに記入してください

既存の AcroForm フィールドに入力する PDF 完全なテンプレートエンジンを通してレンダリングするのではなく。

ドキュメントを保護する

生成されたものにパスワード保護または権限を適用する PDF 納品前。文書生成後の一般的な連鎖ステップ。

他のプラットフォームでの同じタスク

ドキュメントを生成する（シングル） Make

同じ単一ドキュメントレンダリング Make モジュール、同じテンプレートを使用したビジュアルシナリオ、およびデータ入力モード。

ドキュメントを生成する（シングル） Zapier

6,000以上のSaaSアプリとWebhookから、単一ドキュメントの生成をトリガーできます。

ドキュメントを生成する（シングル） Power Automate

Microsoft 365 流れ SharePoint、 OutlookTeams、およびDataverseとの連携。

ドキュメント生成（単一） REST API

生 POST /api/v2/GenerateDocumentSingle エンドポイント。カスタムバックエンドコードやPostmanテスト用。

ヘルプが必要な場合

n8n Integration Guiden8n SampleGetting Started