Ana içeriğe geç

Doldurun PDF Formda n8n

Bu düğüm ne işe yarıyor?

PDF4me: Doldurun PDF Biçim doldurulabilir bir alan PDF (AcroForm) ve alanlarını verilerinizle tek seferde doldurur. n8n Adım. Şablonu şu şekilde sağlayın: Binary Data, Base64, veya URL ve alan değerleri olarak JSON nesne (JSON Dize, İkili veya Base64) veya olarak Alan Adı / Alan Değeri satırlarıTamamlanmış bir sonuç döndürür. PDFDüzleştirilmiş (varsayılan) veya düzenlenebilir alanlar korunmuş halde. Başvuru formlarını, sözleşmeleri, giriş formlarını veya herhangi bir belgeyi doldurmak için idealdir. AcroForm şablonundan CRMWebhook veya elektronik tablo verileri.

İlgili Blog Yazıları(1)

Kimliğinizi Doğrulama API Rica etmek

Her PDF4me düğümde n8n geçerli bir belge gerektirir Bağlantı kurmak için kimlik bilgisi. İçeriğinizi barındıran birini oluşturun veya seçin. PDF4me API Bu sayede iş akışı, form doldurma isteklerini güvenli bir şekilde doğrulayabilir.

Kaçırmamanız Gereken Önemli Bilgiler

