Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog
Buat Dokumen (Tunggal)

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

Formulir PDF

Apa yang dibahas dalam panduan ini?

Panduan ini akan memandu Anda dalam mengisi formulir. PDF Templat AcroForm di dalam n8n menggunakan templat.pdf Dan formdata.json. Peta kunci data langsung ke nama kolom formulir (nama depan, nama belakang, dll.). Outputnya adalah PDF hanya. Menggunakan Menyimpan PDF Dapat diedit untuk membiarkan kolom tetap dapat diedit setelah diisi, atau menonaktifkannya untuk meratakan formulir.

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​

PDF dengan kolom AcroForm
Sampel templat.pdf adalah formulir bergaya keanggotaan dengan empat kolom. JSON kunci harus cocok nama AcroForm internal, bukan label yang terlihat di layar. Nama bersifat peka huruf besar-kecil.
Objek data datar
Menggunakan formdata.json (direkomendasikan), test.xml, atau test.csvKetiganya memberikan empat nilai yang sama. Data formulir PDF adalah objek datar tunggal, tidak bersarang seperti HTML Contoh faktur.
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 Formulir PDF vs Mengisi Formulir PDF Buat Dokumen (Tunggal) dengan Formulir PDF menggunakan mesin pembuatan templat dengan PDF formulir sebagai templat. Untuk mengisi formulir yang sudah ada PDF AcroForm tanpa alur kerja pembuatan, lihat Isi PDF MembentukUntuk menemukan nama-nama kolom pada data yang tidak diketahui. PDF, berlari Ekstrak Data Formulir Dari PDF pada templat terlebih dahulu.

:::

Paket File Sampel​

Unduh keempat file di bawah ini. Satu PDF Templat formulir ditambah tiga format data yang setara.

Apa Isi File Sampel Tersebut?​

Kolom formulir di template.pdf​

Contoh PDF ini sederhana. formulir keanggotaan/pendaftaranSetiap nama kolom AcroForm dipetakan ke kunci dalam data Anda:

Nama kolom AcroFormPenggunaan umum dalam templatNilai sampel (formdata.json)
firstnameNama depanJohn
lastnameNama keluargaAdams
genderPemilihan jenis kelaminPerempuan
memberTingkat keanggotaanDasar
Nama kolom vs label yang terlihat

Nama AcroForm sering kali menggunakan huruf kecil tanpa spasi (firstname), bahkan ketika PDF Menampilkan "Nama Depan". Jika nilainya kosong, kunci di JSON hampir selalu tidak sesuai dengan nama kolom internal. Gunakan Ekstrak Data Formulir Dari PDF untuk mencantumkan nama-nama persis dari templat Anda sendiri.

Pemetaan bidang di seluruh berkas data​

AcroForm fieldJSON key (formdata.json)XML element (test.xml)CSV column (test.csv)Sample value
firstnamefirstnamefirstnamefirstnameJohn
lastnamelastnamelastnamelastnameAdams
gendergendergendergenderFemale
membermembermembermemberBasic

Tidak seperti Word atau HTML templat, ada tidak ada placeholder kumisMesinnya cocok kunci data ke nama bidang AcroForm satu lawan satu.

Alur Kerja Secara Singkat​

Manual Trigger  →  Read Binary File (template.pdf)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File
Melangkahn8n simpulTujuan
1Pemicu ManualMulai alur kerja sesuai permintaan
2Baca File BinerBanyak template.pdf menjadi properti biner data
3PDF4me → Buat Dokumen (Tunggal)Mengisi kolom AcroForm dari JSON/XML/CSV, keluaran PDF
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 Formulir PDF di antara pilihan Word, HTML, Mail Merge, dan Google Docs.

Mengatur Jenis File Templat ke Formulir PDF. Jenis Keluaran adalah PDF hanya untuk tipe templat ini.

Langkah 1: Unduh dan Tempatkan File Contoh​

  1. Unduh template.pdf Dan formdata.json dari Paket File Sampel di atas.
  2. Menyimpan template.pdf 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.

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 HTMLUntuk formulir PDF, gunakan Data Biner, Base64 Rangkaian, atau URL.

:::

Langkah 3: Muat Templat PDF (Read Binary File)​

BidangNilai
Jalur FileJalur lengkap ke unduhan Anda template.pdf
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 template.pdf.

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 TemplatFormulir PDFPDF dengan kolom AcroForm
Jenis KeluaranPDFHanya opsi untuk Formulir PDF

Input templat (dari Baca File Biner)​

BidangNilai
Tipe Input File TemplatData Biner
Properti Biner Templatdata
Nama File Templattemplate.pdf

