Ana içeriğe geç

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.

İ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

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

Bir n8n oluşturulan belge başına öğe
Başarılı bir çalıştırma genellikle, oluşturulan dosya başına bir tane olmak üzere birden fazla öğe döndürür. Her öğe, "İkili Veri Çıkış Adı" başlığı altında ikili dosyayı içerir. JSON documentIndex ve totalDocuments içeren meta veriler sayesinde her dosyayı ayrı ayrı döngüye alabilir, kaydedebilir veya e-posta ile gönderebilirsiniz.
Bir dizi geçirin (JSON) veya tekrarlamak XML yani API kaç dosyanın işleneceğini biliyor.
İçin JSONOluşturulan her belge için bir tane olmak üzere nesnelerden oluşan bir dizi kullanın. XMLŞablonun beklediği tekrarlayan kayıt yapısını kullanın (posta birleştirme stili). Tek nesneler tek bir belge oluşturur, bu da bu işlemin amacını ortadan kaldırır.
CSVMail Merge ve Google Docs burada kullanılamıyor.
Şablon Dosya Türü yalnızca Word dosyalarını sunar. HTML, PDFBelge Veri Türü yalnızca şunları sunar: JSON veya XMLİhtiyacınız varsa... CSV Giriş veya Posta Birleştirme / Google Dokümanlar şablonları yerine, Belge Oluştur (Tekli) seçeneğini kullanın.
Çoklu Belge Oluşturma n8n düğümü, Pdf4me ile bağlantı kurmak için Kimlik Bilgilerini, Kaynak Oluşturma, Çoklu Belge Oluşturma İşlemlerini, Şablon Dosya Türü Word, Çıktı Türü PDF, Şablon Dosya Giriş Türü İkili Veri, Şablon İkili Özellik verileri, Şablon Dosya Adı template.docx, Belge Veri Türü JSON, Belge Veri Giriş Türü Metin, örnek Belge Verisi Metin, Çıktı Dosya Adı generated_document, PDF'yi Düzenlenebilir Tutma seçeneğini ve İkili Veri Çıktı Adı verilerini gösteriyor.

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 returnedMany, one n8n item per generated documentExactly one
Template typesWord, HTML, PDFWord, HTML, PDF, plus Mail Merge and Google Docs
Data formatsJSON or XML onlyJSON, XML, and CSV
Output typesPDF, Word, or Excel (HTML templates output HTML)PDF, Word (no Excel option)
Reach for it whenYou have a list of records and want one document per rowYou 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.

ParametreGerekliNe işe yarar?Örnek
Template File TypeRequiredFormat 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 TypeRequiredFormat 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 TypeRequiredHow 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 PropertyConditionalName 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 ContentConditionalBase64-encoded template content. Required when Template File Input Type is Base64 String.UEsDBBQAAAAI...
HTML CodeConditionalRaw 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 URLConditionalPublicly reachable HTTPS URL to the template file. Required when Template File Input Type is URL.https://example.com/template.docx
Template File NameConditionalFilename 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 TypeRequiredFormat 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 TypeRequiredHow 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 TextConditionalRaw 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 PropertyConditionalName 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 NameConditionalFilename 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 ContentConditionalBase64-encoded data file. Required when Document Data Input Type is Base64 String.W3sibmFtZSI6...
Document Data File URLConditionalPublicly reachable HTTPS URL to the bulk data file. Required when Document Data Input Type is URL.https://example.com/customers.json
Output File NameOptionalPrefix 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 EditableOptionalOnly 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 NameOptionalName 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.

n8n PDF4me Generate Documents (Multiple) düğümündeki Şablon Dosya Türü açılır menüsünde üç seçenek gösteriliyor: Word (vurgulanmış), HTML ve PDF.