O PDF zaten sahip olmalı AcroForm alanlar
Bu düğme mevcut form alanlarını doldurur, yeni alan oluşturmaz. Alan içermeyen düz bir tarama formu doldurulamaz. Bunun için "Form Alanları Ekle" seçeneğini kullanın. PDF Öncelikle şablonunuzda yalnızca görsel yer tutucular olup olmadığını kontrol edin.
Anahtarlar birbirine uymalıdır. AcroForm alan adları tam olarak
Alan adları büyük/küçük harf duyarlıdır ve genellikle görünür etiketlerden farklıdır (ilk adı yerine İlk adı). Form Verilerini Çıkarma İşlemini Çalıştır PDF Öncelikle şablon üzerinde inceleme yapın veya Adobe Acrobat Prepare Form ile kontrol ederek tam listeyi alın.
Form Verileri (JSON) tek bir nesne bekliyor, liste değil.
Tek bir tane gönder JSON nesne ({"firstname":"John","lastname":"Doe"}Tek bir nesne içeren bir dizi açılır; birden fazla nesne içeren diziler reddedilir. PDFTek seferde çalıştırmak için bu düğümü Öğeler Üzerinde Döngü içine alın.
PDF Formu Doldurma n8n düğümü, Pdf4me ile bağlantı kurmak için Kimlik Bilgisi ile yapılandırılmıştır, Kaynak Formları, Form İşlemleri PDF Formu Doldurma, PDF Giriş Veri Türü İkili Veri, PDF İkili Alan verisi, Giriş Türü Giriş Formu Verisi Seçimi, Alan Adı Adı değeri shakti ve Alan Adı Soyadı değeri Karmakar olan iki örnek Form Alanı ve ayrıca bir Form Alanı Ekle düğmesi

Tam düğüm paneli: PDF şablon aracılığıyla Binary Data + Giriş Formu Veri alanı satırları

Parametreler

Gereklidir n8n UI: Bağlantı kurmak için kimlik bilgisi, PDF Giriş Veri Türü, Seçim Giriş Türü ve (Seçim Giriş Türüne bağlı olarak) eşleşen içerik alanı ile birlikte Form Veri Giriş Türü veya Alan Adı ve Alan Değeri içeren en az bir Form Alanı satırı. Çıkış Dosya Adı (varsayılan) doldurulmuş_form_çıktısı.pdf), Kale PDF Düzenlenebilir (kapalı) ve Binary Data Çıktı Adı (varsayılan) veri) isteğe bağlıdır. Koşullu şablon alanları (PDF İkili Alan, PDF Base64 İçerik, PDF URLBu simgeler yalnızca giriş türü seçildiğinde görünür.

ParametreGerekliNe işe yarar?Örnek
PDF Input Data TypeYesHow the PDF template enters the node. Binary Data reads from a previous node (default, most common). Base64 String accepts an encoded PDF. URL downloads the PDF from a public link.Binary Data
PDF Binary FieldConditionalName of the binary property on the incoming n8n item that holds the PDF. Required when PDF Input Data Type is Binary Data. Defaults to data.data
PDF Base64 ContentConditionalBase64-encoded PDF content. Required when PDF Input Data Type is Base64 String. Data-URL prefixes (data:application/pdf;base64,) are stripped automatically.JVBERi0xLjQK...
PDF URLConditionalPublicly reachable HTTPS URL to the PDF template. Required when PDF Input Data Type is URL. Must be a valid full URL format.https://example.com/application-form.pdf
Select Input TypeYesHow the field values are supplied. JSON sends a stringified JSON object via dataArray. Input Form Data adds one UI row per field with Field Name and Field Value.JSON
Form Data Input TypeConditionalHow the JSON object is supplied. Required when Select Input Type is JSON. JSON String pastes the object directly (default). Binary Data reads a JSON file from a previous node. Base64 String accepts an encoded JSON object.JSON String
Form Data (JSON)ConditionalRaw JSON object whose keys are PDF field names and values are what to fill. Required when Form Data Input Type is JSON String. Must be a single object, not a list.{"firstname":"John","lastname":"Doe","email":"[email protected]"}
Form Data Binary FieldConditionalName of the binary property on the incoming n8n item that holds the JSON data file. Required when Form Data Input Type is Binary Data. Defaults to data.data
Form Data Base64 ContentConditionalBase64-encoded UTF-8 JSON object. Required when Form Data Input Type is Base64 String. Decoded then stringified into dataArray.eyJmaXJzdG5hbWUiOiJKb2huIn0=
Form FieldsConditionalCollection of field rows. Required when Select Input Type is Input Form Data. Add at least one row via Add Form Field. The node errors if the list is empty.[{Field Name: firstname, Field Value: John}]
Field Name (per row)ConditionalExact AcroForm field name to fill. Required for every row added to Form Fields.firstname
Field Value (per row)ConditionalValue to fill into the matching AcroForm field. Required for every row added to Form Fields.John
Output File NameNoFilename of the filled PDF returned by the node. Default is filled_form_output.pdf. Include the .pdf extension.filled_form_output.pdf
Keep PDF EditableNoToggle to keep AcroForm fields editable on the filled PDF. Off (default) flattens the form into static text. On preserves field definitions so the recipient can re-edit.Off
Binary Data Output NameNoName of the binary property the output item exposes. Default is data. Use a different name when a downstream node expects it.data

PDF Giriş Veri Türü Seçenekleri

Nasıl seçeceğiniz PDF Şablon düğüme girer. Bu seçimle birlikte takip eden alanlar değişir.

n8n PDF4me PDF Formunu Doldur düğümündeki PDF Giriş Veri Türü açılır menüsünde üç seçenek gösteriliyor: İkili Veri (açıklama ile vurgulanmış): Önceki düğümden PDF dosyasını kullan; Base64 Dize (açıklama ile): PDF içeriğini base64 kodlu dize olarak sağla; URL (açıklama ile): PDF dosyasına URL sağla

PDF Giriş Veri Türü: Binary Data, Base64 Dize veya URL

İkili VeriVarsayılan: PDF önceki düğümden
Okur PDF Google Drive İndirme gibi önceki bir düğümden doğrudan, HTTP İkili Dosya İsteği veya Okuma. Ayarla PDF İkili Alanı ikili alan adına (varsayılan) veri).
Base64 DizisiPDF bir base64 dizesi olarak
Base64 dizesini yapıştırın veya eşleştirin. PDF Base64 İçeriği. Veri-URL stil önekleri (veri:uygulama/pdf;base64,) otomatik olarak kaldırılır.
URLHerkese açık bağlantıdan indir
Tam bir bilgi sağlayın. HTTPS URL içinde PDF URL. PDF4me Şablonu doğrudan getirir. URL Geçerli ve kimlik doğrulaması gerektirmeden erişilebilir olmalıdır.

Giriş Türü Seçeneklerini Seçin

Alan değerlerinin nasıl sağlanacağını seçin. Bu seçime bağlı olarak sonraki alanlar değişir.

n8n PDF4me PDF Formunu Doldur düğümündeki Giriş Türü açılır menüsünde iki seçenek gösteriliyor: Açıklaması "Form verilerini dataArray'de dizgeleştirilmiş bir JSON nesnesi olarak gönder" olan JSON ve açıklaması "Form verilerini alan adı-değer çiftlerinden oluşan bir dizi olarak gönder" olan, vurgulanmış Giriş Formu Verileri.

Giriş Türünü Seçin: JSON (dataArray için) veya Giriş Formu Verileri (UI satırlar)

