←Genera documento (singolo)

Torna alla guida principale: tutti i tipi di modello, i parametri dei nodi e i campi di output

Stampa unione

Cosa tratta questa guida

Questa guida ti illustra come unire un Modello classico di stampa unione di Word In n8n utilizzando simple_mail_merge_template.docx E sample_mail_merge_data.jsonIl modello utilizza Word FUSIONE segnaposto (non <<[campo]>> o baffi {{campo}}). I dati sono un JSON vettore con un oggetto per destinatario. Per Genera documento (singolo), utilizzare una fila nell'array. L'output può essere PDF O Word.

Articoli correlati del blog

Non ci sono ancora post sul blog dedicati a questa funzionalità — in arrivo a breve.

Nel frattempo, dai un'occhiata al blog di PDF4me per trovare tutorial e procedure operative su tutte le piattaforme.

Visita il blog →

Prima di iniziare

Campi di stampa unione di Word

Il campione simple_mail_merge_template.docx è stato creato con la stampa unione di Word (Inserisci campo di unione). I nomi dei campi sono nome di battesimo, cognome, genere, E membroDevono corrispondere JSON chiavi esattamente.

JSON dati dell'array

Utilizzo sample_mail_merge_data.json (consigliato), test.xml, O test.csv. I dati di unione di stampa sono un serie di problemiPer un documento, incolla un array con un singolo oggetto.

PDF4me credenziale in n8n

Crea un PDF4me credenziale in n8n e incolla il tuo API chiave. La stessa chiave funziona su tutti PDF4me nodi nella tua istanza.

→ Ottieni il tuo API chiave

:::nota: Stampa unione vs Modello Word PDF4me Stampa unione è destinato ai documenti Word creati con i campi di stampa unione classici (MERGEFIELD). Modello Word PDF4me usi <<[fieldName]>> Sintassi LINQ in un normale .docxScegli il tipo che corrisponde a come è stato creato il tuo modello. Per molti destinatari in uno API chiamare, usare Genera documenti (multipli) Invece. :::

Pacchetto di file di esempio

Scarica tutti e quattro i file qui sotto. Un modello di stampa unione di Word più tre formati di dati equivalenti.

simple_mail_merge_template.docx

Modello di stampa unione di Word (4 campi)

sample_mail_merge_data.json

JSON matrice con una riga di destinatari (consigliato)

test.xml

Stessi dati del destinatario XML

test.csv

Stessi dati del destinatario CSV (una riga)

Cosa contengono i file di esempio?

Unisci i campi in simple_mail_merge_template.docx

Il campione è semplice lettera di adesione con quattro campi di unione Word classici:

Merge field name	Typical label in template	Sample value (sample_mail_merge_data.json)
firstname	Given name	John
lastname	Family name	Adams
gender	Gender	Female
member	Membership tier	Basic

:::suggerimento Come controllare i nomi dei campi di unione In Microsoft Word, premere Alt+F9 per attivare/disattivare i codici di campo. I campi di stampa unione appaiono come { MERGEFIELD nome } codici di stile. Il nome dopo FUSIONE deve corrispondere al tuo JSON chiave. :::

Mappatura dei campi su tutti i file di dati

