←Buat Dokumen (Tunggal)

Kembali ke panduan utama: semua tipe templat, parameter node, dan kolom keluaran.

PDF4me Templat Word

Apa yang dibahas dalam panduan ini?

Panduan ini akan memandu Anda dalam membuat satu faktur. PDF di dalam n8n menggunakan paket yang disertakan templat.docx Dan data.json paket sampel. Templat Word menggunakan PDF4me <<[fieldName]>> Tag gabung (sintaks LINQ Reporting Engine). Anda memuatnya .docx sebagai data biner, tempel atau muat yang sesuai JSON/XML/CSV, dan menerima satu yang sudah jadi PDF per putaran.

Postingan Blog Terkait

Belum ada postingan blog untuk fitur ini — akan segera hadir.

Sementara itu, jelajahi blog PDF4me untuk menemukan tutorial dan alur kerja di berbagai platform.

Kunjungi blog ini →

Sebelum Anda Mulai

Templat Word dengan tag gabungan

Sampel templat.docx adalah tata letak faktur. Nilai dinamis menggunakan <<[Nomor Faktur]>>, <<[Namaperusahaan1]>>, <<[productName]>>, dan tag serupa. Nama field peka terhadap huruf besar dan kecil dan harus sama persis dengan kunci data Anda.

File data yang cocok

Menggunakan data.json (direkomendasikan), test.xml, atau test.csvKetiganya memiliki nilai faktur yang sama. Pilih salah satu. Jenis Data Dokumen pada node agar sesuai dengan format file yang Anda berikan.

PDF4me kredensial dalam n8n

Buat PDF4me kredensial dalam n8n dan tempelkan milik Anda API kunci. Kunci yang sama berlaku untuk semua PDF4me node di instance Anda.

→ Dapatkan milikmu API kunci

Paket File Sampel

Unduh keempat file di bawah ini. File-file ini dirancang untuk bekerja bersama: satu templat ditambah tiga format data yang setara.

templat.docx

Templat Word Faktur dengan <<[bidang]>> tag

data.json

15 kunci yang cocok dengan tag templat (direkomendasikan)

test.xml

Data faktur yang sama seperti XML

test.csv

Data faktur yang sama seperti CSV (satu baris data)

Apa Isi File Sampel Tersebut?

Tata letak templat (template.docx)

Templat contoh ini terdiri dari satu halaman. faktur dengan label tetap dan kolom penggabungan dinamis:

Bagian dokumen	Label statis (tetap dalam templat)	Tag gabungan (diisi dari data)
Judul	FAKTUR	(statis)
Meta faktur	Faktur #	<<[InvNr]>>
Meta faktur	Jumlah Tagihan	<<[invAmt]>>
Meta faktur	Tanggal Faktur	<<[invDate]>>
Meta faktur	SETELAH #	<<[invPO]>>
Meta faktur	Periode Penagihan	<<[from]>> ke <<[to]>>
Ditagihkan Kepada	DITAGIHKAN KE	<<[companyName1]>>, <<[companyName2]>>, <<[addressline1]>>, <<[addressline2]>>, <<[country]>>
Baris item	Deskripsi / Harga / PPN % / JUMLAH (USD)	<<[productName]>>, <<[price]>>, <<[vat]>>, <<[amount]>>

Sintaks tag gabungan

Templat Word PDF4me gunakan <<[fieldName]>> (kurung siku ganda dengan kurung siku). Ini berbeda dari HTML sintaks kumis ({{fieldName}}). Lihat Panduan Sintaks Templat Word perulangan for, kondisi, dan string format.

Pemetaan bidang di seluruh berkas data

Setiap nilai dinamis dalam templat dipetakan ke sebuah kunci di data.json, sebuah XML elemen di dalam test.xml, atau sebuah CSV kolom di test.csv:

Template tag	JSON key (data.json)	XML element (test.xml)	Sample value
<<[companyName1]>>	companyName1	CompanyName1	Muster AG
<<[companyName2]>>	companyName2	CompanyName2	Hans Muster
<<[addressline1]>>	addressline1	AddressLine1	example street
<<[addressline2]>>	addressline2	AddressLine2	8000 Zürich
<<[country]>>	country	Country	Switzerland
<<[productName]>>	productName	ProductName	PDF4me
<<[price]>>	price	Price	1000
<<[vat]>>	vat	VAT	8.00
<<[amount]>>	amount	Amount	1000
<<[InvNr]>>	InvNr	InvoiceNumber	202311InV
<<[invAmt]>>	invAmt	InvoiceAmount	1000
<<[invDate]>>	invDate	InvoiceDate	2023-11-24
<<[invPO]>>	invPO	PurchaseOrder	1234567
<<[from]>>	from	FromDate	2023-10-24
<<[to]>>	to	ToDate	2023-10-24

Alur Kerja Secara Singkat

Cara tercepat untuk menguji paket sampel adalah n8n:

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

Melangkah	n8n simpul	Tujuan
1	Pemicu Manual	Mulai alur kerja sesuai permintaan
2	Baca File Biner	Banyak template.docx menjadi properti biner data
3	PDF4me → Buat Dokumen (Tunggal)	Menggabungkan templat + data, menghasilkan satu output. PDF
4	Tulis File Biner (opsional)	Simpanan generated_document_output.pdf ke disk

Konfigurasi target: Templat Word dari biner + JSON ditempelkan Teks Data Dokumen + PDF keluaran

---

Langkah 1: Unduh dan Tempatkan File Contoh

1. Unduh template.docx Dan data.json dari Paket File Sampel di atas.
2. Simpan kedua file tersebut di suatu tempat. n8n bisa membacanya, misalnya C:\pdf4me-samples\ pada instance yang dihosting sendiri, atau unggah ke Google Drive / Dropbox jika Anda lebih memilih pemicu berbasis cloud di kemudian hari.
3. Unduh secara opsional test.xml atau test.csv jika Anda ingin menguji XML atau CSV tipe data sebagai pengganti JSON.

---

Langkah 2: Buat n8n Alur kerja

1. Di dalam n8n, buat alur kerja baru.
2. Tambahkan Pemicu Manual node (atau pemicu apa pun yang Anda sukai untuk produksi).
3. Tambahkan Baca File Biner simpul setelah pemicu.
4. Menambahkan PDF4me → Buat Dokumen (Tunggal) Setelah membaca berkas biner.
5. Hubungkan simpul-simpul tersebut secara berurutan.

---

Langkah 3: Muat Templat Word (Read Binary File)

Konfigurasikan Baca File Biner simpul:

Bidang	Nilai
Jalur File	Jalur lengkap ke unduhan Anda template.docx
Nama Properti	data (default; ini menjadi properti biner) PDF4me pembacaan node)

Jalankan node ini sekali dan konfirmasikan bahwa item output menampilkan bidang biner bernama data dengan nama file template.docx.

---

Langkah 4: Konfigurasi PDF4me Buat Dokumen (Tunggal)

Buka PDF4me Buat node dan atur kolom-kolom ini. Nilai-nilai di bawah ini sama persis dengan paket sampel.

Pengaturan inti

Bidang	Nilai	Catatan
Kredensial untuk terhubung dengan	Milikmu PDF4me kredensial	Mendapatkan API kunci
Sumber	Generate
Menghasilkan Operasi	Buat Dokumen (Tunggal)
Jenis File Templat	Templat Word PDF4me	Pertandingan .docx dengan <<[field]>> tag
Jenis Keluaran	PDF	Menggunakan Word jika Anda memerlukan file gabungan yang dapat diedit .docx alih-alih

Input templat (dari Baca File Biner)

Bidang	Nilai
Tipe Input File Templat	Data Biner
Properti Biner Templat	data
Nama File Templat	template.docx

Data dokumen (tempel JSON dari data.json)