JSONÇeşitli alanlar ve dinamik veriler için en iyisi.
Tek bir metin dizisi gönderir. JSON nesne aracılığıyla API veri dizisi alan. Anahtarlar şunlardır: PDF Alan adları ve değerleri doldurulacak olanlardır. Takip eden bir Form Veri Giriş Türü seçeneği ekleyin (JSON Sicim, Binary Data, veya Base64 Nesneyi sağlamak için (Dize) kullanın.
Giriş Formu VerileriKüçük, sabit kurulumlu setler için en uygunudur. UI
Her alana bir satır ekle Form Alanı EkleHer satırda bir tane bulunur. Alan Adı (bire bir aynı AcroForm isim) ve Alan DeğeriListe boşsa düğüm hata verir.

Form Veri Giriş Türü Seçenekleri (Giriş Türü Seçildiğinde) JSON)

n8n PDF4me'de PDF Formunu Doldur düğümünde, Giriş Türü Seçildiğinde JSON seçeneği belirlendiğinde, Form Veri Giriş Türü açılır menüsü üç seçenek gösterir: Açıklaması "JSON içeriğini metin veya nesne olarak sağlayın" olan vurgulanmış JSON Dizesi, açıklaması "Önceki düğümden JSON dosyasını kullanın" olan İkili Veri, açıklaması "JSON içeriğini base64 kodlu dize olarak sağlayın" olan Base64 Dizesi

Form Veri Giriş Türü: JSON Sicim, Binary Data, veya Base64 Sicim

JSON DizisiVarsayılan: yapıştır veya harita JSON Çizgide
Nesneyi doğrudan yazın. Form Verileri (JSON) veya önceki bir düğüm ifadesinden eşleyin. En yaygın tercih edilen yöntem şudur: CRM-odaklı veya webhook odaklı iş akışları.
İkili VeriJSON önceki düğümden gelen dosya
Ayarlamak Form Verisi İkili Alanı ikili alan adına (varsayılan) veriBunu şu durumlarda kullanın: JSON İndirilen bir dosya olarak gelir. Dosya tek bir nesne içermelidir.
Base64 DizisiBase64-kodlanmış JSON nesne
Sağlayın UTF-8 JSON nesneyi base64 olarak Form Veritabanı Base64 İçeriğiDüğüm bunu çözer ve dizgeleştirir. veri dizisi.

Form Verileri (JSON) örneği

Ne zaman Form Data Input Type dır JSON Dize, anahtarları tam olarak aynı olan tek bir nesneyi yapıştırın. AcroForm Alan adları.

Form Veri Giriş Türü, JSON Dizesi olarak ayarlanmış olup, Form Veri (JSON) düzenleyicisinde tek satırlık bir JSON nesnesi gösterilmektedir: firstname John lastname Doe email john at example dot com, ardından Çıktı Dosya Adı filled_form_output.pdf

JSON Dize girişi: tek bir nesne, anahtarlar eşleşiyor AcroForm alan adları tam olarak

{
"firstname": "John",
"lastname": "Doe",
"email": "[email protected]"
}

Çıkış Alanları

Başarılı bir koşu bir getiri sağlar. n8n eşya taşıma JSON meta veriler ve doldurulmuş PDF.

AlanTipİçeriğinde neler var?
successBooleanTrue when the PDF was filled successfully. Use to route error-handling branches.
messageStringHuman-readable status confirming success or describing an error.
fileNameStringFilename of the filled PDF, set from Output File Name (default filled_form_output.pdf).
mimeTypeStringMIME type of the filled file, application/pdf.
fileSizeNumberSize of the filled PDF in bytes.
inputModeStringWhich input mode was used: json or inputFormData.
fieldCountNumberHow many form fields were sent in this request.
Binary (data)BinaryThe filled PDF under Binary Data Output Name (default data). Pass into Write Binary File, Email, or any cloud-storage upload.

