Ana kılavuza geri dön: tüm şablon türleri, düğüm parametreleri ve çıktı alanları

PDF4me Word Şablonu

Bu kılavuz neleri kapsıyor?

Bu kılavuz, tek bir fatura oluşturma sürecini adım adım açıklamaktadır. PDF içinde n8n paketlenmiş olanı kullanarak şablon.docx Ve veri.json Örnek paket. Word şablonu şunu kullanır: PDF4me <<[alanAdı]>> Etiketleri birleştirin (LINQ Raporlama Motoru sözdizimi). Yüklediğiniz şey .docx ikili veri olarak, eşleşenleri yapıştırın veya yükleyin. JSON/XML/CSVve bir tane tamamlanmış ürün alacaksınız. PDF Her çalıştırma için.

İlgili Blog Yazıları

Bu özellik için henüz bir blog yazısı yok — yakında yayınlanacak.

Bu arada, her platforma yönelik eğitimler ve iş akışları için PDF4me bloguna göz atın.

Blogu ziyaret edin →

Başlamadan Önce

Birleştirme etiketleri içeren Word şablonu

Örnek şablon.docx Bu bir fatura şablonudur. Dinamik değerler kullanılır. <<[InvNr]>>, <<[companyName1]>>, <<[ürünAdı]>>ve benzeri etiketler. Alan adları büyük/küçük harf duyarlıdır ve veri anahtarlarınızla tam olarak eşleşmelidir.

Eşleşen veri dosyası

Kullanmak veri.json (tavsiye edilen), test.xml, veya test.csvÜçünün de fatura değerleri aynı. Şunu seçin: Belge Veri Türü Sağladığınız dosya biçimine uyacak şekilde düğümde değişiklik yapın.

PDF4me kimlik belgesi n8n

Bir tane oluşturun PDF4me kimlik belgesi n8n ve yapıştırın API Aynı tuş tüm cihazlarda çalışır. PDF4me Örneğinizdeki düğümler.

→ Alın API anahtar

Örnek Dosya Paketi

Aşağıdaki dört dosyayı da indirin. Bunlar birlikte çalışacak şekilde tasarlanmıştır: bir şablon ve üç eşdeğer veri formatı.

şablon.docx

Fatura Word şablonu ile <<[alan]>> etiketler

veri.json

Şablon etiketleriyle eşleşen 15 anahtar (önerilir)

test.xml

Aynı fatura verileriyle XML

test.csv

Aynı fatura verileriyle CSV (bir veri satırı)

Örnek Dosyaların İçeriği

Şablon düzeni (`template.docx`)

Örnek şablon tek sayfalıktır. fatura Sabit etiketler ve dinamik birleştirme alanlarıyla:

Belge bölümü	Statik etiket (şablona sabitlenmiş)	Birleştirme etiketi (verilerden doldurulmuş)
Başlık	FATURA	(statik)
Fatura meta verileri	Fatura #	`<<[InvNr]>>`
Fatura meta verileri	Fatura Tutarı	`<<[invAmt]>>`
Fatura meta verileri	Fatura Tarihi	`<<[invDate]>>`
Fatura meta verileri	SONRASINDA #	`<<[invPO]>>`
Fatura meta verileri	Fatura Dönemi	`<<[from]>>` ile `<<[to]>>`
Faturalandırılan Kişi	FATURALANDIRILAN KİŞİ	`<<[companyName1]>>`, `<<[companyName2]>>`, `<<[addressline1]>>`, `<<[addressline2]>>`, `<<[country]>>`
Ürün satırı	Açıklama / Fiyat / KDV % / TUTAR (USD)	`<<[productName]>>`, `<<[price]>>`, `<<[vat]>>`, `<<[amount]>>`

:::ipucu Birleştirme etiketi sözdizimi PDF4me Word şablonlarının kullanımı <<[fieldName]>> (Köşeli parantez içinde çift açılı parantezler). Bu, şundan farklıdır: HTML bıyık sözdizimi ({{fieldName}}). Bakınız Word Şablon Sözdizimi Kılavuzu Döngüler, koşullar ve biçimlendirme dizeleri için.

:::

Tüm veri dosyalarında alan eşlemesi

Şablondaki her dinamik değer, bir anahtara karşılık gelir. data.json, BİR XML element içinde test.xmlveya bir CSV sütun içinde test.csv:

