←Genera documento (singolo)

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

Modulo PDF

Cosa tratta questa guida

Questa guida ti illustra come compilare un PDF Modello AcroForm In n8n utilizzando template.pdf E formdata.jsonMappa delle chiavi dati direttamente ai nomi dei campi del modulo nome di battesimo, cognome, ecc.). L'output è PDF soltanto. Utilizzo Mantenere PDF Modificabile per lasciare i campi modificabili dopo il riempimento, oppure disattivare questa opzione per appiattire il modulo.

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

PDF con campi AcroForm

Il campione template.pdf Si tratta di un modulo di iscrizione con quattro campi. JSON le chiavi devono corrispondere nome interno di AcroForm, non l'etichetta visibile sullo schermo. I nomi distinguono tra maiuscole e minuscole.

oggetto dati piatto

Utilizzo formdata.json (consigliato), test.xml, O test.csv. Tutti e tre forniscono gli stessi quattro valori. I dati del modulo PDF sono un singolo oggetto piatto, non annidato come il HTML Esempio di fattura

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: Modulo PDF vs. Compilazione di un modulo PDF Genera documento (singolo) con Modulo PDF utilizza il motore di modelli di generazione con un PDF modulo come modello. Per compilare qualsiasi modulo esistente PDF AcroForm senza il flusso di lavoro di generazione, vedere Compila un PDF ModuloPer scoprire i nomi dei campi su un elemento sconosciuto PDF, correre Estrai i dati del modulo da PDF Prima sul modello.

:::

Pacchetto di file di esempio

Scarica tutti e quattro i file qui sotto. Uno PDF Modello di modulo più tre formati di dati equivalenti.

template.pdf

PDF Modello AcroForm (4 campi)

formdata.json

Piatto JSON indicizzazione tramite nome del campo (consigliato)

test.xml

Stessi valori del modulo XML

test.csv

Stessi valori del modulo CSV (una riga)

Cosa contengono i file di esempio?

Campi modulo in template.pdf

Il PDF di esempio è semplice modulo di iscrizione/registrazioneOgni nome di campo di AcroForm corrisponde a una chiave nei tuoi dati:

Nome del campo AcroForm	Utilizzo tipico nel modello	Valore campione (formdata.json)
firstname	Nome di battesimo	Giovanni
lastname	Cognome	Adams
gender	Selezione del genere	Femmina
member	Livello di appartenenza	Di base

:::suggerimento Nomi dei campi vs etichette visibili I nomi di AcroForm sono spesso in minuscolo e senza spazi (firstname), anche quando il PDF mostra "Nome". Se un valore appare vuoto, la chiave nel tuo JSON quasi sempre non corrisponde al nome del campo interno. Utilizzare Estrai i dati del modulo da PDF Per elencare i nomi esatti dal tuo modello.

:::

Mappatura dei campi su tutti i file di dati

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

A differenza di Word o HTML modelli, ci sono nessun segnaposto per i baffiIl motore corrisponde chiavi dati per i nomi dei campi di AcroForm uno a uno.

Panoramica del flusso di lavoro

Manual Trigger  →  Read Binary File (template.pdf)  →  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 template.pdf in proprietà binaria data
3	PDF4me → Genera documento (singolo)	Compila i campi AcroForm da JSON/XML/CSV, output PDF
4	Scrivi file binario O Invia e-mail (opzionale)	Salva o invia generated_document_output.pdf

Impostato Tipo di file modello A Modulo PDF. Tipo di output È PDF solo per questo tipo di modello.

---

Passaggio 1: Scarica e posiziona i file di esempio

1. Scaricamento template.pdf E formdata.json dal Pacchetto di file di esempio Sopra.
2. Salva template.pdf in qualche luogo 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 il modulo PDF, utilizzare Dati binari, Base64 Corda, O URL.

:::

---

Passaggio 3: Carica il modello PDF (Read Binary File)