Hızlı Kurulum

  1. Eklemek PDF4me senin n8n İş akışı. Ayarla Kaynak ile Formlar Ve Form İşlemleri ile Doldurun PDF Biçim.
  2. İçinde Bağlantı kurmak için kimlik bilgisi, sizinkini seçin PDF4me kimlik bilgileri veya tıklayın Yeni Kimlik Bilgisi Oluştur ve yapıştırın API anahtar.
  3. Ayarlamak PDF Giriş Veri Türü ile Binary Data (varsayılan), Base64 Sicim, veya URL ve uygun alanı doldurun (PDF İkili Alanı, PDF Base64 İçeriği, veya PDF URL).
  4. Ayarlamak Giriş Türünü Seçin ile JSON (sonra seçin) Form Veri Giriş Türü = JSON Sicim / Binary Data / Base64 Dizeyi ve nesneyi sağlayın) veya Giriş Formu Verileri (tıklamak Form Alanı Ekle ve her alana bir satır ekleyin Alan Adı Ve Alan Değeri).
  5. Her şeyin doğru olduğundan emin olun. Alan Adı bir maç AcroForm Şablondaki alan adını tam olarak (büyük/küçük harf duyarlı) yazın. Form Verilerini Şuradan Çıkar seçeneğini kullanın: PDF Önce emin değilseniz sorun.
  6. İsteğe bağlı olarak değiştirin Çıktı Dosya Adı varsayılandan filled_form_output.pdf.
  7. Açma/Kapama Kale PDF Düzenlenebilir Yalnızca alıcının doldurulmuş alanları yeniden düzenleyebilmesi gerekiyorsa etkinleştirin. Varsayılan olarak kapalı seçeneği, formu düzleştirir.
  8. Ayrılmak Binary Data Çıktı Adı gibi data Alt düğümün farklı bir özellik adına ihtiyacı olmadığı sürece. Düğümü çalıştırın ve doldurulmuş olanı yönlendirin. PDF İkili dosya yazma, e-posta gönderme veya bulut depolama alanına kaydetme.

Tipik Kurulumlar

İş Akışı ÖrnekleriCommon n8n workflow patterns using Fill a PDF Form.
Dosya. Doldur. Kaydet: PDF Drive'dan alınan şablon, değerler satır içi.
  1. Google Drive İndirme düğümü, başvuru formunu indirir. PDF şablon (Binary Data, mülk veri).
  2. PDF4me Doldurun PDF Form şu şekilde çalışır: PDF Giriş Veri Türü Binary DataGiriş Türünü Seçin JSONForm Veri Giriş Türü JSON Sicim. Form Verileri (JSON) Tek satır içi bir nesnedir.
  3. Bir İkili Dosya Yazma düğümü, doldurulmuş dosyayı kaydeder. PDF ağ klasörüne kullanarak $json.fileName.