Bidang	Nilai
Jenis Input Data Dokumen	Teks
Jenis Data Dokumen	JSON
Teks Data Dokumen	Salin seluruh isi dari data.json (lihat blok di bawah)

{
  "companyName1": "Muster AG",
  "companyName2": "Hans Muster",
  "addressline1": "example street",
  "addressline2": "8000 Zürich",
  "country": "Switzerland",
  "productName": "PDF4me",
  "price": 1000,
  "vat": 8.0,
  "amount": 1000,
  "InvNr": "202311InV",
  "invAmt": 1000,
  "invDate": "2023-11-24",
  "invPO": "1234567",
  "from": "2023-10-24",
  "to": "2023-10-24"
}

Opsi keluaran

Bidang	Nilai
Menyimpan PDF Dapat diedit	Off (default)
Nama Keluaran Data Biner	data (bawaan)

---

Langkah 5: Jalankan dan Verifikasi PDF

1. Klik Jalankan alur kerja (atau lari dari) PDF4me simpul).
2. Buka PDF4me keluaran node. Di bawah Biner, buka file di properti data (nama file) generated_document_output.pdf).
3. Konfirmasikan bahwa faktur yang diterbitkan menunjukkan:
   • Faktur # → 202311InV
   • Ditagihkan Kepada → Muster AG / Hans Muster / jalan contoh / 8000 Zürich / Swiss
   • Item baris → PDF4me, harga 1000, PPN 8.00, jumlah 1000
   • Periode Penagihan → 2023-10-24 ke 2023-10-24

Jika suatu kolom kosong, bandingkan nama tag di template.docx dengan JSON kunci. Keduanya harus sama persis (termasuk huruf besar/kecil): InvNr bukan invNr).

---

Langkah 6: Simpan Hasil (Opsional)

Tambahkan Tulis File Biner simpul setelah PDF4me:

Bidang	Nilai
Nama File	invoice-output.pdf (atau gunakan sebuah ekspresi)
Nama Properti Data	data
Jalur Keluaran	Folder tempat n8n harus menulis file

---

Format Data Alternatif

Sama saja template.docx Berfungsi dengan ketiga file data dalam paket sampel. Hanya yang Jenis Data Dokumen dan perubahan muatan.

Opsi A: JSON berkas sebagai biner (data.json)

1. Tambahkan yang kedua Baca File Biner simpul untuk data.json.
2. Gunakan Menggabungkan Node ini digunakan untuk menggabungkan biner templat dan biner data menjadi satu item (atau menjalankan pemuatan data di cabang terpisah).
3. Di dalam PDF4me: Jenis Input Data Dokumen = Data Biner, Jenis Data Dokumen = JSON, Properti Biner Dokumen = data, Nama File Data Dokumen = data.json.

:::peringatan Bentrok nama properti biner Ketika templat dan data sama-sama menggunakan properti data Pada item yang sama, keduanya akan saling menimpa. Gunakan nama properti yang terpisah (misalnya, template Dan dataFile) atau menggabungkan item dari dua node Baca File Biner.

:::

Opsi B: XML (test.xml)

Mengatur Jenis Data Dokumen ke XML lalu tempelkan isi dari test.xml:

<?xml version="1.0" encoding="UTF-8"?>
<Invoice>
    <CompanyName1>Muster AG</CompanyName1>
    <CompanyName2>Hans Muster</CompanyName2>
    <AddressLine1>example street</AddressLine1>
    <AddressLine2>8000 Zürich</AddressLine2>
    <Country>Switzerland</Country>
    <ProductName>PDF4me</ProductName>
    <Price>1000</Price>
    <VAT>8.00</VAT>
    <Amount>1000</Amount>
    <InvoiceNumber>202311InV</InvoiceNumber>
    <InvoiceAmount>1000</InvoiceAmount>
    <InvoiceDate>2023-11-24</InvoiceDate>
    <PurchaseOrder>1234567</PurchaseOrder>
    <FromDate>2023-10-24</FromDate>
    <ToDate>2023-10-24</ToDate>
