Google Docs
Apa yang dibahas dalam panduan ini?
Panduan ini akan memandu Anda melalui proses penggabungan. Google Docs diekspor .docx templat di dalam n8n menggunakan templat google-docs.docx Dan google-docs-data.jsonTemplat ini menggunakan... tempat penampung kumis ({{nama}}, {{kursus}}, dll.). Data adalah sebuah JSON susunan dengan satu objek per baris. Untuk Menghasilkan Dokumen (Tunggal), gunakan satu objek dalam array. Outputnya bisa berupa PDF atau Word.
Sebelum Anda Mulai
templat google-docs.docx adalah sertifikat kursus dengan {{nama}}, {{kursus}}, {{tanggal}}, Dan {{pengajar}}.google-docs-data.json (direkomendasikan), test.xml, atau test.csvSeperti Mail Merge, Google Docs data adalah sebuah susunan objekUntuk satu sertifikat, tempelkan array dengan satu objek.:::catatan Google Docs vs jenis templat Word lainnya
Google Docs adalah untuk .docx berkas yang diekspor dari Google Docs dengan kumis {{bidang}} tempat penampung. PDF4me Word Templat menggunakan <<[fieldName]>> Sintaks LINQ. Penggabungan Surat menggunakan klasik Word Kode MERGEFIELD. Pilih tipe yang sesuai dengan cara templat Anda dibuat.
:::
Paket File Sampel
Unduh keempat file di bawah ini. Satu file diekspor. Google Docs templat ditambah tiga format data yang setara.
Apa Isi File Sampel Tersebut?
Placeholder di google-docs-template.docx
Sampel tersebut adalah sebuah sertifikat penyelesaian kursus dengan empat kolom penggabungan kumis:
| Mustache placeholder | Certificate label in template | Sample value (google-docs-data.json) |
|---|---|---|
{{name}} | Participant name | Alice Johnson |
{{course}} | Course title | Intro to Automation |
{{date}} | Completion date | 2026-03-10 |
{{instructor}} | Instructor name | Mr. Smith |
Ketik placeholder langsung di Google Docs sebagai teks biasa, misalnya {{nama}}Setelah diekspor ke .docx, PDF4me mengganti setiap tag dengan yang sesuai JSON kunci. Ini adalah gaya kumis yang sama dengan HTML templat, tetapi format filenya adalah Word, bukan HTML.
Pemetaan bidang di seluruh berkas data
| Placeholder | JSON key (google-docs-data.json) | XML element (test.xml) | CSV column (test.csv) | Sample value |
|---|---|---|---|---|
{{name}} | name | name | name | Alice Johnson |
{{course}} | course | course | course | Intro to Automation |
{{date}} | date | date | date | 2026-03-10 |
{{instructor}} | instructor | instructor | instructor | Mr. Smith |
Tidak seperti PDF4me Word Templat, tidak ada <<[bidang]>> tag. Tidak seperti Mail Merge, tidak ada kode MERGEFIELD. Kunci di JSON objek array dipetakan ke {{bidang}} placeholder satu banding satu.
Alur Kerja Secara Singkat
Manual Trigger → Read Binary File (google-docs-template.docx) → PDF4me Generate Document (Single) → (optional) Write Binary File
| Melangkah | simpul n8n | Tujuan |
|---|---|---|
| 1 | Pemicu Manual | Mulai alur kerja sesuai permintaan |
| 2 | Baca File Biner | Banyak google-docs-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)
Mengatur Jenis File Templat ke Google Docs. Memilih PDF atau Word untuk Jenis Keluaran.
Langkah 1: Unduh dan Tempatkan File Contoh
- Unduh
google-docs-template.docxDangoogle-docs-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.
Untuk menggunakan Google Doc Anda sendiri: buka di Google Docs, memilih Berkas → Unduh → Microsoft Word (.docx), dan gunakan file tersebut sebagai templat Anda.
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 HTML. Untuk Google Docs, menggunakan Binary Data, Base64 Rangkaian, atau URL.
:::
Langkah 3: Muat Templat (Read Binary File)
Konfigurasikan Baca File Biner simpul:
| Bidang | Nilai |
|---|---|
| Jalur File | Jalur lengkap ke unduhan Anda google-docs-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 google-docs-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 | Google Docs | Diekspor Google Docs .docx dengan tanda kumis |
| 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 | Binary Data |
| Properti Biner Templat | data |
| Nama File Templat | google-docs-template.docx |
Data dokumen (tempel array JSON dari google-docs-data.json)
| Bidang | Nilai |
|---|---|
| Jenis Input Data Dokumen | Teks |
| Jenis Data Dokumen | JSON |
| Teks Data Dokumen | Salin seluruh isi dari google-docs-data.json (lihat blok di bawah) |
[
{
"name": "Alice Johnson",
"course": "Intro to Automation",
"date": "2026-03-10",
"instructor": "Mr. Smith"
}
]
:::penting JSON harus berupa array Google Docs data templat adalah JSON susunan, bahkan untuk satu sertifikat saja. Satu objek dalam array menghasilkan satu dokumen gabungan dengan Generate Document (Single).
:::
Opsi keluaran
| Bidang | Nilai |
|---|---|
| Pertahankan agar 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). - Pastikan keempat kolom yang tersedia telah terisi:
- nama → Alice Johnson
- kursus → Pengantar Otomasi
- tanggal → 2026-03-10
- pengajar → Tuan Smith
Jika suatu kolom kosong, bandingkan dengan milik Anda. JSON kunci dengan tag kumis di ekspor .docx satu per satu.
Langkah 6: Simpan atau Kirim Hasil (Opsional)
Tulis File Biner:
| Bidang | Nilai |
|---|---|
| Nama File | certificate-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: File JSON sebagai biner (google-docs-data.json)
- Menambahkan Baca File Biner untuk
google-docs-data.json(gunakan sebuah Menggabungkan (node jika template dan data berbagi item alur kerja). - Mengatur Jenis Input Data Dokumen ke Binary Data, Jenis Data Dokumen ke JSON, Properti Biner Dokumen ke kolom data Anda, Nama File Data Dokumen ke
google-docs-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 rowData) atau menggabungkan item dari dua node Baca File Biner.
:::
Opsi B: XML (test.xml)
Mengatur Jenis Data Dokumen ke XML lalu tempelkan satu data (file contoh berisi dua data; gunakan data pertama untuk sekali jalankan):
<?xml version="1.0" encoding="UTF-8"?>
<Records>
<Record>
<name>Alice Johnson</name>
<course>Intro to Automation</course>
<date>2026-03-10</date>
<instructor>Mr. Smith</instructor>
</Record>
</Records>
Nama elemen sesuai dengan kunci mustache dan JSON properti.
Opsi C: CSV (test.csv)
Mengatur Jenis Data Dokumen ke CSV lalu tempel (baris header + satu baris data):
name,course,date,instructor
"Alice Johnson","Intro to Automation","2026-03-10","Mr. Smith"
Judul kolom sama persis dengan nama placeholder kumis.
Input Templat Alternatif: URL
Tuan rumah google-docs-template.docx di tempat umum HTTPS URL, lalu atur:
| Bidang | Nilai |
|---|---|
| Tipe Input File Templat | URL |
| URL File Templat | Tautan publik ke google-docs-template.docx |
| Nama File Templat | google-docs-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 untuk membuat kode dari templat Google Docs di lingkungan produksi.Once the sample test works, replace the Manual Trigger with these patterns.
- Sheets akan aktif saat baris baru selesai dibuat.
- Kode node membungkus baris di dalam JSON array:
[{"nama": "...", "kursus": "...", ...}]. - PDF4me Google Docs dengan tetap
templat google-docs.docxdari biner atau URL. - Kirim email yang telah digabungkan PDF kepada peserta.
- Baru JSON Berkas masuk ke dalam folder yang dipantau.
- Muat yang tetap Google Docs templat dari folder yang sama atau URL.
- Lewatkan isi file sebagai Data Dokumen (Binary Data atau Teks).
- Unggah output PDF ke folder Output. Lihat Zapier blog pemicu untuk pola yang serupa.
- Peserta ekspor 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 Word Templat:
<<[fieldName]>>sintaks alih-alih kumis - Penggabungan Surat: klasik Word Templat MERGEFIELD
- Buat Dokumen (Beberapa): satu file output per baris di Anda JSON susunan
- Google Docs alur kerja (Make): alur manual empat langkah dalam Make