Ş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ı
Standart PDF4me Bıyık yer tutucuları içeren Word şablonu. Çıktı Türü şu şekilde olabilir: PDFWord veya Excel. Toplu faturalar, müşteri mektupları ve kişiselleştirilmiş raporlar için en yaygın tercih.
HTMLHTML şablonlar ve yapıştırıldı HTML kod
Render'lar HTML Bıyık yer tutuculu şablonlar. Çıktı Türü HTML Yalnızca Şablon Dosyası Giriş Türü ile eşleştirin. HTML Kodun ham halini yapıştırmak için HTML satır içi veya ikili veri kullanın / URL Barındırılan bir .html dosyası için.
PDFPDF şablonlar
Mevcut olanı kullanın. PDF Şablon olarak kullanılabilir. Çıktı Türü şu olabilir: PDFWord veya Excel. İçin PDF çıktı, Sakla'yı etkinleştir PDF Oluşturulan her dosyada alanların düzenlenebilir olmasını istiyorsanız, "Düzenlenebilir" seçeneğini işaretleyin.

Şablona Göre Çıktı Türü

Şablon Dosya TürüÇıktı Türü seçenekleriVarsayılan
WordPDF, Word, ExcelPDF
PDFPDF, Word, ExcelPDF
HTMLHTML onlyHTML

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

n8n PDF4me Generate Documents (Multiple) düğümündeki Şablon Dosyası Giriş Türü açılır menüsünde dört seçenek gösteriliyor: İkili Veri (Önceki düğümden şablon dosyasını kullan), Base64 Dize (Base64 kodlu şablon dosyası sağla), HTML Kodu (Yalnızca HTML şablon türü için geçerli, ham HTML kodunu manuel olarak yaz) ve URL (Şablon dosyasına bir URL sağla)

Şablon Dosyası Giriş Türü. İkili Veri, Base64 Sicim, HTML Kod veya URL