Merge field	JSON key (sample_mail_merge_data.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

A differenza del modello Word PDF4me, non ci sono <<[campo]>> etichette. A differenza HTML, non esiste una sintassi per i baffi. Il motore si lega JSON chiavi per i nomi dei campi di unione di Word uno a uno.

Panoramica del flusso di lavoro

Manual Trigger  →  Read Binary File (simple_mail_merge_template.docx)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File

Fare un passo	n8n nodo	Scopo
1	Grilletto manuale	Avvia il flusso di lavoro su richiesta
2	Leggere file binario	Carichi simple_mail_merge_template.docx in proprietà binaria data
3	PDF4me → Genera documento (singolo)	Modello di unione + JSON matrice, output PDF O Word
4	Scrivi file binario O Invia e-mail (opzionale)	Salva o invia generated_document_output.pdf

Impostato Tipo di file modello A Stampa unione. Scegliere PDF O Word per Tipo di output.

---

Passaggio 1: Scarica e posiziona i file di esempio

1. Scaricamento simple_mail_merge_template.docx E sample_mail_merge_data.json dal Pacchetto di file di esempio Sopra.
2. Salva il modello da qualche parte n8n può leggerlo (percorso locale su hosting autonomo o archiviazione cloud per i trigger di produzione).
3. Download facoltativo test.xml O test.csv per testare altri tipi di dati.

---

Passaggio 2: creare il n8n Flusso di lavoro

1. In n8n, creare un nuovo flusso di lavoro.
2. Aggiungi un Grilletto manuale nodo.
3. Aggiungi un Leggere file binario nodo dopo il trigger.
4. Aggiungere PDF4me → Genera documento (singolo) dopo aver letto il file binario.
5. Collega il tuo PDF4me credenziale.

:::attenzione Il codice HTML non è valido qui Tipo di input del file modello: HTML Codice funziona solo quando Tipo di file modello È HTML. Per la stampa unione, utilizzare Dati binari, Base64 Corda, O URL.

:::

---

Passaggio 3: Carica il modello di Word (Read Binary File)

Configurare il Leggere file binario nodo:

Campo	Valore
Percorso del file	Percorso completo del file scaricato simple_mail_merge_template.docx
Nome della proprietà	data (predefinito; utilizzato come Proprietà binaria del modello In PDF4me)

Esegui questo nodo una volta e verifica che l'elemento di output sia binario data con nome file simple_mail_merge_template.docx.

---

Passaggio 4: Configurare PDF4me Genera documento (singolo)

Impostazioni principali

Campo	Valore	Note
Credenziali per connettersi con	Tuo PDF4me credenziale	Ottenere API chiave
Risorsa	Generate
Generare operazioni	Genera documento (singolo)
Tipo di file modello	Stampa unione	Modello di fusione Word classico
Tipo di output	PDF O Word	PDF da condividere; Word se il destinatario deve modificare il documento unito

Input del modello (da Leggi file binario)

Campo	Valore
Tipo di input del file modello	Dati binari
Proprietà binaria del modello	data
Tempo di creazione del file modello	simple_mail_merge_template.docx

Dati del documento (incolla l'array JSON da sample_mail_merge_data.json)

Campo	Valore
Tipo di immissione dati del documento	Testo
Tipo di dati del documento	JSON
Testo dei dati del documento	Incolla l'intero contenuto di sample_mail_merge_data.json (vedi il blocco sottostante)

[
  {
    "firstname": "John",
    "lastname": "Adams",
    "gender": "Female",
    "member": "Basic"
  }
]

:::importante Il JSON deve essere un array I dati di unione di stampa sono un JSON vettore, anche per un singolo destinatario. Un oggetto nell'array produce un documento unito con Genera documento (singolo).

:::

Opzioni di output

Campo	Valore
Mantenere PDF Modificabile	Disattivato (impostazione predefinita) quando il tipo di output è PDF
Nome dell'output dei dati binari	data (predefinito)

---

Passaggio 5: Eseguire e verificare l'output

1. Fare clic Eseguire il flusso di lavoro.
2. Apri il PDF4me output del nodo. Sotto Binarioproprietà aperta data generated_document_output.pdf O .docx).
3. Verificare che tutti e quattro i campi di unione siano compilati:
   • nome di battesimo → Giovanni
   • cognome → Adams
   • genere → Femmina
   • membro → Base

Se un campo è vuoto, confronta il tuo JSON Tasti corrispondenti ai nomi dei campi di unione nel modello di Word (Alt+F9 in Word).

---

Passaggio 6: Salva o invia l'output (facoltativo)

Scrivi file binario:

Campo	Valore
Nome del file	mail-merge-output.pdf
Nome della proprietà dati	data
Percorso di output	Cartella di destinazione sul tuo n8n ospite

Invia e-mail: allega il binario data da PDF4me come il PDF O Word allegato.

---

Formati dati alternativi

Opzione A: JSON file come binario (sample_mail_merge_data.json)

1. Aggiungere Leggere file binario per sample_mail_merge_data.json (usare un Unire nodo se il modello e i dati condividono l'elemento del flusso di lavoro).
2. Impostato Tipo di immissione dati del documento A Dati binari, Tipo di dati del documento A JSON, Proprietà binaria del documento al tuo campo dati, Nome del file di dati del documento A sample_mail_merge_data.json.

:::attenzione Conflitto di nomi di proprietà binarie Se sia il modello che i dati utilizzano la proprietà data, uno sovrascrive l'altro. Utilizzare nomi separati (ad esempio template E mergeData) oppure unisci elementi da due nodi Leggi file binario.

:::

Opzione B: XML test.xml)

Impostato Tipo di dati del documento A XML e incollare:

<?xml version="1.0" encoding="UTF-8"?>
<Person>
    <firstname>John</firstname>
    <lastname>Adams</lastname>
    <gender>Female</gender>
    <member>Basic</member>
</Person>

I nomi degli elementi corrispondono ai nomi dei campi di unione e alle chiavi JSON.

Opzione C: CSV test.csv)