Template tag	JSON key (data.json)	XML element (test.xml)	Sample value
`<<[companyName1]>>`	`companyName1`	`CompanyName1`	Muster AG
`<<[companyName2]>>`	`companyName2`	`CompanyName2`	Hans Muster
`<<[addressline1]>>`	`addressline1`	`AddressLine1`	example street
`<<[addressline2]>>`	`addressline2`	`AddressLine2`	8000 Zürich
`<<[country]>>`	`country`	`Country`	Switzerland
`<<[productName]>>`	`productName`	`ProductName`	PDF4me
`<<[price]>>`	`price`	`Price`	1000
`<<[vat]>>`	`vat`	`VAT`	8.00
`<<[amount]>>`	`amount`	`Amount`	1000
`<<[InvNr]>>`	`InvNr`	`InvoiceNumber`	202311InV
`<<[invAmt]>>`	`invAmt`	`InvoiceAmount`	1000
`<<[invDate]>>`	`invDate`	`InvoiceDate`	2023-11-24
`<<[invPO]>>`	`invPO`	`PurchaseOrder`	1234567
`<<[from]>>`	`from`	`FromDate`	2023-10-24
`<<[to]>>`	`to`	`ToDate`	2023-10-24

İş Akışına Genel Bakış

Numune paketini test etmenin en hızlı yolu n8n:

Manual Trigger  →  Read Binary File (template.docx)  →  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.docx` ikili özelliğe `data`
3	PDF4me → Belge Oluştur (Tekli)	Şablonu ve verileri birleştirir, tek bir çıktı oluşturur. PDF
4	İkili Dosya Yaz (isteğe bağlı)	Kaydet `generated_document_output.pdf` diske

Şablon Dosya Türü PDF4me Word Şablonu, Çıktı Türü PDF, Şablon Dosya Giriş Türü İkili Veri, Şablon İkili Özellik verisi, Şablon Dosya Adı template.docx, Belge Veri Giriş Türü Metin, Belge Veri Türü JSON, örnek Belge Veri Metni JSON yükü ile yapılandırılmış n8n düğümü (Tekli Belge Oluşturma) — Hedef yapılandırma: İkili dosyadan Word şablonu + JSON yapıştırıldı **Belge Verileri Metni** + PDF çıktı

Adım 1: Örnek Dosyaları İndirin ve Yerleştirin

İndirmek template.docx Ve data.json -den Örnek Dosya Paketi üstünde.
Her iki dosyayı da bir yere kaydedin. n8n Örneğin onları okuyabilirler. C:\pdf4me-samples\ Kendi sunucunuzda barındırdığınız bir örnekte kaydedebilir veya daha sonra bulut tetikleyicilerini tercih ederseniz Google Drive / Dropbox'a yükleyebilirsiniz.
İsteğe bağlı olarak indirin test.xml veya test.csv test etmek istiyorsanız XML veya CSV veri türleri yerine JSON.

Adım 2: Oluşturun n8n İş Akışı

İçinde n8nYeni bir iş akışı oluşturun.
Ekle Manuel Tetikleyici düğüm (veya üretim için tercih ettiğiniz herhangi bir tetikleyici).
Ekle İkili Dosyayı Oku Tetikleyiciden sonraki düğüm.
Eklemek PDF4me → Belge Oluştur (Tekli) İkili dosyayı okuduktan sonra.
Düğümleri sırayla bağlayın.

Adım 3: Word Şablonunu Yükleyin (`Read Binary File`)

Yapılandırın İkili Dosyayı Oku düğüm:

Alan	Değer
Dosya Yolu	İndirdiğiniz dosyanın tam yolu `template.docx`
Mülk Adı	`data` (varsayılan; bu, ikili özellik haline gelir) PDF4me düğüm okumaları)

Bu düğümü bir kez çalıştırın ve çıktı öğesinin adlı ikili bir alan gösterdiğini doğrulayın. data dosya adı ile template.docx.

Adım 4: Yapılandırma PDF4me Belge Oluştur (Tekli)

Açın PDF4me Düğümü açın ve bu alanları ayarlayın. Aşağıdaki değerler örnek paketle birebir aynıdır.

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ü	PDF4me Word Şablonu	Maçlar `.docx` ile `<<[field]>>` etiketler
Çıktı Türü	PDF	Kullanmak Word düzenlenebilir bir birleştirilmiş dosyaya ihtiyacınız varsa `.docx` yerine

Ş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.docx`

