Belgeleri (Birden Fazla) Oluştur n8n
Birden fazla belge oluştur n8n'de PDF4me düğüm eylemi olan ve düğümde "Belge Oluştur (Çoklu)" olarak gösterilen bu işlem, tek bir şablon ve kayıt dizisinden tek bir çalıştırmada birçok bitmiş dosya oluşturur. Bunu, her belgenin kendi n8n öğesi olarak döndürüldüğü bir fatura grubu, müşteri mektupları veya bölge bazlı raporlar için kullanabilirsiniz.
Bu düğüm ne işe yarıyor?
PDF4me: Belge Oluştur (Birden Fazla) Tek bir şablon ve kayıt listesi alarak tek seferde birçok bitmiş belge üretir. n8n Çalıştır. Bir tane sağlayın. Kelime, HTML, veya PDF şablon İkili Veriler aracılığıyla, Base64, HTML kod veya URL artı toplu veri olarak JSON veya XML (kayıt dizisi veya tekrar eden) XMLOluşturulan her dosya ayrı bir çıktı öğesi olarak döndürülür, böylece bunları tek tek döngüye alabilir, kaydedebilir, e-posta ile gönderebilir veya yükleyebilirsiniz. Bunun yerine bu düğümü kullanın. Belge Oluştur (Tekli) Müşteri, fatura veya kayıt listeniz olduğunda ve tek bir işlemde her satır için bir adet tamamlanmış belge istediğinizde bu yöntemi kullanabilirsiniz.
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ışı, toplu belge oluşturma isteklerini güvenli bir şekilde doğrulayabilir.
Kaçırmamanız Gereken Önemli Bilgiler
/generate-documents-multiple-full.png)
Tam düğüm paneli. Word şablonu + JSON Metin verileri + PDF Çıktı, tipik bir posta birleştirme kurulumudur.
Çoklu Belge Oluşturma ile Tek Belge Oluşturma Arasındaki Fark
Bu görevde en sık yapılan hata, iki seçenekten yanlış olanını seçmektir. Ayrım, kaç dosyanın geri döndüğüne ve hangi şablon ve veri formatlarının sunulduğuna bağlıdır.
| Bakış açısı | Belge Oluştur (Birden Fazla) | Belge Oluştur (Tekli) |
|---|---|---|
| Files returned | Many, one n8n item per generated document | Exactly one |
| Template types | Word, HTML, PDF | Word, HTML, PDF, plus Mail Merge and Google Docs |
| Data formats | JSON or XML only | JSON, XML, and CSV |
| Output types | PDF, Word, or Excel (HTML templates output HTML) | PDF, Word (no Excel option) |
| Reach for it when | You have a list of records and want one document per row | You have a single record, CSV data, or a Mail Merge template |
Çoklu Belge Oluşturma İşlemi Hangi Parametreleri Gerektirir?
Gereklidir n8n Kullanıcı Arayüzü: Bağlantı kurulacak kimlik bilgisi, Şablon Dosya Türü, Şablon Dosya Giriş Türü, Belge Veri Türü, Belge Veri Giriş Türü ve Çıkış Türü (her zaman gösterilir. Seçenekler Şablon Dosya Türüne bağlıdır). Koşullu gerekli alanlar (Şablon İkili Özelliği, Şablon Base64 İçerik, HTML Kod, Şablon Dosyası URL(Belge Veri Metni, Belge İkili Özelliği vb.) yalnızca üst giriş türü seçildiğinde görünür. Çıktı Dosya Adı, Sakla PDF Düzenlenebilir ve İkili Veri Çıkış Adı seçenekleri, mantıklı varsayılan değerlerle isteğe bağlıdır.
| Parametre | Gerekli | Ne işe yarar? | Örnek |
|---|---|---|---|
| Template File Type | Required | Format of the template the node will render. Word for .docx templates, HTML for HTML templates (including pasted code), PDF for PDF templates. There is no Mail Merge, Google Docs, or PDF form option here; use Generate Document (Single) for those. | Word |
| Output Type | Required | Format of every generated document. Word and PDF templates accept PDF, Word, or Excel. HTML templates accept HTML only. Default is PDF when available. | PDF |
| Template File Input Type | Required | How the template is supplied. Binary Data reads from a previous node (most common). Base64 String accepts an encoded template. HTML Code accepts pasted raw HTML (only valid when Template File Type is HTML). URL downloads the template from a public link. | Binary Data |
| Template Binary Property | Conditional | Name of the binary property on the incoming n8n item that holds the template. Required when Template File Input Type is Binary Data. Defaults to data. | data |
| Template Base64 Content | Conditional | Base64-encoded template content. Required when Template File Input Type is Base64 String. | UEsDBBQAAAAI... |
| HTML Code | Conditional | Raw HTML body (mustache placeholders such as {{title}} are supported). Required when Template File Input Type is HTML Code, which is only valid for Template File Type HTML. The node wraps the snippet in a basic <html> shell if missing. | <h1>{{title}}</h1> |
| Template File URL | Conditional | Publicly reachable HTTPS URL to the template file. Required when Template File Input Type is URL. | https://example.com/template.docx |
| Template File Name | Conditional | Filename of the template. Optional with Binary Data (falls back to the uploaded filename or a sensible default such as template.docx, template.html, template.pdf). Required for Base64 String, HTML Code, and URL. | template.docx |
| Document Data Type | Required | Format of the bulk records you are sending. JSON for arrays of objects (most common). XML for repeating-record XML. CSV is not available on this operation. | JSON |
| Document Data Input Type | Required | How the bulk data is supplied. Text is the default (paste JSON or XML directly). Binary Data reads from a previous node. Base64 String accepts an encoded data file. URL downloads the data file from a public link. | Text |
| Document Data Text | Conditional | Raw bulk JSON or XML payload. Required when Document Data Input Type is Text. The node validates that JSON parses; XML is sent as-is. Use an array of objects in JSON so the API renders many files. | [{"name":"Alice"},{"name":"Bob"}] |
| Document Binary Property | Conditional | Name of the binary property on the incoming n8n item that holds the data file. Required when Document Data Input Type is Binary Data. Defaults to data. | data |
| Document Data File Name | Conditional | Filename for the bulk data file. Optional with Binary Data (falls back to data.json). Required when Document Data Input Type is Base64 String or URL. | customers.json |
| Document Base64 Content | Conditional | Base64-encoded data file. Required when Document Data Input Type is Base64 String. | W3sibmFtZSI6... |
| Document Data File URL | Conditional | Publicly reachable HTTPS URL to the bulk data file. Required when Document Data Input Type is URL. | https://example.com/customers.json |
| Output File Name | Optional | Prefix for the generated filenames. The node appends _1, _2, ... and the correct extension. Example: invoice becomes invoice_1.pdf, invoice_2.pdf. Leave blank to use API-provided names or generated_document_1, generated_document_2, ... | invoice |
| Keep PDF Editable | Optional | Only shown when Output Type is PDF. Keeps AcroForm fields editable on every generated PDF when enabled. Default is off (flattened output). | Off |
| Binary Data Output Name | Optional | Name of the binary property each output item exposes. Default is data. Placeholder suggests generated-documents. | data |
Şablon Dosya Türü Seçenekleri
Şablon formatını seçin. Bu seçimle birlikte Çıktı Türü seçenekleri değişir.
/generate-documents-multiple-template-file-type.png)
Şablon Dosya Türü açılır menüsü. Word, HTML, veya PDF (Burada Mail Merge veya Google Docs kullanılmayacak)
KelimeVarsayılan: .docx şablonlarıHTMLHTML şablonlar ve yapıştırıldı HTML kodPDFPDF şablonlarŞablona Göre Çıktı Türü
| Şablon Dosya Türü | Çıktı Türü seçenekleri | Varsayılan |
|---|---|---|
| Word | PDF, Word, Excel | |
| PDF, Word, Excel | ||
| HTML | HTML only | HTML |
Şablon Dosyası Giriş Türü Seçenekleri
Şablonun düğüme nasıl gireceğini seçin. Bu seçime bağlı olarak sonraki alanlar değişir.
/generate-documents-multiple-template-file-input-type.png)
Şablon Dosyası Giriş Türü. İkili Veri, Base64 Sicim, HTML Kod veya URL
İkili VeriVarsayılan: önceki düğümden gelen dosyaŞablon İkili Özelliği ikili alan adına (varsayılan) veri). Şablon Dosya Adı Bu seçenek isteğe bağlıdır ve yüklenen dosya adına geri döner.Base64 DizisiBase64-kodlanmış şablonŞablon Base64 İçeriği. Şablon Dosya Adı Uzantının Şablon Dosya Türüyle (.docx, .html, .pdf) eşleşmesi gereklidir.HTML KoduHam macun HTML Çizgide (HTML sadece){{başlık}}, {{içerik}} içine HTML KoduDüğüm, onu temel bir yapıya sarar. <html> Kabuk eksikse. Şablon Dosya Adı gereklidir (örneğin şablon.html).URLHerkese açık bağlantıdan indirŞablon Dosyası URL'si. PDF4me Şablonu doğrudan getirir. URL Açık olmalı (yetkilendirme gerekmemeli) ve Şablon Dosya Adı Uzantının şablon türüyle eşleşmesi gereklidir.Belge Veri Türü Seçenekleri
Göndereceğiniz veri formatını seçin.
/generate-documents-multiple-document-data-type.png)
Belge Veri Türü. JSON veya XML (HAYIR CSV bu operasyonda)
JSONVarsayılan: kayıt dizisi (en yaygın olanı)[{"name":"Alice"}, {"name":"Bob"}]Düğüm, veri yükünün ayrıştırıldığını doğrular. Tek bir nesne bir belge oluşturur. Birden fazla belge istiyorsanız dizi geçirin.XMLTekrarlayan kayıt XMLBelge Veri Giriş Türü Seçenekleri
Toplu verilerin düğüme nasıl gireceğini seçin.
/generate-documents-multiple-document-data-input-type.png)
Belge Veri Giriş Türü. Metin, İkili Veri, Base64 Dize veya URL
MetinVarsayılan: Toplu verileri satır içi olarak yapıştırBelge Verileri MetniBu alan, Çoklu işlemde Metin seçildiğinde kesinlikle zorunludur (Tekli işlemine göre daha katıdır).İkili VeriÖnceki düğümden bir veri dosyası kullanın.Belge İkili Özelliği ikili alan adına (varsayılan) veriŞablon ve veri ikili özellik adlarının, her ikisi de aynı öğeden geldiğinde çakışmamasına dikkat edin.Base64 DizisiBase64-kodlanmış veri dosyası.json veya .xml dosyayı base64 olarak Belge Base64 İçeriği. Belge Veri Dosyası Adı gereklidir.URLHerkese açık bağlantıdan indirBelge Veri Dosyası URL'si halka HTTPS URL -nın JSON veya XML Veri dosyası. Belge Veri Dosyası Adı Uzantının veri türüyle eşleşmesi gereklidir.Çıktı Dosya Adı davranışı
| Senaryo | Çıktı Dosya Adı | Oluşturulan dosya adları |
|---|---|---|
| One document returned | invoice | invoice.pdf (extension added if missing) |
| Many documents returned | invoice | invoice_1.pdf, invoice_2.pdf, invoice_3.pdf, ... |
| Many documents, name left empty | (empty) | API-provided names or generated_document_1, generated_document_2, ... |
Çıkış Alanları
Başarılı bir koşu bir getiri sağlar. n8n Oluşturulan belge başına bir öğe. Her öğe hem JSON meta veriler ve ikili dosya.
| Alan | Tip | İçeriğinde neler var? |
|---|---|---|
success | Boolean | True when the document was generated successfully. Use to route error handling branches. |
fileName | String | Filename of this generated document, e.g. invoice_2.pdf. Map into upload or email nodes. |
mimeType | String | MIME type of the output file, e.g. application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, text/html. |
fileSize | Number | Size of the generated file in bytes. |
documentIndex | Number | Index of this document within the batch (1-based). Useful for filenames or logging. |
totalDocuments | Number | How many documents were produced in this run. Same on every item. |
Binary (data) | Binary | The generated document under Binary Data Output Name (default data). Pass to Write Binary File, Email, or any cloud-storage upload. |
n8n'de Çoklu Belge Oluşturma İşlemini Nasıl Ayarlayabilirim?
- Eklemek PDF4me senin n8n İş akışı. Ayarla Kaynak ile Oluştur Ve Operasyonları Oluştur ile Belge Oluştur (Birden Fazla).
- İç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.
- Ayarlamak Şablon Dosya Türü ile Kelime (varsayılan), HTML, veya PDF.
- Ayarlamak Çıktı Türü. PDFWord veya Excel for Word / PDF şablonlar; HTML sadece bunun için HTML şablonlar.
- Ayarlamak Şablon Dosyası Giriş Türü ile İkili Veri (varsayılan), Base64 Sicim, HTML Kod (HTML (sadece) veya URL ve eşleşen şablon alanını doldurun artı Şablon Dosya Adı Gerektiği takdirde.
- Ayarlamak Belge Veri Türü ile JSON (varsayılan) veya XML.
- Ayarlamak Belge Veri Giriş Türü ile Metin (varsayılan) ve yapıştırın JSON diziyi içine Belge Verileri Metniveya İkili Veri'yi seçin, Base64 Dize veya URL ve veri dosyasını sağlayın.
- Ayarlamak Çıktı Dosya Adı okunabilir bir şeye
invoiceböylece dosyalar şu şekilde geri döner:invoice_1.pdf,invoice_2.pdf... - Çıktı veriyorsa PDF Şablonunuzda form alanları varsa, bunları etkinleştirin. Kale PDF Düzenlenebilir.
- Ayrılmak İkili Veri Çıkış Adı gibi
dataAlt düğümün farklı bir özellik adına ihtiyacı olmadığı sürece, düğümü çalıştırın ve birden fazla çıktı öğesini Toplu İşlemlere Böl, İkili Dosya Yaz, E-posta Gönder veya bulut depolama alanına yükle seçeneklerinden birine yönlendirin.
Tipik Kurulumlar
İş Akışı ÖrnekleriCommon n8n workflow patterns using Generate Documents (Multiple).
- Google Sheets düğümü, ad, adres ve bakiye bilgilerini içeren bir müşteri listesini iş akışına çekiyor.
- Bir Kod veya Küme düğümü, satırları bir araya getirir. JSON Nesne dizisi (müşteri başına bir nesne).
- PDF4me Şablon Dosya Türü Word, Çıktı Türü ile Belge Oluştur (Birden Fazla) çalıştırma PDFŞablon Dosyası Giriş Türü İkili Veri ve Belge Verisi Giriş Türü Metin. Çıkış Dosyası Adı:
müşteri_mektubu. - Düğüm, adı belirtilen her müşteri için bir öğe döndürür.
müşteri_mektubu_1.pdf,müşteri_mektubu_2.pdf, ve benzeri. - Öğeler Üzerinde Döngü düğümü her birini gönderir PDF İlgili müşteriye Gmail üzerinden veya Google Drive'a yükleyerek iletilir.
- Bir düğüm .docx şablonunu indirir; başka bir düğüm .json müşteri dosyasını indirir. Bir Birleştirme düğümü bunları birleştirerek her iki ikili dosyayı tek bir öğeye yerleştirir.
- PDF4me Çoklu Belge Oluştur seçeneği, Şablon Dosyası Giriş Türü İkili Veri ( ) ile yapılandırılmıştır.
Şablon İkili Özelliği(şablon alan adına ayarlanmış) ve Belge Veri Giriş Türü İkili Veri (Belge İkili Özelliği(veri alanı adına ayarlanmıştır). - Ayarlamak
Belge Veri Dosyası Adıveri dosyasına isim verilmemişseveri.json. - Oluşturulan dosyalar ayrı öğeler olarak geri döner ve bir yere yazılır. SharePoint Belge kitaplığı, müşteri kimlik numarasıyla adlandırılmıştır.
- Geceleyin çalışan bir Zamanlama Tetikleyicisi, fatura toplu işleminin çalıştırılmasını tetikler.
- PDF4me "Belge Oluştur (Çoklu)" seçeneği, Şablon Dosyası Giriş Türü ile ayarlanmıştır. URL (
Şablon Dosyası URL'si(S3'teki .docx fatura şablonuna işaret eder) ve Belge Veri Giriş Türü URL (Belge Veri Dosyası URL'sioluşturulan bir şeye işaret ediyorfaturalama-döngüsü.jsondosya). Şablon Dosya Adıdırfatura.docxVeBelge Veri Dosyası Adıdırfaturalama-döngüsü.json.- Çıktı Türü PDFÇıktı Dosyasının Adı şudur:
faturave Sakla PDF Düzenlenebilir özelliği kapalı. - İade edilen her ürün, müşterinin Dropbox klasörüne yüklenir ve Outlook üzerinden e-posta olarak gönderilir.
- Bir pazarlama kampanyası başlatıldığında Webhook tetikleyicisi devreye girer.
- PDF4me "Belge Oluştur (Çoklu)" seçeneği Şablon Dosya Türü ile ayarlanmıştır. HTML ve Şablon Dosyası Giriş Türü HTML Kod. HTML Bıyık şeklindeki yer tutucular kullanılarak doğrudan düğüme yapıştırılır.
- Belge Veri Türü şudur: JSONBelge Veri Giriş Türü Metin'dir ve bir ifade, kampanyanın potansiyel müşteri listesini bir şeye eşler. JSON sıralamak.
- Çıktı Türü HTMLDüğüm bir değer döndürür. HTML Her müşteri adayı için dosya.
- Bir İkili Dosya Yazma düğümü, oluşturulan her dosyayı kaydeder. HTML Herkese açık bir web klasörüne; başka bir düğüm ise kişiselleştirilmiş bağlantıyı her potansiyel müşteriye gönderir.
- Günlük zamanlanmış bir tetikleyici, KPI verilerini PostgreSQL'den çekiyor.
- Bir Küme düğümü, satırları bölgeye göre gruplandırır. JSON Her bölge için bir kayıt içeren dizi.
- PDF4me Şablon Dosya Türü Word, Çıktı Türü Excel, Belge Veri Türü ile Çoklu Belge Oluşturma çalıştırmaları JSONBelge Veri Giriş Türü Metin. Çıkış Dosya Adı:
bölge_raporu. - Düğüm, belirtilen her bölge için bir adet .xlsx dosyası döndürür.
bölge_raporu_1.xlsx,bölge_raporu_2.xlsx, ve benzeri. - Microsoft OneDrive düğümü, her dosyayı analiz ekibi için ilgili bölge klasörüne yükler.
Pratik İpuçları
Kopya Kağıdı
| Alan | Değer |
|---|---|
| Resource | Generate |
| Operation | Generate Documents (Multiple) |
| Template File Type | Word |
| Output Type | PDF |
| Template File Input Type | Binary Data |
| Template Binary Property | data |
| Document Data Type | JSON |
| Document Data Input Type | Text |
| Document Data Text | (bulk JSON array with multiple records) |
| Output File Name | my_document (optional, becomes prefix) |
| Binary Data Output Name | data |
| Credentials | PDF4me API credential |
Sıkça Sorulan Sorular
İlgili Eylemler
Diğer Platformlarda Aynı Görev
POST /api/v2/GenerateDocumentMultiple Özel arka uç kodu veya Postman testi için uç nokta.