Penggabungan Surat
Apa yang dibahas dalam panduan ini?
Panduan ini akan memandu Anda melalui proses penggabungan. templat penggabungan surat Word klasik di dalam n8n menggunakan templat_penggabungan_surat_sederhana.docx Dan sample_mail_merge_data.jsonTemplat ini menggunakan Word. MERGEFIELD tempat penampung (tidak <<[bidang]>> atau kumis {{bidang}}). Data adalah sebuah JSON susunan dengan satu objek per penerima. Untuk Menghasilkan Dokumen (Tunggal), gunakan satu baris dalam array. Outputnya bisa berupa PDF atau Word.
Sebelum Anda Mulai
templat_penggabungan_surat_sederhana.docx Dibuat menggunakan fitur penggabungan surat Word (Sisipkan Bidang Gabungan). Nama-nama bidangnya adalah nama depan, nama belakang, jenis kelamin, Dan anggotaMereka harus cocok JSON kunci persisnya.sample_mail_merge_data.json (direkomendasikan), test.xml, atau test.csvData penggabungan surat adalah sebuah susunan objekUntuk satu dokumen, tempelkan array dengan satu objek.:::catatan Penggabungan Surat vs Templat Word PDF4me
Penggabungan Surat Ini untuk dokumen Word yang dibuat dengan bidang penggabungan surat klasik (MERGEFIELD). Templat Word PDF4me menggunakan <<[fieldName]>> Sintaks LINQ dalam bahasa biasa .docxPilih tipe yang sesuai dengan cara pembuatan template Anda. Untuk banyak penerima dalam satu pesan. API panggil, gunakan Buat Dokumen (Beberapa) alih-alih.
:::
Paket File Sampel
Unduh keempat file di bawah ini. Satu templat penggabungan surat Word ditambah tiga format data yang setara.
Apa Isi File Sampel Tersebut?
Gabungkan kolom di simple_mail_merge_template.docx
Contoh ini sederhana. surat keanggotaan dengan empat kolom gabungan Word klasik:
| 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 |
Di Microsoft Word, tekan Alt+F9 untuk mengaktifkan/menonaktifkan kode kolom. Kolom penggabungan surat muncul sebagai { MERGEFIELD firstname } Kode gaya. Nama setelah MERGEFIELD harus sesuai dengan milikmu JSON kunci.
Pemetaan bidang di seluruh berkas data
| 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 |
Tidak seperti PDF4me Word Template, tidak ada <<[bidang]>> tag. Tidak seperti HTMLTidak ada sintaks kumis. Mesin mengikat JSON kunci untuk nama-nama MERGEFIELD di Word satu lawan satu.
Alur Kerja Secara Singkat
Manual Trigger → Read Binary File (simple_mail_merge_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 simple_mail_merge_template.docx menjadi properti biner data |
| 3 | PDF4me → Buat Dokumen (Tunggal) | Menggabungkan templat + JSON array, output PDF atau Word |
| 4 | Tulis File Biner atau Kirim Email (opsional) | Menyimpan atau mengirim generated_document_output.pdf |
/generate-document-single-template-file-type.png "Klik untuk memperbesar")
Mengatur Jenis File Templat ke Penggabungan Surat. Memilih PDF atau Word untuk Jenis Keluaran.
Langkah 1: Unduh dan Tempatkan File Contoh
- Unduh
simple_mail_merge_template.docxDansample_mail_merge_data.jsondari Paket File Sampel di atas. - Simpan templatnya di suatu tempat. n8n dapat membacanya (jalur lokal pada hosting sendiri, atau penyimpanan cloud untuk pemicu produksi).
- Unduh secara opsional
test.xmlatautest.csvuntuk menguji tipe data lainnya.
Langkah 2: Buat n8n Alur kerja
- Di dalam n8n, buat alur kerja baru.
- Tambahkan Pemicu Manual simpul.
- Tambahkan Baca File Biner simpul setelah pemicu.
- Menambahkan PDF4me → Buat Dokumen (Tunggal) Setelah membaca berkas biner.
- Hubungkan milik Anda PDF4me kredensial.
:::peringatan Kode HTML tidak valid di sini Tipe Input File Templat: HTML Kode hanya berfungsi saat Jenis File Templat adalah HTMLUntuk Mail Merge, gunakan Data Biner, Base64 Rangkaian, atau URL.
:::
Langkah 3: Muat Templat Word (Read Binary File)
Konfigurasikan Baca File Biner simpul:
| Bidang | Nilai |
|---|---|
| Jalur File | Jalur lengkap ke unduhan Anda simple_mail_merge_template.docx |
| Nama Properti | data (default; digunakan sebagai Properti Biner Templat di dalam PDF4me) |
Jalankan node ini sekali dan pastikan item output menampilkan biner. data dengan nama file simple_mail_merge_template.docx.
Langkah 4: Konfigurasi PDF4me Buat Dokumen (Tunggal)
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 | Penggabungan Surat | Templat Word klasik MERGEFIELD |
| Jenis Keluaran | PDF atau Word | PDF untuk dibagikan; Word jika penerima harus mengedit dokumen yang digabungkan |
Input templat (dari Baca File Biner)
| Bidang | Nilai |
|---|---|
| Tipe Input File Templat | Data Biner |
| Properti Biner Templat | data |
| Nama File Templat | simple_mail_merge_template.docx |
Data dokumen (tempel array JSON dari sample_mail_merge_data.json)
| Bidang | Nilai |
|---|---|
| Jenis Input Data Dokumen | Teks |
| Jenis Data Dokumen | JSON |
| Teks Data Dokumen | Salin seluruh isi dari sample_mail_merge_data.json (lihat blok di bawah) |
[
{
"firstname": "John",
"lastname": "Adams",
"gender": "Female",
"member": "Basic"
}
]
:::penting JSON harus berupa array Data penggabungan surat adalah JSON susunan, bahkan untuk satu penerima saja. Satu objek dalam array menghasilkan satu dokumen gabungan dengan Generate Document (Single).
:::
Opsi keluaran
| Bidang | Nilai |
|---|---|
| Menyimpan PDF Dapat diedit | Nonaktif (default) ketika Tipe Output adalah PDF |
| Nama Keluaran Data Biner | data (bawaan) |
Langkah 5: Jalankan dan Verifikasi Hasilnya
- Klik Jalankan alur kerja.
- Buka PDF4me keluaran node. Di bawah Binerproperti terbuka
data(generated_document_output.pdfatau.docx). - Konfirmasikan bahwa keempat kolom gabungan (merge field) telah terisi:
- nama depan → John
- nama belakang → Adams
- jenis kelamin → Perempuan
- anggota → Dasar
Jika suatu kolom kosong, bandingkan dengan milik Anda. JSON kunci dengan nama MERGEFIELD di templat Word (Alt+F9 di Word).
Langkah 6: Simpan atau Kirim Hasil (Opsional)
Tulis File Biner:
| Bidang | Nilai |
|---|---|
| Nama File | mail-merge-output.pdf |
| Nama Properti Data | data |
| Jalur Keluaran | Folder target pada Anda n8n tuan rumah |
Kirim Email: lampirkan biner data dari PDF4me sebagai PDF atau Word lampiran.
Format Data Alternatif
Opsi A: JSON berkas sebagai biner (sample_mail_merge_data.json)
- Menambahkan Baca File Biner untuk
sample_mail_merge_data.json(gunakan sebuah Menggabungkan (node jika template dan data berbagi item alur kerja). - Mengatur Jenis Input Data Dokumen ke Data Biner, Jenis Data Dokumen ke JSON, Properti Biner Dokumen ke kolom data Anda, Nama File Data Dokumen ke
sample_mail_merge_data.json.
:::peringatan Bentrok nama properti biner
Jika templat dan data sama-sama menggunakan properti dataJika salah satunya menimpa yang lain, gunakan nama yang berbeda (misalnya, template Dan mergeData) atau menggabungkan item dari dua node Baca File Biner.
:::
Opsi B: XML (test.xml)
Mengatur Jenis Data Dokumen ke XML lalu tempel:
<?xml version="1.0" encoding="UTF-8"?>
<Person>
<firstname>John</firstname>
<lastname>Adams</lastname>
<gender>Female</gender>
<member>Basic</member>
</Person>
Nama elemen sesuai dengan nama kolom gabungan dan kunci JSON.
Opsi C: CSV (test.csv)
Mengatur Jenis Data Dokumen ke CSV lalu tempel (baris header + satu baris data):
firstname,lastname,gender,member
"John","Adams","Female","Basic"
Judul kolom sesuai dengan nama kolom gabungan secara langsung.
Input Templat Alternatif: URL
Tuan rumah simple_mail_merge_template.docx di tempat umum HTTPS URL, lalu atur:
| Bidang | Nilai |
|---|---|
| Tipe Input File Templat | URL |
| URL File Templat | Tautan publik ke simple_mail_merge_template.docx |
| Nama File Templat | simple_mail_merge_template.docx |
Node Read Binary File tidak diperlukan. Data masih dapat disalin dan ditempel. Teks Data Dokumen atau dimuat dari URL.
Pola Alur Kerja Produksi
Cara umum menjalankan mail merge di lingkungan produksiOnce the sample test works, replace the Manual Trigger with these patterns.
- Sheets akan aktif saat baris baru dibuat.
- Kode atau Mengatur node membungkus baris di dalam JSON array:
[{"nama depan": "...", ...}]. - PDF4me Penggabungan Surat dengan tetap
templat_penggabungan_surat_sederhana.docx. - Kirim email yang telah digabungkan PDF kepada penerima.
- Webhook menerima muatan formulir.
- Petakan kolom isi ke kunci gabungan (
nama depan,nama belakang, dll.). - Buat satu item JSON array untuk Teks Data Dokumen.
- Simpan atau kirim hasilnya melalui email. PDF.
- Ekspor kontak sebagai JSON array (satu objek per orang).
- Beralih ke Buat Dokumen (Beberapa) untuk satu PDF per baris.
- Pertahankan opsi Hasilkan Dokumen (Tunggal) jika Anda hanya membutuhkan satu file gabungan per proses.
Pertanyaan yang Sering Diajukan
Panduan Terkait
- Gambaran umum pembuatan dokumen (tunggal): semua parameter, kolom keluaran, dan tipe templat
- PDF4me Templat Word:
<<[fieldName]>>sintaks alih-alih MERGEFIELD - Buat Dokumen (Beberapa): satu file output per baris di Anda JSON susunan
- Blog alur kerja penggabungan surat: pola ujung-ke-ujung dalam Make