Belge verileri (JSON'u yapıştırın) `data.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. `data.json` (aşağıdaki bloğa bakınız)

{
  "companyName1": "Muster AG",
  "companyName2": "Hans Muster",
  "addressline1": "example street",
  "addressline2": "8000 Zürich",
  "country": "Switzerland",
  "productName": "PDF4me",
  "price": 1000,
  "vat": 8.0,
  "amount": 1000,
  "InvNr": "202311InV",
  "invAmt": 1000,
  "invDate": "2023-11-24",
  "invPO": "1234567",
  "from": "2023-10-24",
  "to": "2023-10-24"
}

Çıkış seçenekleri

Alan	Değer
Kale PDF Düzenlenebilir	`Off (default)`
İkili Veri Çıkış Adı	`data` (varsayılan)

Adım 5: Çalıştırın ve Doğrulayın PDF

Tıklamak İş akışını yürüt (ya da koşarak PDF4me düğüm).
Açın PDF4me Düğüm çıktısı altında. İkiliDosyayı özellikler bölümünde açın. data (dosya adı generated_document_output.pdf).
Oluşturulan faturanın aşağıdaki bilgileri içerdiğini doğrulayın:
- Fatura # → 202311InV
- Faturalandırılan Kişi → Muster AG / Hans Muster / example street / 8000 Zürih / İsviçre
- Satır öğesi → PDF4me, fiyat 1000, KDV 8.00, tutar 1000
- Fatura Dönemi → 2023-10-24 ile 2023-10-24

Bir alan boş görünüyorsa, etiket adını karşılaştırın. template.docx ile JSON Anahtar. Bunlar (büyük/küçük harf dahil) tam olarak eşleşmelidir: InvNr Olumsuz invNr).

Adım 6: Çıktıyı Kaydedin (İsteğe bağlı)

Ekle İkili Dosya Yaz düğümden sonra PDF4me:

Alan	Değer
Dosya adı	`invoice-output.pdf` (veya bir ifade kullanın)
Veri Özelliği Adı	`data`
Çıkış Yolu	Klasörün bulunduğu yer n8n dosyayı yazmalıdır

Alternatif Veri Biçimleri

Aynısı template.docx Örnek paketteki üç veri dosyasının tümüyle çalışır. Sadece şu dosya ile çalışır. Belge Veri Türü ve yük değişimi.

Seçenek A: JSON Dosya ikili formatta (`data.json`)

İkinci bir tane ekleyin İkili Dosyayı Oku düğüm için data.json.
Kullanın Birleştir Şablon ikili dosyasını ve veri ikili dosyasını tek bir öğede birleştirmek (veya veri yükleme işlemini ayrı bir dalda çalıştırmak) için kullanılan düğüm.
İçinde PDF4me: Belge Veri Giriş Türü = İkili Veri, Belge Veri Türü = JSON, Belge İkili Özelliği = data, Belge Veri Dosyası Adı = data.json.

:::Dikkat İkili özellik adı çakışması Şablon ve veri aynı özelliği kullandığında data Aynı öğe üzerinde birbirlerinin üzerine yazılırlar. Ayrı özellik adları kullanın (örneğin, template Ve dataFile) 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 içeriğini yapıştırın test.xml:

<?xml version="1.0" encoding="UTF-8"?>
<Invoice>
    <CompanyName1>Muster AG</CompanyName1>
    <CompanyName2>Hans Muster</CompanyName2>
    <AddressLine1>example street</AddressLine1>
    <AddressLine2>8000 Zürich</AddressLine2>
    <Country>Switzerland</Country>
    <ProductName>PDF4me</ProductName>
    <Price>1000</Price>
    <VAT>8.00</VAT>
    <Amount>1000</Amount>
    <InvoiceNumber>202311InV</InvoiceNumber>
    <InvoiceAmount>1000</InvoiceAmount>
    <InvoiceDate>2023-11-24</InvoiceDate>
    <PurchaseOrder>1234567</PurchaseOrder>
    <FromDate>2023-10-24</FromDate>
    <ToDate>2023-10-24</ToDate>
</Invoice>

C Seçeneği: CSV (`test.csv`)

Ayarlamak Belge Veri Türü ile CSV ve yapıştırın CSV Gövde (başlık satırı + bir veri satırı):

companyName1,companyName2,addressline1,addressline2,country,productName,price,vat,amount,InvNr,invAmt,invDate,invPO,from,to
"Muster AG","Hans Muster","example street","8000 Zürich","Switzerland","PDF4me",1000,8.00,1000,"202311InV",1000,"2023-11-24","1234567","2023-10-24","2023-10-24"

CSV Sütun başlıkları eşleşiyor JSON tuşlara doğrudan eşlenen <<[fieldName]>> Şablondaki etiketler.

