PDF Formu
Bu kılavuz neleri kapsıyor?
Bu kılavuz, bir formu doldurma sürecini adım adım açıklıyor. PDF AcroForm şablonu içinde n8n kullanarak şablon.pdf Ve formdata.jsonVeri anahtarları haritası doğrudan form alan adlarına (ilk adı, soy isim(vb.). Çıktı şudur: PDF sadece. Kullanmak Kale PDF Düzenlenebilir Form doldurulduktan sonra alanların düzenlenebilir kalmasını sağlayabilir veya formu düzleştirmek için bu özelliği kapatabilirsiniz.
Başlamadan Önce
şablon.pdf Bu, dört alandan oluşan bir üyelik formu türüdür. JSON Anahtarlar eşleşmelidir. dahili AcroForm adıEkranda görünen etiket değil, isimler büyük/küçük harf duyarlıdır.formdata.json (tavsiye edilen), test.xml, veya test.csvÜçü de aynı dört değeri sağlıyor. PDF Form verileri bir tek düz nesneiç içe değil, HTML Fatura örneği.:::not: PDF Formu ile PDF Formu Doldurmak Arasındaki Fark Belge Oluştur (Tekli) ile PDF Formu Şablon oluşturma motorunu şu şekilde kullanır: PDF Mevcut herhangi bir formu şablon olarak kullanın. PDF AcroForm'u oluşturma iş akışı olmadan nasıl kullanacağınızı öğrenmek için bakınız. Doldurun PDF BiçimBilinmeyen bir alanda alan adlarını keşfetmek için. PDF, koşmak Form Verilerini Çıkarma PDF Önce şablon üzerinde çalışın.
:::
Örnek Dosya Paketi
Aşağıdaki dört dosyayı da indirin. Bir PDF Form şablonu ve üç eşdeğer veri formatı.
Örnek Dosyaların İçeriği
Form alanları template.pdf
Örnek PDF basit bir örnektir. üyelik / kayıt formuHer AcroForm alan adı, verilerinizdeki bir anahtara karşılık gelir:
| AcroForm alan adı | Şablonda tipik kullanım | Örnek değer (formdata.json) |
|---|---|---|
firstname | İsim | John |
lastname | Soyadı | Adams |
gender | Cinsiyet seçimi | Dişi |
member | Üyelik seviyesi | Temel |
:::ipucu Alan adları ve görünür etiketler
AcroForm adları genellikle küçük harfle yazılır ve aralarında boşluk bulunmaz (firstname), hatta PDF "Ad"ı gösterir. Bir değer boş görünüyorsa, anahtarınız JSON Hemen hemen her zaman dahili alan adıyla eşleşmez. Kullanın Form Verilerini Çıkarma PDF Kendi şablonunuzdan tam isimleri listelemek için.
:::
Tüm veri dosyalarında alan eşlemesi
| AcroForm field | JSON key (formdata.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 |
Word'ün aksine veya HTML Şablonlar var. bıyık yer tutucusu yokMotor uyumlu. AcroForm alan adlarına ait veri anahtarları Bire bir.
İş Akışına Genel Bakış
Manual Trigger → Read Binary File (template.pdf) → PDF4me Generate Document (Single) → (optional) Write Binary File
| Adım | n8n düğüm | Amaç |
|---|---|---|
| 1 | Manuel Tetikleyici | İş akışını isteğe bağlı olarak başlatın |
| 2 | İkili Dosyayı Oku | Yükler template.pdf ikili özelliğe data |
| 3 | PDF4me → Belge Oluştur (Tekli) | AcroForm alanlarını şu şekilde doldurur: JSON/XML/CSVçıktılar PDF |
| 4 | İkili Dosya Yaz veya E-posta gönder (isteğe bağlı) | Kaydeder veya gönderir generated_document_output.pdf |
/generate-document-single-template-file-type.png "Büyütmek için tıklayın")
Ayarlamak Şablon Dosya Türü ile PDF Formu. Çıktı Türü dır PDF Sadece bu şablon türü için geçerlidir.
Adım 1: Örnek Dosyaları İndirin ve Yerleştirin
- İndirmek
template.pdfVeformdata.json-den Örnek Dosya Paketi üstünde. - Kaydetmek
template.pdfbir yerlerde n8n (Kendi sunucunuzda barındırdığınız yerel yol veya üretim tetikleyicileri için bulut depolama alanı) okunabilir. - İsteğe bağlı olarak indirin
test.xmlveyatest.csvDiğer veri türlerini test etmek için.
Adım 2: Oluşturun n8n İş Akışı
- İçinde n8nYeni bir iş akışı oluşturun.
- Ekle Manuel Tetikleyici düğüm.
- Ekle İkili Dosyayı Oku Tetikleyiciden sonraki düğüm.
- Eklemek PDF4me → Belge Oluştur (Tekli) İkili dosyayı okuduktan sonra.
- Bağlantınızı kurun. PDF4me kimlik belgesi.
:::Dikkat: HTML kodu burada geçerli değil Şablon Dosyası Giriş Türü: HTML Kod yalnızca şu durumlarda işe yarar Şablon Dosya Türü dır HTMLPDF formu için şunu kullanın: İkili Veri, Base64 Sicim, veya URL.
:::
Adım 3: PDF Şablonunu Yükleyin (Read Binary File)
| Alan | Değer |
|---|---|
| Dosya Yolu | İndirdiğiniz dosyanın tam yolu template.pdf |
| Mülk Adı | data (varsayılan; şu amaçla kullanılır: Şablon İkili Özelliği içinde PDF4me) |
Bu düğümü bir kez çalıştırın ve çıktı öğesinin ikili veri gösterdiğini doğrulayın. data dosya adı ile template.pdf.
Adım 4: Yapılandırma PDF4me Belge Oluştur (Tekli)
Temel ayarlar
| Alan | Değer | Notlar |
|---|---|---|
| Bağlantı kurmak için kimlik bilgisi | Senin PDF4me kimlik belgesi | Elde etmek API anahtar |
| Kaynak | Generate | |
| Operasyonları Oluştur | Belge Oluştur (Tekli) | |
| Şablon Dosya Türü | PDF Formu | PDF AcroForm alanlarıyla |
| Çıktı Türü | Sadece PDF formu seçeneği |
Şablon girişi (İkili Dosyayı Oku bölümünden)
| Alan | Değer |
|---|---|
| Şablon Dosyası Giriş Türü | İkili Veri |
| Şablon İkili Özelliği | data |
| Şablon Dosya Adı | template.pdf |
Belge verileri (JSON'u yapıştırın) formdata.json)
| Alan | Değer |
|---|---|
| Belge Veri Giriş Türü | Metin |
| Belge Veri Türü | JSON |
| Belge Verileri Metni | Lütfen aşağıdaki metnin tamamını yapıştırın. formdata.json (aşağıdaki bloğa bakınız) |
{
"firstname": "John",
"lastname": "Adams",
"gender": "Female",
"member": "Basic"
}
Çıkış seçenekleri
| Alan | Değer | Ne zaman kullanılır? |
|---|---|---|
| Kale PDF Düzenlenebilir | Açık | Alıcı, doldurulmuş formdaki alanları yine de düzenleyebilmelidir. PDF |
| Kale PDF Düzenlenebilir | Kapalı (varsayılan) | Form alanlarını statik içeriğe dönüştürün. |
| İkili Veri Çıkış Adı | data (varsayılan) | Çıktı için ikili özellik PDF |
Adım 5: Çalıştırın ve Doğrulayın PDF
- Tıklamak İş akışını yürüt.
- Açın PDF4me Düğüm çıktısı altında. İkiliaçık mülk
data(generated_document_output.pdf). - Dört alanın da doldurulmuş olduğundan emin olun:
- ilk adı → John
- soy isim → Adams
- cinsiyet → Kadın
- üye → Temel
Eğer herhangi bir alan boşsa, kendi alanınızı karşılaştırın. JSON AcroForm adlarını içeren tuşlar template.pdf Karakter karakter.
Adım 6: Çıktıyı Kaydedin veya Gönderin (İsteğe bağlı)
İkili Dosyayı Yaz:
| Alan | Değer |
|---|---|
| Dosya adı | filled-form-output.pdf |
| Veri Özelliği Adı | data |
| Çıkış Yolu | Hedef klasörünüzde n8n ev sahibi |
E-posta gönder: ikili dosyayı ekle data itibaren PDF4me olarak PDF EK.
Alternatif Veri Biçimleri
Seçenek A: JSON Dosya ikili formatta (formdata.json)
- Eklemek İkili Dosyayı Oku için
formdata.json(kullanın Birleştir Şablon ve verilerin iş akışı öğesini paylaştığı düğüm). - Ayarlamak Belge Veri Giriş Türü ile İkili Veri, Belge Veri Türü ile JSON, Belge İkili Özelliği Veri alanınıza, Belge Veri Dosyası Adı ile
formdata.json.
:::Dikkat İkili özellik adı çakışması
Hem şablon hem de veri aynı özelliği kullanıyorsa dataBiri diğerinin üzerine yazılır. Ayrı isimler kullanın (örneğin, template Ve formData) veya iki İkili Dosya Oku düğümünden öğeleri birleştirin.
:::
B Seçeneği: XML (test.xml)
Ayarlamak Belge Veri Türü ile XML ve yapıştırın:
<?xml version="1.0" encoding="UTF-8"?>
<Person>
<firstname>John</firstname>
<lastname>Adams</lastname>
<gender>Female</gender>
<member>Basic</member>
</Person>
Öğe adları, AcroForm alan adlarıyla eşleşir ve JSON anahtarlar.
C Seçeneği: CSV (test.csv)
Ayarlamak Belge Veri Türü ile CSV ve yapıştırın (başlık satırı + bir veri satırı):
firstname,lastname,gender,member
"John","Adams","Female","Basic"
Sütun başlıkları, AcroForm alan adlarıyla doğrudan eşleşir.
Alternatif Şablon Girişi: URL
Ev sahibi template.pdf halka açık bir yerde HTTPS URLArdından şunu ayarlayın:
| Alan | Değer |
|---|---|
| Şablon Dosyası Giriş Türü | URL |
| Şablon Dosyası URL'si | Herkese açık bağlantı template.pdf |
| Şablon Dosya Adı | template.pdf |
"İkili Dosya Oku" düğümüne gerek yoktur. Veriler yine de yapıştırılabilir. Belge Verileri Metni veya bir yerden yüklendi URL.
Üretim İş Akışı Kalıpları
Üretimde PDF formlarını doldurmanın yaygın yollarıOnce the sample test works, replace the Manual Trigger with these patterns.
- Webhook, kayıt yükünü alır.
- Gövde alanlarını haritaya ekle JSON AcroForm adlarıyla eşleşen anahtarlar.
- PDF4me dolgular sabitlendi
şablon.pdfikiliden veya URL. - Doldurulmuş formu e-posta ile gönderin veya saklayın. PDF.
- Yeni satır eklendiğinde sayfalar tetiklenir.
- Ayarlamak veya Kod düğüm derlemeleri
{"ilk adı": "...", ...}. - PDF4me PDF Form şablonu kullanarak Belge Oluştur (Tekli).
- Çıktıyı Drive'a yükleyin veya SharePoint.
- HubSpot / Salesforce yeni kişi kaydı tetikleyicisi.
- Harita CRM özelliklere
ilk adı,soy isim, vesaire. - Ayarlamak Kale PDF Düzenlenebilir Arşivlemeden önce düzleştirmeye gönderiyorum.
Sıkça Sorulan Sorular
İlgili Kılavuzlar
- Belge Oluştur (Tekli) genel bakış: tüm parametreler, çıktı alanları ve şablon türleri
- Doldurun PDF Biçim: Şablon oluşturma motoru olmadan özel AcroForm doldurma
- Form Verilerini Çıkarma PDF: herhangi bir kaynaktan alan adlarını listele PDF biçim