Lewati ke konten utama

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.

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

Diekspor Google Docs templat
Rancang templat Anda di Google Docs, lalu unduh sebagai Microsoft Word (.docx)Sampel templat google-docs.docx adalah sertifikat kursus dengan {{nama}}, {{kursus}}, {{tanggal}}, Dan {{pengajar}}.
JSON data array
Menggunakan 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.
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.

:::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 placeholderCertificate label in templateSample value (google-docs-data.json)
{{name}}Participant nameAlice Johnson
{{course}}Course titleIntro to Automation
{{date}}Completion date2026-03-10
{{instructor}}Instructor nameMr. Smith
Sintaks kumis (ekspor Google Docs)

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

PlaceholderJSON key (google-docs-data.json)XML element (test.xml)CSV column (test.csv)Sample value
{{name}}namenamenameAlice Johnson
{{course}}coursecoursecourseIntro to Automation
{{date}}datedatedate2026-03-10
{{instructor}}instructorinstructorinstructorMr. 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
Melangkahsimpul n8nTujuan
1Pemicu ManualMulai alur kerja sesuai permintaan
2Baca File BinerBanyak google-docs-template.docx menjadi properti biner data
3PDF4me → Buat Dokumen (Tunggal)Menggabungkan templat + JSON array, output PDF atau Word
4Tulis File Biner atau Kirim Email (opsional)Menyimpan atau mengirim generated_document_output.pdf
Menu tarik-turun Tipe File Templat di node n8n PDF4me Hasilkan Dokumen (Tunggal) menampilkan Google Docs di antara pilihan Word, HTML, Formulir PDF, dan Penggabungan Surat.

Mengatur Jenis File Templat ke Google Docs. Memilih PDF atau Word untuk Jenis Keluaran.


Langkah 1: Unduh dan Tempatkan File Contoh

  1. Unduh google-docs-template.docx Dan google-docs-data.json dari Paket File Sampel di atas.
  2. Simpan templatnya di suatu tempat. n8n dapat membacanya (jalur lokal pada hosting sendiri, atau penyimpanan cloud untuk pemicu produksi).
  3. Unduh secara opsional test.xml atau test.csv untuk 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

  1. Di dalam n8n, buat alur kerja baru.
  2. Tambahkan Pemicu Manual simpul.
  3. Tambahkan Baca File Biner simpul setelah pemicu.
  4. Menambahkan PDF4me → Buat Dokumen (Tunggal) Setelah membaca berkas biner.
  5. 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:

BidangNilai
Jalur FileJalur lengkap ke unduhan Anda google-docs-template.docx
Nama Propertidata (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

BidangNilaiCatatan
Kredensial untuk terhubung denganMilikmu PDF4me kredensialMendapatkan API kunci
SumberGenerate
Menghasilkan OperasiBuat Dokumen (Tunggal)
Jenis File TemplatGoogle DocsDiekspor Google Docs .docx dengan tanda kumis
Jenis KeluaranPDF atau WordPDF untuk dibagikan; Word jika penerima harus mengedit dokumen yang digabungkan

Input templat (dari Baca File Biner)

BidangNilai
Tipe Input File TemplatBinary Data
Properti Biner Templatdata
Nama File Templatgoogle-docs-template.docx

Data dokumen (tempel array JSON dari google-docs-data.json)

BidangNilai
Jenis Input Data DokumenTeks
Jenis Data DokumenJSON
Teks Data DokumenSalin 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

BidangNilai
Pertahankan agar PDF dapat diedit.Nonaktif (default) ketika Tipe Output adalah PDF
Nama Keluaran Data Binerdata (bawaan)

Langkah 5: Jalankan dan Verifikasi Hasilnya

  1. Klik Jalankan alur kerja.
  2. Buka PDF4me keluaran node. Di bawah Binerproperti terbuka data (generated_document_output.pdf atau .docx).
  3. 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:

BidangNilai
Nama Filecertificate-output.pdf
Nama Properti Datadata
Jalur KeluaranFolder 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)

  1. Menambahkan Baca File Biner untuk google-docs-data.json (gunakan sebuah Menggabungkan (node jika template dan data berbagi item alur kerja).
  2. 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:

BidangNilai
Tipe Input File TemplatURL
URL File TemplatTautan publik ke google-docs-template.docx
Nama File Templatgoogle-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.
Baris Google Sheets ke sertifikat
  1. Sheets akan aktif saat baris baru selesai dibuat.
  2. Kode node membungkus baris di dalam JSON array: [{"nama": "...", "kursus": "...", ...}].
  3. PDF4me Google Docs dengan tetap templat google-docs.docx dari biner atau URL.
  4. Kirim email yang telah digabungkan PDF kepada peserta.
Pemicu folder Dropbox
  1. Baru JSON Berkas masuk ke dalam folder yang dipantau.
  2. Muat yang tetap Google Docs templat dari folder yang sama atau URL.
  3. Lewatkan isi file sebagai Data Dokumen (Binary Data atau Teks).
  4. Unggah output PDF ke folder Output. Lihat Zapier blog pemicu untuk pola yang serupa.
Sertifikat massal (banyak baris)
  1. Peserta ekspor sebagai JSON array (satu objek per orang).
  2. Beralih ke Buat Dokumen (Beberapa) untuk satu PDF per baris.
  3. Pertahankan opsi Hasilkan Dokumen (Tunggal) jika Anda hanya membutuhkan satu file gabungan per proses.

Pertanyaan yang Sering Diajukan

How is Google Docs different from PDF4me Word Template?+
Google Docs templates are .docx files exported from Google Docs with mustache {{field}} placeholders. PDF4me Word Template uses <<[fieldName]>> LINQ syntax in a native Word .docx. Both accept PDF or Word output, but the placeholder syntax and Template File Type differ.
Do I upload the Google Doc directly?+
No. Export the Google Doc as Microsoft Word (.docx) first, then load that file in n8n as Binary Data or via URL. PDF4me reads the exported .docx, not a live Google Docs link.
Why must JSON be an array?+
Google Docs template data follows the same array pattern as Mail Merge. Generate Document (Single) uses the first row when you pass one object. Generate Documents (Multiple) processes every row and returns multiple output files.
Why is a placeholder blank?+
JSON keys must match mustache tag names exactly, including case. name works; Name or full_name usually does not. Open the exported .docx in Word and search for {{ to list every tag.
PDF or Word output?+
Choose PDF for emailing, archiving, or printing certificates. Choose Word when the recipient needs to edit the merged document after generation.

Panduan Terkait