</Invoice>

Opsi C: CSV (test.csv)

Mengatur Jenis Data Dokumen ke CSV dan tempelkan CSV isi (baris header + satu baris data):

companyName1,companyName2,addressline1,addressline2,country,productName,price,vat,amount,InvNr,invAmt,invDate,invPO,from,to
"Muster AG","Hans Muster","example street","8000 Zürich","Switzerland","PDF4me",1000,8.00,1000,"202311InV",1000,"2023-11-24","1234567","2023-10-24","2023-10-24"

CSV judul kolom sesuai dengan JSON kunci secara langsung, yang dipetakan ke <<[fieldName]>> tag dalam templat.

---

Pola Alur Kerja Produksi

Cara umum untuk menyediakan templat dan data dalam produksiOnce the sample test works, replace the Manual Trigger and Read Binary File nodes with these patterns.

Pemicu penyimpanan cloud

1. Pemicu Google Drive / Dropbox / OneDrive aktif saat ada file baru.
2. Unduh node pengambilan templat.docx (atau gunakan jalur templat tetap).
3. Membangun JSON di sebuah Kode atau Mengatur simpul dari CRMKolom lembar kerja.
4. PDF4me penggabungan dan keluaran PDF ke email atau penyimpanan.

Webhook dengan dinamis JSON

1. Webhook menerima muatan pesanan/faktur.
2. Templat dimuat sekali dari URL atau penyimpanan biner.
3. Memetakan isi webhook ke Teks Data Dokumen dengan sebuah ekspresi.
4. Kunci harus tetap cocok <<[fieldName]>> tag dalam templat.

Publik URLs untuk templat dan data

1. Tuan rumah templat.docx Dan data.json di depan umum HTTPS URLs.
2. Mengatur Tipe Input File Templat = URL, URL File Templat = tautan templat.
3. Mengatur Jenis Input Data Dokumen = URL, URL File Data Dokumen = tautan data.
4. Tidak diperlukan node unduhan sebelumnya.

Pertanyaan yang Sering Diajukan

What placeholder syntax does PDF4me Word Template use?+

Use <<[fieldName]>> inside your .docx file. This is the PDF4me LINQ Reporting Engine syntax, not HTML mustache {{fieldName}}. For loops use <<foreach [item in items]>> ... <</foreach>>, for conditions use <<if [condition]>> ... <</if>>. See the Word Template Syntax guide for the full reference.

Why is a field blank in the generated PDF?+

The data key must match the template tag exactly, including case. InvNr in the template requires "InvNr" in JSON, not "invoiceNumber" or "invnr". Open template.docx and compare each <<[tag]>> with your data file. Empty values also render as blank without an error.

Can I use data.json as a file instead of pasting JSON?+

Yes. Load data.json with Read Binary File, set Document Data Input Type to Binary Data, Document Data Type to JSON, and point Document Binary Property to the binary field. If the template also uses binary property data, rename one property (e.g. template vs dataFile) or merge items from separate nodes.

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

JSON is the simplest for n8n because keys map directly to <<[fieldName]>> tags (as in data.json). XML (test.xml) uses PascalCase element names that PDF4me binds to the same template fields. CSV (test.csv) uses column headers matching the JSON keys, which is useful when data comes from spreadsheets or exports.

PDF or Word output?+

Set Output Type to PDF for sharing, emailing, or archiving. Set Output Type to Word when the recipient needs to edit the merged document after generation. The sample invoice works with both.

Panduan Terkait

• Gambaran umum pembuatan dokumen (tunggal): semua parameter, kolom keluaran, dan tipe templat
• Sintaks Templat Word: <<[field]>> tag, perulangan, kondisi, pemformatan
• Menghasilkan PDF dari Templat Word di Make: pola sampel yang sama di Make

Back to overviewWord template syntax