Impostato Tipo di dati del documento A CSV e incolla (riga di intestazione + una riga di dati):

firstname,lastname,gender,member
"John","Adams","Female","Basic"

Le intestazioni di colonna corrispondono direttamente ai nomi dei campi di unione.

---

Input alternativo del modello: URL

Ospite simple_mail_merge_template.docx in un luogo pubblico HTTPS URL, quindi impostare:

Campo	Valore
Tipo di input del file modello	URL
URL del file modello	Collegamento pubblico a simple_mail_merge_template.docx
Tempo di creazione del file modello	simple_mail_merge_template.docx

Non è richiesto alcun nodo Read Binary File. I dati possono comunque essere incollati come Testo dei dati del documento o caricato da un URL.

---

Modelli di flusso di lavoro di produzione

Metodi comuni per eseguire la stampa unione in ambiente di produzioneOnce the sample test works, replace the Manual Trigger with these patterns.

Fogli Google riga per lettera

1. I fogli di calcolo si attivano all'inizio di una nuova riga.
2. Codice O Impostato il nodo avvolge la riga in un JSON vettore: [{"nome di battesimo": "...", ...}].
3. PDF4me Unione di posta con fisso simple_mail_merge_template.docx.
4. Inviare un'e-mail alla versione unita PDF al destinatario.

Modulo di registrazione Webhook

1. Il webhook riceve il payload del modulo.
2. Mappa i campi del corpo alle chiavi di unione (nome di battesimo, cognome, ecc.).
3. Costruisci un oggetto JSON array per il testo dei dati del documento.
4. Salva o invia tramite e-mail l'output PDF.

Unione in blocco (molti destinatari)

1. Esporta contatti come JSON matrice (un oggetto per persona).
2. Passa a Genera documenti (multipli) per uno PDF per riga.
3. Mantieni l'opzione Genera documento (singolo) quando hai bisogno di un solo file unito per ogni esecuzione.

Domande frequenti

How is Mail Merge different from PDF4me Word Template?+

Mail Merge uses classic Word MERGEFIELD placeholders created in Word mail merge. PDF4me Word Template uses <<[fieldName]>> LINQ syntax in a regular .docx. Pick the type that matches how your template was authored. Data for Mail Merge is typically a JSON array.

Why must JSON be an array?+

Mail merge is designed for one or more recipient rows. Generate Document (Single) uses the first row when you pass one object in the array. Generate Documents (Multiple) processes every row and returns multiple output files.

Why is a merge field blank?+

JSON keys must match MERGEFIELD names exactly, including case. firstname works; FirstName or first_name usually does not. Toggle field codes in Word (Alt+F9) to read the internal name.

PDF or Word output?+

Choose PDF for emailing, archiving, or printing. Choose Word when the recipient needs to edit the merged document after generation. Both work with the same template and JSON array.

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

JSON arrays are the most natural fit for mail merge in n8n. XML and CSV in the sample pack carry the same four values for a single recipient. All formats map one value per merge field name.

Guide correlate

• Panoramica della generazione del documento (singolo).: tutti i parametri, i campi di output e i tipi di modello
• PDF4me Modello Word: <<[fieldName]>> sintassi al posto di MERGEFIELD
• Genera documenti (multipli): un file di output per riga nel tuo JSON vettore
• Blog sul flusso di lavoro di stampa unione: modello end-to-end in Make

Back to overviewGenerate Documents (Multiple)