Önceki düğümden gelen değerler ifadelerle eşleştirildi.
  1. Webhook, bir web sitesinden form gönderimi verisi alır.
  2. PDF4me Doldurun PDF Form, Giriş Türü Seçimi ile yapılandırılmıştır. JSONForm Veri Giriş Türü JSON Sicim. Form Verileri (JSON) bir n8n Webhook yükünü doğrudan eşleyen ifade AcroForm saha şekli ({{ { firstname: $json.first, lastname: $json.last } }).
  3. Bir Gmail düğümü, doldurulmuş bilgileri e-postayla gönderir. PDF Ek olarak gönderene geri gönderilecektir.
Az sayıda alan, yok JSON: Giriş Formu Veri satırları
  1. Başvuru formunda yalnızca üç madde bulunur. AcroForm alanlar: ilk adı, soy isim, e-posta.
  2. PDF4me Doldurun PDF Form, "Giriş Türü Seç" ve "Giriş Formu Verileri" seçenekleriyle ayarlanmıştır. Üç satır şu şekilde eklenir: Form Alanı Ekle Alan adları ve girilen veya ifade eşlemesi yapılan değerler tam olarak belirtilmelidir.
  3. Kale PDF Düzenlenebilir özelliği kapalı olduğundan doldurulmuş form düzleştirilir.
  4. O PDF bir yere yükleniyor SharePoint Belge kütüphanesi.
PDF Ve JSON ayrı dosyalar olarak, birleştirildi n8n
  1. Bir düğüm indiriyor PDF Şablon; başka bir düğüm şablonu indirir. JSON Veri dosyası. Bir Birleştirme düğümü bunları tek bir öğede birleştirir.
  2. PDF4me Doldurun PDF Form şu şekilde yapılandırılmıştır: PDF Giriş Veri Türü Binary Data (PDF İkili Alanı ayarlandı PDF alan adı) ve Giriş Türünü Seçin JSONForm Veri Giriş Türü Binary Data (Form Verisi İkili Alanı ayarlandı JSON alan adı).
  3. Doldurulmuş PDF siparişle birlikte kaydedilir ID dosya adı olarak.
Düzenlenebilir doldurulmuş PDF alıcının tamamlaması için
  1. A CRM Yeni bir müşteri oluşturulduğunda güncelleme işlemi iş akışını başlatır.
  2. PDF4me Doldurun PDF Form, müşteri tarafından bilinen alanları bir kayıt formunda önceden doldurur (isim, e-posta, hesap_kimliği) Giriş Türü Seç'i kullanarak JSON.
  3. Kale PDF Düzenlenebilir Bu özellik etkinleştirilir, böylece müşteri kalan isteğe bağlı alanları doldurabilir.
  4. Bir Outlook Düğüm, önceden doldurulmuş düzenlenebilir e-postaları gönderir. PDF Son teslim tarihi hatırlatıcısıyla birlikte.

Pratik İpuçları

Wrong field names are the #1 cause of empty output
Run Extract Form Data From PDF on the template first to get the exact list. Names are case-sensitive and usually have no spaces (firstname, not First Name).
"No binary data found" errors
Double-check PDF Binary Field and Form Data Binary Field names. The Merge node in a fan-in workflow can rename binary properties.
Prefer JSON for many or dynamic fields
Input Form Data is great for 2-3 hardcoded fields, but JSON scales better and works naturally with expressions from previous nodes.
Keep PDF Editable only when needed
Default off flattens the form, which is the right choice when the filled PDF is a final record. Turn on only when the recipient needs to add or change values.
Form Data (JSON) is one object only
Send a single object, not an array of records. An array of one is unwrapped; multiple objects fail. To fill many PDFs in one run, wrap this node in Loop Over Items.
No AcroForm fields means nothing to fill
A flat scan with no fields cannot be filled. Use Add Form Fields To PDF first to add fillable fields before calling Fill a PDF Form.

Kopya Kağıdı

AlanDeğer
ResourceForms
OperationFill a PDF Form
PDF Input Data TypeBinary Data
PDF Binary Fielddata
Select Input TypeJSON
Form Data Input TypeJSON String
Form Data (JSON){"firstname":"John","lastname":"Doe","email":"[email protected]"}
Output File Namefilled_form_output.pdf
Keep PDF EditableOff
Binary Data Output Namedata
CredentialsPDF4me API credential

Sıkça Sorulan Sorular

What is the difference between JSON and Input Form Data?+
JSON sends one stringified object via the API dataArray field. Keys are PDF field names and values are what to fill. Best for many fields, dynamic data mapped from previous nodes, or workflows that already produce JSON. Input Form Data adds one UI row per field with Field Name and Field Value. Best for a small fixed set of fields configured manually in the n8n editor.
How do I know the exact AcroForm field names?+
Run PDF4me Extract Form Data From PDF on the template first. The output is the exact list of field names you can use as keys in Form Data (JSON) or as Field Name rows in Input Form Data. Or inspect the PDF in Adobe Acrobat (Prepare Form) and read the field names from the properties panel. Field names are case-sensitive.
What does Keep PDF Editable do?+
Off (default) flattens the form into static text in the output PDF. Useful when the filled PDF is a final, locked record of what was submitted. On preserves AcroForm field definitions in the output so the recipient can re-edit values in any PDF viewer. Turn it on only when the recipient needs to add or change values after automation.
Can I send an array of multiple objects in Form Data (JSON)?+
No. The node expects a single object. An array containing one object is unwrapped automatically as a convenience. Arrays of multiple objects are rejected. To fill many PDFs in one execution, wrap this node in a Loop Over Items and call it once per object.
Why are some fields blank in the output PDF?+
Almost always because the keys you sent did not match the AcroForm field names exactly. Field names are case-sensitive and often have no spaces or capital letters (firstname instead of First Name). Confirm the exact names with Extract Form Data From PDF before mapping your data.
What happens with a flat PDF that has no form fields?+
Nothing fills. This node populates existing AcroForm fields; it does not create them. For a flat scan or a PDF with visual placeholders only, run Add Form Fields To PDF first to add fillable fields, then call Fill a PDF Form.
How do I send the PDF as base64 with a data: prefix?+
The node strips data-URL prefixes (data:application/pdf;base64,) automatically when you paste them into PDF Base64 Content, so it works either way.
Can I get a non-PDF output (e.g. PNG of the filled form)?+
No. This endpoint outputs PDF only. To rasterize the filled PDF into PNG or JPEG, chain a downstream PDF4me Convert PDF to Image action after Fill a PDF Form.

İlgili Eylemler

Diğer Platformlarda Aynı Görev

Yardım Alın