Üretim İş Akışı Kalıpları

Üretimde şablon ve veri sağlamanın yaygın yollarıOnce the sample test works, replace the Manual Trigger and Read Binary File nodes with these patterns.

Bulut depolama tetikleyicisi

Google Drive / Dropbox / OneDrive tetikleyicisi yeni dosya alındığında çalışır.
Düğüm getirme işlemlerini indir şablon.docx (veya sabit bir şablon yolu kullanın).
İnşa etmek JSON bir Kod veya Ayarlamak düğümden CRM/Sayfa alanları.
PDF4me birleştirmeler ve çıktılar PDF e-posta veya depolama için.

Dinamik özellikli Webhook JSON

Webhook, sipariş/fatura verilerini alır.
Şablon bir kez yüklendi URL veya ikili depolama.
Webhook gövdesini haritaya ekle Belge Verileri Metni Bir ifadeyle.
Anahtarlar hala eşleşmelidir. <<[alanAdı]>> Şablondaki etiketler.

Halk URLs şablon ve veriler için

Ev sahibi şablon.docx Ve veri.json halka açık HTTPS URLs.
Ayarlamak Şablon Dosyası Giriş Türü = URL, Şablon Dosyası URL'si = şablon bağlantısı.
Ayarlamak Belge Veri Giriş Türü = URL, Belge Veri Dosyası URL'si = veri bağlantısı.
Önceden herhangi bir indirme işlemine gerek yoktur.

Sıkça Sorulan Sorular

What placeholder syntax does PDF4me Word Template use?+

Use <<[fieldName]>> inside your .docx file. This is the PDF4me LINQ Reporting Engine syntax, not HTML mustache {{fieldName}}. For loops use <<foreach [item in items]>> ... <</foreach>>, for conditions use <<if [condition]>> ... <</if>>. See the Word Template Syntax guide for the full reference.

Why is a field blank in the generated PDF?+

The data key must match the template tag exactly, including case. InvNr in the template requires "InvNr" in JSON, not "invoiceNumber" or "invnr". Open template.docx and compare each <<[tag]>> with your data file. Empty values also render as blank without an error.

Can I use data.json as a file instead of pasting JSON?+

Yes. Load data.json with Read Binary File, set Document Data Input Type to Binary Data, Document Data Type to JSON, and point Document Binary Property to the binary field. If the template also uses binary property data, rename one property (e.g. template vs dataFile) or merge items from separate nodes.

JSON vs XML vs CSV: which should I use?+

JSON is the simplest for n8n because keys map directly to <<[fieldName]>> tags (as in data.json). XML (test.xml) uses PascalCase element names that PDF4me binds to the same template fields. CSV (test.csv) uses column headers matching the JSON keys, which is useful when data comes from spreadsheets or exports.

PDF or Word output?+

Set Output Type to PDF for sharing, emailing, or archiving. Set Output Type to Word when the recipient needs to edit the merged document after generation. The sample invoice works with both.

İlgili Kılavuzlar

Belge Oluştur (Tekli) genel bakış: tüm parametreler, çıktı alanları ve şablon türleri
Word Şablon Sözdizimi: <<[field]>> etiketler, döngüler, koşullar, biçimlendirme
Oluştur PDF Word Şablonundan Make: aynı örnek deseni Make

Back to overview Word template syntax

Başlamadan Önce​

Örnek Dosya Paketi​

Örnek Dosyaların İçeriği​

Şablon düzeni (template.docx)​

Tüm veri dosyalarında alan eşlemesi​

İş Akışına Genel Bakış​

Adım 1: Örnek Dosyaları İndirin ve Yerleştirin​

Adım 2: Oluşturun n8n İş Akışı​

Adım 3: Word Şablonunu Yükleyin (Read Binary File)​

Adım 4: Yapılandırma PDF4me Belge Oluştur (Tekli)​

Temel ayarlar​

Şablon girişi (İkili Dosyayı Oku bölümünden)​

Belge verileri (JSON'u yapıştırın) data.json)​

Çıkış seçenekleri​

Adım 5: Çalıştırın ve Doğrulayın PDF​

Adım 6: Çıktıyı Kaydedin (İsteğe bağlı)​

Alternatif Veri Biçimleri​

Seçenek A: JSON Dosya ikili formatta (data.json)​

B Seçeneği: XML (test.xml)​

C Seçeneği: CSV (test.csv)​

Üretim İş Akışı Kalıpları​

Sıkça Sorulan Sorular​

İlgili Kılavuzlar​