Data dokumen (tempel JSON dari formdata.json)​

BidangNilai
Jenis Input Data DokumenTeks
Jenis Data DokumenJSON
Teks Data DokumenSalin seluruh isi dari formdata.json (lihat blok di bawah)
{
  "firstname": "John",
  "lastname": "Adams",
  "gender": "Female",
  "member": "Basic"
}

Opsi keluaran​

BidangNilaiKapan harus digunakan?
Menyimpan PDF Dapat dieditPadaPenerima tetap dapat mengedit kolom yang telah diisi. PDF
Menyimpan PDF Dapat dieditMati (bawaan)Ubah kolom formulir menjadi konten statis.
Nama Keluaran Data Binerdata (bawaan)Properti biner untuk output PDF

Langkah 5: Jalankan dan Verifikasi PDF​

  1. Klik Jalankan alur kerja.
  2. Buka PDF4me keluaran node. Di bawah Binerproperti terbuka data (generated_document_output.pdf).
  3. Pastikan keempat kolom tersebut telah terisi:
    • nama depan → John
    • nama belakang → Adams
    • jenis kelamin → Perempuan
    • anggota → Dasar

Jika ada kolom yang kosong, bandingkan dengan milik Anda JSON kunci dengan nama AcroForm di template.pdf satu per satu.

Langkah 6: Simpan atau Kirim Hasil (Opsional)​

Tulis File Biner:

BidangNilai
Nama Filefilled-form-output.pdf
Nama Properti Datadata
Jalur KeluaranFolder target pada Anda n8n tuan rumah

Kirim Email: lampirkan biner data dari PDF4me sebagai PDF lampiran.

Format Data Alternatif​

Opsi A: JSON berkas sebagai biner (formdata.json)​

  1. Menambahkan Baca File Biner untuk formdata.json (gunakan sebuah Menggabungkan (node jika template dan data berbagi item alur kerja).
  2. 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 formdata.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 formData) 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 AcroForm dan JSON kunci.

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 bidang AcroForm secara langsung.

Input Templat Alternatif: URL​

Tuan rumah template.pdf di tempat umum HTTPS URL, lalu atur:

BidangNilai
Tipe Input File TemplatURL
URL File TemplatTautan publik ke template.pdf
Nama File Templattemplate.pdf

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 mengisi formulir PDF dalam produksiOnce the sample test works, replace the Manual Trigger with these patterns.
Pengiriman formulir webhook
  1. Webhook menerima payload pendaftaran.
  2. Petakan bidang tubuh ke JSON kunci yang sesuai dengan nama AcroForm.
  3. PDF4me mengisi tetap templat.pdf dari biner atau URL.
  4. Kirim melalui email atau simpan formulir yang telah diisi. PDF.
Baris Google Sheets ke PDF
  1. Sheets akan aktif saat baris baru dibuat.
  2. Mengatur atau Kode pembangunan node {"nama depan": "...", ...}.
  3. PDF4me Buat Dokumen (Tunggal) dengan templat Formulir PDF.
  4. Unggah hasil output ke Drive atau SharePoint.
CRM kontak untuk keanggotaan PDF
  1. Pemicu HubSpot/Salesforce saat kontak baru.
  2. Peta CRM properti untuk nama depan, nama belakang, dll.
  3. Mengatur Menyimpan PDF Dapat diedit Akan diratakan sebelum diarsipkan.

Pertanyaan yang Sering Diajukan​

How is Pdf Form different from Fill a PDF Form?+
Generate Document (Single) with Pdf Form is part of the generate template workflow (same node as Word and HTML). Fill a PDF Form is a dedicated Forms operation for any PDF with AcroForm fields. Both map keys to field names; choose Generate when Pdf Form is your Template File Type in a generate pipeline.
Why are some fields blank in the output?+
JSON keys must match AcroForm field names exactly, including case. firstname works; FirstName or first_name usually does not. Run Extract Form Data From PDF on template.pdf to list internal names before mapping CRM or webhook data.
Should I turn Keep PDF Editable on or off?+
On: fields remain editable (useful for review workflows). Off: fields are flattened into static text (better for final archival or when recipients should not change values). Default is Off.
Can Pdf Form output Word or HTML?+
No. When Template File Type is Pdf Form, Output Type is PDF only.
JSON vs XML vs CSV: which should I use?+
JSON is simplest for n8n expressions and webhooks. XML and CSV in the sample pack use the same four keys. All formats map one value per AcroForm field name.

Panduan Terkait​

Back to overviewFill a PDF Form