İkili VeriVarsayılan: önceki düğümden gelen dosya
Şablonu doğrudan Google Drive İndirme gibi önceki bir düğümden okur. HTTP İkili Dosya İsteği veya Okuma. Ayarla Ş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
Base64 dizesini yapıştırın veya eşleştirin. Ş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)
Yalnızca Şablon Dosya Türü şu olduğunda geçerlidir: HTMLTamamını veya bir kısmını yapıştırın. HTML yer tutucularla birlikte, örneğin {{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
Bir tane sağlayın HTTPS URL içinde Ş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.

n8n PDF4me Generate Documents (Multiple) düğümündeki Belge Veri Türü açılır menüsünde JSON ve XML olmak üzere iki seçenek vurgulanmıştır. İpucu metninde "Parameter documentDataType" yazmaktadır.

Belge Veri Türü. JSON veya XML (HAYIR CSV bu operasyonda)

JSONVarsayılan: kayıt dizisi (en yaygın olanı)
Kullanın JSON Her bir nesnenin oluşturulmuş bir belgeyi temsil ettiği bir dizi, örneğin: [{"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 XML
Birini kullanın XML Şablonunuzun tekrarlanan satırlar için beklediği yapı (posta birleştirme stili). Düğüm derinlemesine doğrulama yapmaz. Emin olun ki XML Şablonun bağlantı noktalarıyla eşleşir.

Belge Veri Giriş Türü Seçenekleri

Toplu verilerin düğüme nasıl gireceğini seçin.

n8n PDF4me Generate Documents (Multiple) düğümündeki Belge Veri Giriş Türü açılır menüsünde dört seçenek gösterilmektedir: Açıklamalı Metin (JSON veya XML verilerini manuel olarak girin), Açıklamalı İkili Veri (Önceki düğümden veri dosyasını kullanın), Açıklamalı Base64 Dizisi (Base64 kodlu veri dosyası sağlayın), Açıklamalı URL (Veri dosyasına bir URL sağlayın)

Belge Veri Giriş Türü. Metin, İkili Veri, Base64 Dize veya URL

MetinVarsayılan: Toplu verileri satır içi olarak yapıştır
Tamamını yazın veya ifade eşlemesi yapın. JSON dizi veya XML içine Belge 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.
Ayarlamak 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ı
Tamamını sağlayın .json veya .xml dosyayı base64 olarak Belge Base64 İçeriği. Belge Veri Dosyası Adı gereklidir.
URLHerkese açık bağlantıdan indir
Ayarlamak Belge 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 returnedinvoiceinvoice.pdf (extension added if missing)
Many documents returnedinvoiceinvoice_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.

AlanTipİçeriğinde neler var?
successBooleanTrue when the document was generated successfully. Use to route error handling branches.
fileNameStringFilename of this generated document, e.g. invoice_2.pdf. Map into upload or email nodes.
mimeTypeStringMIME type of the output file, e.g. application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, text/html.
fileSizeNumberSize of the generated file in bytes.
documentIndexNumberIndex of this document within the batch (1-based). Useful for filenames or logging.
totalDocumentsNumberHow many documents were produced in this run. Same on every item.
Binary (data)BinaryThe 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?

  1. Eklemek PDF4me senin n8n İş akışı. Ayarla Kaynak ile Oluştur Ve Operasyonları Oluştur ile Belge Oluştur (Birden Fazla).
  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 Şablon Dosya Türü ile Kelime (varsayılan), HTML, veya PDF.
  4. Ayarlamak Çıktı Türü. PDFWord veya Excel for Word / PDF şablonlar; HTML sadece bunun için HTML şablonlar.
  5. 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.
  6. Ayarlamak Belge Veri Türü ile JSON (varsayılan) veya XML.
  7. 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.
  8. Ayarlamak Çıktı Dosya Adı okunabilir bir şeye invoice böylece dosyalar şu şekilde geri döner: invoice_1.pdf, invoice_2.pdf...
  9. Çıktı veriyorsa PDF Şablonunuzda form alanları varsa, bunları etkinleştirin. Kale PDF Düzenlenebilir.
  10. Ayrılmak İkili Veri Çıkış Adı gibi data Alt 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).
JSON dizisinden toplu e-posta gönderimi. Müşteri mektupları
  1. Google Sheets düğümü, ad, adres ve bakiye bilgilerini içeren bir müşteri listesini iş akışına çekiyor.
  2. Bir Kod veya Küme düğümü, satırları bir araya getirir. JSON Nesne dizisi (müşteri başına bir nesne).
  3. 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.
  4. 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.
  5. Öğeler Üzerinde Döngü düğümü her birini gönderir PDF İlgili müşteriye Gmail üzerinden veya Google Drive'a yükleyerek iletilir.
Şablon ve veriler, her ikisi de dosya olarak mevcuttur. n8n
  1. 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.
  2. 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).
  3. Ayarlamak Belge Veri Dosyası Adı veri dosyasına isim verilmemişse veri.json.
  4. 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.
Barındırılan şablon + barındırılan veri. Fatura toplu işlemi
  1. Geceleyin çalışan bir Zamanlama Tetikleyicisi, fatura toplu işleminin çalıştırılmasını tetikler.
  2. 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'si oluşturulan bir şeye işaret ediyor faturalama-döngüsü.json dosya).
  3. Şablon Dosya Adı dır fatura.docx Ve Belge Veri Dosyası Adı dır faturalama-döngüsü.json.
  4. Çıktı Türü PDFÇıktı Dosyasının Adı şudur: faturave Sakla PDF Düzenlenebilir özelliği kapalı.
  5. İade edilen her ürün, müşterinin Dropbox klasörüne yüklenir ve Outlook üzerinden e-posta olarak gönderilir.
Yapıştırılan koddan HTML toplu işlemi → kişiselleştirilmiş açılış sayfaları
  1. Bir pazarlama kampanyası başlatıldığında Webhook tetikleyicisi devreye girer.
  2. 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.
  3. 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.
  4. Çıktı Türü HTMLDüğüm bir değer döndürür. HTML Her müşteri adayı için dosya.
  5. 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.
Word şablonundan Excel çıktısı. Toplu raporlar.
  1. Günlük zamanlanmış bir tetikleyici, KPI verilerini PostgreSQL'den çekiyor.
  2. 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.
  3. 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.
  4. 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.
  5. Microsoft OneDrive düğümü, her dosyayı analiz ekibi için ilgili bölge klasörüne yükler.

Pratik İpuçları

Shape your data as rows
One record per output document. Single objects yield one file. defeats the purpose of this operation.
Use Generate Document (Single) for CSV / Mail Merge / Google Docs
Generate Documents (Multiple) only accepts JSON or XML data and Word / HTML / PDF templates.
"No binary data found" errors
Double-check Template Binary Property and Document Binary Property names. The Merge node from a fan-in workflow can rename binary properties.
Document Data Text is strictly required
On the Multiple operation, leaving the Text field empty rejects the node, stricter than Single.
Name outputs with a meaningful prefix
Use Output File Name like <code>invoice</code> or <code>customer_letter</code> so files are easy to scan in storage (avoid the generic <code>generated_document_*</code> default).
Plan for multiple items downstream
Use Split In Batches, Loop Over Items, or any node that handles many items. not just the first one.

Kopya Kağıdı

AlanDeğer
ResourceGenerate
OperationGenerate Documents (Multiple)
Template File TypeWord
Output TypePDF
Template File Input TypeBinary Data
Template Binary Propertydata
Document Data TypeJSON
Document Data Input TypeText
Document Data Text(bulk JSON array with multiple records)
Output File Namemy_document (optional, becomes prefix)
Binary Data Output Namedata
CredentialsPDF4me API credential

Sıkça Sorulan Sorular

How is Generate Documents (Multiple) different from Generate Document (Single)?+
Multiple renders many documents per run, one n8n item per generated document. Single produces exactly one file. Multiple supports fewer template types (Word, HTML, PDF only, no Mail Merge or Google Docs), only JSON or XML data (no CSV), and adds Excel as an output option for Word and PDF templates. Use Single for one-off documents, CSV data, Mail Merge, Google Docs, or PDF form templates.
What shape should my JSON data have?+
A JSON array where each object becomes one generated document, e.g. [{"name":"Alice","email":"[email protected]"},{"name":"Bob","email":"[email protected]"}] generates two files. The node validates that the payload parses; the API drives how many documents are produced based on the records you pass.
What does Output File Name do when many documents come back?+
It becomes a prefix. Setting Output File Name to invoice with Output Type PDF produces invoice_1.pdf, invoice_2.pdf, ... If you leave it empty, filenames come from the API or default to generated_document_1, generated_document_2, ...
Can I use CSV data with Generate Documents (Multiple)?+
No. Document Data Type only offers JSON and XML on this operation. Use Generate Document (Single) for CSV input or any other workflow that needs CSV.
How do I handle the multiple output items in n8n downstream?+
Each generated document is its own n8n item with the binary file under Binary Data Output Name (default data) and metadata fields like documentIndex and totalDocuments. Wire the node into Split In Batches, Loop Over Items, Write Binary File, or any cloud-storage / email node. they iterate over all items automatically.
Can I keep generated PDFs editable?+
Yes. Enable Keep PDF Editable when Output Type is PDF. Every generated PDF in the batch keeps its AcroForm field definitions. With Keep PDF Editable off, the form is flattened to static text on each file.
What happens if the API returns a single file instead of a list?+
You will get one n8n item only. Downstream nodes that already handle multiple items behave correctly for the single-item case. Always design the rest of the flow to handle 1..N items, not exactly N.
My data file is not named data.json. does it matter?+
When using Binary Data input, set Document Data File Name explicitly so the API treats the payload with the correct extension. Same applies to the template: use Template File Name when the binary does not carry a recognisable filename.

İlgili Eylemler

Diğer Platformlarda Aynı Görev

Yardım Alın