Campo	Valore
Percorso del file	Percorso completo del file scaricato template.pdf
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 template.pdf.

---

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	Modulo PDF	PDF con campi AcroForm
Tipo di output	PDF	Opzione disponibile solo per il modulo PDF

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	template.pdf

Dati del documento (incolla JSON da formdata.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 formdata.json (vedi il blocco sottostante)

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

Opzioni di output

Campo	Valore	Quando utilizzare
Mantenere PDF Modificabile	SU	Il destinatario deve comunque modificare i campi nel modulo compilato PDF
Mantenere PDF Modificabile	Spento (predefinito)	Trasforma i campi del modulo in contenuti statici.
Nome dell'output dei dati binari	data (predefinito)	Proprietà binaria per l'output PDF

---

Passaggio 5: Eseguire e verificare PDF

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

Se un campo è vuoto, confronta il tuo JSON chiavi con i nomi AcroForm in template.pdf personaggio per personaggio.

---

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

Scrivi file binario:

Campo	Valore
Nome del file	filled-form-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 allegato.

---

Formati dati alternativi

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

1. Aggiungere Leggere file binario per formdata.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 formdata.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 formData) 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 AcroForm e JSON chiavi.

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

---

Input alternativo del modello: URL

Ospite template.pdf in un luogo pubblico HTTPS URL, quindi impostare:

Campo	Valore
Tipo di input del file modello	URL
URL del file modello	Collegamento pubblico a template.pdf
Tempo di creazione del file modello	template.pdf

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

Modalità comuni per compilare i moduli PDF in produzioneOnce the sample test works, replace the Manual Trigger with these patterns.

Invio del modulo tramite webhook

1. Il webhook riceve il payload di registrazione.
2. Mappa i campi del corpo su JSON chiavi corrispondenti ai nomi AcroForm.
3. PDF4me riempie fisso template.pdf da binario o URL.
4. Invia tramite e-mail o salva il modulo compilato PDF.

riga di Fogli Google a PDF

1. I fogli di calcolo si attivano all'inizio di una nuova riga.
2. Impostato O Codice build di nodi {"nome di battesimo": "...", ...}.
3. PDF4me Genera un documento (singolo) utilizzando il modello di modulo PDF.
4. Carica l'output su Drive o SharePoint.

CRM contatto per l'iscrizione PDF

1. Attivazione di HubSpot/Salesforce al momento della creazione di un nuovo contatto.
2. Mappa CRM proprietà a nome di battesimo, cognome, ecc.
3. Impostato Mantenere PDF Modificabile Pronto per essere appiattito prima dell'archiviazione.

Domande frequenti

How is Pdf Form different from Fill a PDF Form?+

Generate Document (Single) with Pdf Form is part of the generate template workflow (same node as Word and HTML). Fill a PDF Form is a dedicated Forms operation for any PDF with AcroForm fields. Both map keys to field names; choose Generate when Pdf Form is your Template File Type in a generate pipeline.

Why are some fields blank in the output?+

JSON keys must match AcroForm field names exactly, including case. firstname works; FirstName or first_name usually does not. Run Extract Form Data From PDF on template.pdf to list internal names before mapping CRM or webhook data.

Should I turn Keep PDF Editable on or off?+

On: fields remain editable (useful for review workflows). Off: fields are flattened into static text (better for final archival or when recipients should not change values). Default is Off.

Can Pdf Form output Word or HTML?+

No. When Template File Type is Pdf Form, Output Type is PDF only.

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

JSON is simplest for n8n expressions and webhooks. XML and CSV in the sample pack use the same four keys. All formats map one value per AcroForm field name.

Guide correlate

• Panoramica della generazione del documento (singolo).: tutti i parametri, i campi di output e i tipi di modello
• Compila un PDF Modulo: compilazione AcroForm dedicata senza il motore di generazione del modello
• Estrai i dati del modulo da PDF: elenca i nomi dei campi da qualsiasi PDF modulo

Back to overviewFill a PDF Form