Buat Dokumen (Banyak) di n8n
Buat Dokumen Berganda adalah aksi node PDF4me di n8n, yang ditampilkan di node sebagai Generate Documents (Multiple), yang menghasilkan banyak file jadi dalam satu kali proses dari satu templat ditambah serangkaian catatan. Gunakan ini untuk sejumlah faktur, surat pelanggan, atau laporan per wilayah, dengan setiap dokumen dikembalikan sebagai item n8n tersendiri.
Fungsi node ini
PDF4me: Hasilkan Dokumen (Beberapa) hanya membutuhkan satu templat dan daftar catatan, lalu menghasilkan banyak dokumen jadi dalam satu proses. n8n jalankan. Berikan Kata, HTML, atau PDF templat melalui Data Biner, Base64, HTML kode, atau URL ditambah data massal sebagai JSON atau XML (susunan catatan atau pengulangan) XMLSetiap file yang dihasilkan akan dikembalikan sebagai item output terpisah sehingga Anda dapat melakukan perulangan, menyimpan, mengirim email, atau mengunggahnya secara individual. Gunakan node ini sebagai pengganti Buat Dokumen (Tunggal) Kapan pun Anda memiliki daftar pelanggan, faktur, atau catatan dan menginginkan satu dokumen lengkap per baris dalam satu kali eksekusi.
Memverifikasi Identitas Anda API Meminta
Setiap PDF4me simpul di n8n memerlukan validitas Kredensial untuk terhubung denganBuat atau pilih salah satu yang sesuai dengan kebutuhan Anda. PDF4me API kunci agar alur kerja dapat mengautentikasi permintaan pembuatan dokumen secara massal dengan aman.
Fakta Penting yang Tidak Boleh Anda Lewatkan
/generate-documents-multiple-full.png)
Panel node lengkap. Templat Word + JSON Data teks + PDF Outputnya adalah pengaturan penggabungan surat (mail-merge) yang umum.
Menghasilkan Dokumen (Banyak) vs Menghasilkan Dokumen (Tunggal)
Kesalahan paling umum dalam tugas ini adalah memilih salah satu dari dua opsi yang tersedia. Pembagiannya bergantung pada berapa banyak file yang dikembalikan dan format template serta data apa yang ditawarkan.
| Aspek | Buat Dokumen (Beberapa) | Buat Dokumen (Tunggal) |
|---|---|---|
| Files returned | Many, one n8n item per generated document | Exactly one |
| Template types | Word, HTML, PDF | Word, HTML, PDF, plus Mail Merge and Google Docs |
| Data formats | JSON or XML only | JSON, XML, and CSV |
| Output types | PDF, Word, or Excel (HTML templates output HTML) | PDF, Word (no Excel option) |
| Reach for it when | You have a list of records and want one document per row | You have a single record, CSV data, or a Mail Merge template |
Parameter apa saja yang dibutuhkan oleh Generate Documents (Multiple)?
Diperlukan dalam n8n UI: Kredensial untuk terhubung, Tipe File Templat, Tipe Input File Templat, Tipe Data Dokumen, Tipe Input Data Dokumen, dan Tipe Output (selalu ditampilkan. Pilihan bergantung pada Tipe File Templat). Bidang wajib bersyarat (Properti Biner Templat, Templat) Base64 Isi, HTML Kode, File Templat URL(Data Dokumen Teks, Properti Biner Dokumen, dll.) hanya muncul ketika tipe input induknya dipilih. Nama File Output, Simpan PDF Nama Output Data yang Dapat Diedit dan Biner bersifat opsional dengan nilai default yang masuk akal.
| Parameter | Diperlukan | Apa fungsinya? | Contoh |
|---|---|---|---|
| Template File Type | Required | Format of the template the node will render. Word for .docx templates, HTML for HTML templates (including pasted code), PDF for PDF templates. There is no Mail Merge, Google Docs, or PDF form option here; use Generate Document (Single) for those. | Word |
| Output Type | Required | Format of every generated document. Word and PDF templates accept PDF, Word, or Excel. HTML templates accept HTML only. Default is PDF when available. | 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 (only valid when Template File Type is HTML). URL downloads the template from a public link. | Binary Data |
| Template Binary Property | Conditional | Name of the binary property on the incoming n8n item that holds the template. 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 (mustache placeholders such as {{title}} are supported). Required when Template File Input Type is HTML Code, which is only valid for Template File Type 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 sensible default such as template.docx, template.html, template.pdf). Required for Base64 String, HTML Code, and URL. | template.docx |
| Document Data Type | Required | Format of the bulk records you are sending. JSON for arrays of objects (most common). XML for repeating-record XML. CSV is not available on this operation. | JSON |
| Document Data Input Type | Required | How the bulk data is supplied. Text is the default (paste JSON or XML directly). Binary Data reads from a previous node. Base64 String accepts an encoded data file. URL downloads the data file from a public link. | Text |
| Document Data Text | Conditional | Raw bulk JSON or XML payload. Required when Document Data Input Type is Text. The node validates that JSON parses; XML is sent as-is. Use an array of objects in JSON so the API renders many files. | [{"name":"Alice"},{"name":"Bob"}] |
| 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 Data File Name | Conditional | Filename for the bulk data file. Optional with Binary Data (falls back to data.json). Required when Document Data Input Type is Base64 String or URL. | customers.json |
| Document Base64 Content | Conditional | Base64-encoded data file. Required when Document Data Input Type is Base64 String. | W3sibmFtZSI6... |
| Document Data File URL | Conditional | Publicly reachable HTTPS URL to the bulk data file. Required when Document Data Input Type is URL. | https://example.com/customers.json |
| Output File Name | Optional | Prefix for the generated filenames. The node appends _1, _2, ... and the correct extension. Example: invoice becomes invoice_1.pdf, invoice_2.pdf. Leave blank to use API-provided names or generated_document_1, generated_document_2, ... | invoice |
| Keep PDF Editable | Optional | Only shown when Output Type is PDF. Keeps AcroForm fields editable on every generated PDF when enabled. Default is off (flattened output). | Off |
| Binary Data Output Name | Optional | Name of the binary property each output item exposes. Default is data. Placeholder suggests generated-documents. | data |
Opsi Jenis File Templat
Pilih format templat. Pilihan Tipe Output akan berubah sesuai dengan pilihan ini.
/generate-documents-multiple-template-file-type.png)
Menu tarik-turun Tipe File Templat. Word, HTML, atau PDF (tidak ada fitur Mail Merge atau Google Docs di sini)
KataDefault: template .docxHTMLHTML templat dan ditempel HTML kodePDFPDF templatJenis Output berdasarkan Templat
| Jenis File Templat | Pilihan Tipe Keluaran | Bawaan |
|---|---|---|
| Word | PDF, Word, Excel | |
| PDF, Word, Excel | ||
| HTML | HTML only | HTML |
Opsi Tipe Input File Templat
Pilih bagaimana templat masuk ke dalam node. Kolom selanjutnya akan berubah sesuai pilihan ini.
/generate-documents-multiple-template-file-input-type.png)
Tipe Input File Templat. Data Biner, Base64 Rangkaian, HTML Kode, atau URL
Data BinerDefault: file dari node sebelumnyaProperti Biner Templat ke nama bidang biner (default) data). Nama File Templat bersifat opsional dan akan menggunakan nama file yang diunggah sebagai alternatif.String Base64Base64templat yang dikodekanKonten Base64 Templat. Nama File Templat Diperlukan agar ekstensi sesuai dengan Tipe File Templat (.docx, .html, .pdf).Kode HTMLPasta mentah HTML sebaris (HTML hanya){{judul}}, {{isi}} ke dalam Kode HTMLNode tersebut membungkusnya dalam bentuk dasar. <html> shell jika tidak ada. Nama File Templat diperlukan (misalnya template.html).URLUnduh dari tautan publikURL File Templat. PDF4me mengambil templat secara langsung. Itu URL harus terbuka (tanpa otentikasi) dan Nama File Templat Diperlukan agar ekstensi sesuai dengan tipe templat.Opsi Tipe Data Dokumen
Pilih format data yang akan Anda kirim.
/generate-documents-multiple-document-data-type.png)
Tipe Data Dokumen. JSON atau XML (TIDAK CSV dalam operasi ini)
JSONDefault: array catatan (paling umum)[{"nama":"Alice"}, {"nama":"Bob"}]Node tersebut memvalidasi bahwa payload berhasil diuraikan. Satu objek menghasilkan satu dokumen. Berikan array jika Anda menginginkan banyak dokumen.XMLRekaman berulang XMLOpsi Tipe Input Data Dokumen
Pilih bagaimana data dalam jumlah besar masuk ke node.
/generate-documents-multiple-document-data-input-type.png)
Tipe Input Data Dokumen. Teks, Data Biner, Base64 Tali, atau URL
TeksDefault: tempel data massal secara langsungTeks Data DokumenKolom ini wajib diisi pada operasi Pilihan Ganda jika Teks dipilih (lebih wajib daripada Pilihan Tunggal).Data BinerGunakan berkas data dari node sebelumnya.Properti Biner Dokumen ke nama bidang biner (default) data). Perhatikan agar nama properti biner templat dan data tidak berbenturan ketika keduanya berasal dari item yang sama.String Base64Base64berkas data yang dikodekan.json atau .xml file sebagai base64 di Konten Dokumen Base64. Nama File Data Dokumen diperlukan.URLUnduh dari tautan publikURL File Data Dokumen kepada publik HTTPS URL dari JSON atau XML berkas data. Nama File Data Dokumen Diperlukan agar ekstensi sesuai dengan tipe data.Perilaku Nama File Output
| Skenario | Nama File Output | Nama file yang dihasilkan |
|---|---|---|
| One document returned | invoice | invoice.pdf (extension added if missing) |
| Many documents returned | invoice | invoice_1.pdf, invoice_2.pdf, invoice_3.pdf, ... |
| Many documents, name left empty | (empty) | API-provided names or generated_document_1, generated_document_2, ... |
Bidang Keluaran
Satu kali lari yang sukses akan menghasilkan satu n8n satu item per dokumen yang dihasilkan. Setiap item memuat keduanya. JSON metadata dan file biner.
| Bidang | Jenis | Isi di dalamnya |
|---|---|---|
success | Boolean | True when the document was generated successfully. Use to route error handling branches. |
fileName | String | Filename of this generated document, e.g. invoice_2.pdf. Map into upload or email nodes. |
mimeType | String | MIME type of the output file, e.g. application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, text/html. |
fileSize | Number | Size of the generated file in bytes. |
documentIndex | Number | Index of this document within the batch (1-based). Useful for filenames or logging. |
totalDocuments | Number | How many documents were produced in this run. Same on every item. |
Binary (data) | Binary | The generated document under Binary Data Output Name (default data). Pass to Write Binary File, Email, or any cloud-storage upload. |
Bagaimana Cara Mengatur Pembuatan Dokumen (Banyak) di n8n?
- Menambahkan PDF4me untuk Anda n8n Alur kerja. Atur Sumber ke Menghasilkan Dan Menghasilkan Operasi ke Buat Dokumen (Beberapa).
- Di dalam Kredensial untuk terhubung dengan, pilih milikmu PDF4me kredensial atau klik Buat Kredensial Baru dan tempelkan milik Anda API kunci.
- Mengatur Jenis File Templat ke Kata (bawaan), HTML, atau PDF.
- Mengatur Jenis Keluaran. PDF, Word, atau Excel untuk Word / PDF templat; HTML hanya untuk HTML templat.
- Mengatur Tipe Input File Templat ke Data Biner (bawaan), Base64 Rangkaian, HTML Kode (HTML hanya), atau URL dan isi kolom templat yang sesuai plus Nama File Templat jika diperlukan.
- Mengatur Jenis Data Dokumen ke JSON (default) atau XML.
- Mengatur Jenis Input Data Dokumen ke Teks (default) dan tempelkan milik Anda JSON array menjadi Teks Data Dokumen. atau pilih Data Biner, Base64 Tali, atau URL dan berikan file datanya.
- Mengatur Nama File Output menjadi sesuatu yang mudah dibaca seperti
invoicejadi berkas-berkas tersebut dikembalikan sebagaiinvoice_1.pdf,invoice_2.pdf... - Jika mengeluarkan PDF dan template Anda memiliki kolom formulir, aktifkan Menyimpan PDF Dapat diedit.
- Meninggalkan Nama Keluaran Data Biner sebagai
datakecuali jika node hilir membutuhkan nama properti yang berbeda. Jalankan node dan arahkan beberapa item output ke Pisahkan dalam Batch, Tulis File Biner, Email, atau unggahan penyimpanan cloud.
Pengaturan Umum
Contoh Alur KerjaCommon n8n workflow patterns using Generate Documents (Multiple).
- Node Google Sheets menarik daftar pelanggan beserta nama, alamat, dan saldo ke dalam alur kerja.
- Node Kode atau Set mengemas baris-baris tersebut ke dalam sebuah JSON susunan objek (satu objek per pelanggan).
- PDF4me Pembuatan Dokumen (Banyak) dijalankan dengan Tipe File Templat Word, Tipe Output PDF, Tipe Input File Template adalah Data Biner, dan Tipe Input Data Dokumen adalah Teks. Nama File Output adalah
surat pelanggan. - Node tersebut mengembalikan satu item per pelanggan bernama
surat_pelanggan_1.pdf,surat_pelanggan_2.pdfdan seterusnya. - Node Loop Over Items mengirimkan setiap PDF kepada pelanggan yang bersangkutan melalui Gmail atau unggahan ke Google Drive.
- Satu node mengunduh template .docx; node lain mengunduh file pelanggan .json. Node Merge menggabungkan keduanya sehingga kedua file biner tersebut berada pada satu item.
- PDF4me Pembuatan Dokumen (Banyak) dikonfigurasi dengan Tipe Input File Templat Data Biner (
Properti Biner Templatdiatur ke nama bidang templat) dan Tipe Input Data Dokumen Data Biner (Properti Biner Dokumen(ditetapkan ke nama kolom data). - Mengatur
Nama File Data Dokumenjika file data tidak diberi namadata.json. - File yang dihasilkan dikembalikan sebagai item terpisah dan ditulis ke sebuah SharePoint Pustaka dokumen yang diberi nama sesuai dengan ID pelanggan.
- Pemicu Jadwal malam hari akan menjalankan proses batch faktur.
- PDF4me Opsi "Buat Dokumen (Banyak)" diatur dengan Tipe Input File Templat. URL (
URL File Templat(menunjuk ke templat faktur .docx di S3) dan Tipe Input Data Dokumen URL (URL File Data Dokumenmenunjuk ke yang dihasilkansiklus-penagihan.jsonberkas). Nama File Templatadalahfaktur.docxDanNama File Data Dokumenadalahsiklus-penagihan.json.- Tipe Output adalah PDF, Nama File Output adalah
faktur, dan Tetaplah PDF Opsi edit dinonaktifkan. - Setiap barang yang dikembalikan diunggah ke folder pelanggan di Dropbox dan dikirim melalui email menggunakan Outlook.
- Webhook Trigger akan aktif saat kampanye pemasaran diluncurkan.
- PDF4me Buat Dokumen (Banyak) diatur dengan Tipe File Templat. HTML dan Tipe Input File Templat HTML Kode. HTML disalin langsung ke dalam node dengan placeholder mustache.
- Tipe Data Dokumen adalah JSONTipe Input Data Dokumen adalah Teks, dan sebuah ekspresi memetakan daftar prospek kampanye ke dalam sebuah JSON susunan.
- Tipe Output adalah HTMLNode tersebut mengembalikan satu HTML berkas per prospek.
- Node Write Binary File menyimpan setiap file yang dihasilkan. HTML ke folder web publik; node lain mengirimkan tautan yang dipersonalisasi ke setiap prospek.
- Pemicu Jadwal harian mengambil angka KPI dari PostgreSQL.
- Node Set mengelompokkan baris berdasarkan wilayah ke dalam sebuah JSON array, satu catatan per wilayah.
- PDF4me Pembuatan Dokumen (Beberapa) dijalankan dengan Tipe File Templat Word, Tipe Output Excel, Tipe Data Dokumen JSON, Tipe Input Data Dokumen: Teks. Nama File Output adalah
laporan_wilayah. - Node tersebut mengembalikan satu file .xlsx per wilayah yang diberi nama.
laporan_wilayah_1.xlsx,laporan_wilayah_2.xlsxdan seterusnya. - Node Microsoft OneDrive mengunggah setiap file ke folder wilayah yang sesuai untuk tim analitik.
Tips Praktis
Lembar Panduan Singkat
| Bidang | Nilai |
|---|---|
| Resource | Generate |
| Operation | Generate Documents (Multiple) |
| Template File Type | Word |
| Output Type | PDF |
| Template File Input Type | Binary Data |
| Template Binary Property | data |
| Document Data Type | JSON |
| Document Data Input Type | Text |
| Document Data Text | (bulk JSON array with multiple records) |
| Output File Name | my_document (optional, becomes prefix) |
| Binary Data Output Name | data |
| Credentials | PDF4me API credential |
Pertanyaan yang Sering Diajukan
Tindakan Terkait
Tugas yang Sama di Platform Lain
POST /api/v2/GenerateDocumentMultiple endpoint. untuk kode backend kustom atau pengujian Postman.