Estrai righe dal foglio di lavoro Excel utilizzando n8n azione

PDF4me Estrai righe converte qualsiasi porzione di foglio di lavoro in un file pronto all'uso JSON entro n8nSpecificare intervalli di righe/colonne basati su 0, decidere se la prima riga deve diventare intestazione, saltare le righe nascoste o vuote e scegliere se i valori rimangono tipizzati (numeri, booleani, ISO date) o forzato a testo. Ideale per convogliare i dati Excel in APIs, database o aggiuntivi PDF4me azioni.

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 →

Impostare

Aggiungi il PDF4me nodo “Estrai righe” nel tuo n8n flusso di lavoro e configurare i parametri richiesti. Per le istruzioni di configurazione iniziale, consultare il nostro n8n Guida all'integrazione.

Prerequisiti

• PDF4me API credenziali
• n8n accesso al flusso di lavoro

Get Your API Key

Configurazione

1. Aggiungi il PDF4me nodo al flusso di lavoro
2. Seleziona l'azione "Estrai righe dal foglio di lavoro Excel"
3. Fornire il file sorgente Excel e la finestra di estrazione

Parametri

Importante: I parametri contrassegnati da un asterisco (***) sono obbligatori. Gli indici di riga/colonna sono basato su 0 (Riga 0 = riga 1 di Excel).

Parametro	Tipo	Descrizione	Esempio
Tipo di dati di input***	String	Selettore sorgente Excel (Binary Data, Base64 String, URL).	Binary Data
Campo binario di input***	Binario	Richiesto quando Binary Data è selezionato.	{{ $binary.data }}
Contenuto del documento Base64***	String	Richiesto quando Base64 String è selezionato.	UEsDBBQAAAA...
URL del documento***	String	Richiesto quando URL è selezionato. Collegamento al file pubblico.	https://files.example.com/report.xlsx
Nome file***	String	Nome logico della cartella di lavoro con estensione.	analytics.xlsx
Nome del foglio di lavoro	String	Foglio di lavoro da leggere. Vuoto = primo foglio.	Summary
Prima fila***	Numero	Riga iniziale di estrazione con indice base 0.	0
Ultima fila	Numero	Riga finale basata su 0. Utilizzare -1 leggere fino all'ultima riga di dati.	-1
Prima colonna	Numero	Colonna iniziale basata su 0 (0 = colonna A).	0
Ultima colonna	Numero	Colonna finale basata su 0. Utilizzare -1 per l'ultima colonna di dati.	-1
Ha una riga di intestazione	Boolean	true usi First Row come intestazioni di colonna ed escluderlo dai dati.	true
Escludi righe nascoste	Boolean	Salta le righe nascoste in Excel.	false
Escludi colonne nascoste	Boolean	Salta le colonne nascoste.	false
Escludi righe vuote	Boolean	Rimuovi le righe in cui tutte le celle sono vuote.	true
Esporta celle vuote	Boolean	Invece di ometterle, includi le celle vuote con valori di tipo stringa vuota.	false
Esporta i valori come testo	Boolean	Forza tutti i valori a diventare stringhe. false preserva le specie autoctone.	false
Nome dell'output dei dati binari***	String	Archiviazione di slot binari serializzata JSON PDF4me resi JSON byte).	document

Produzione

Parametri di output

Parametro	Tipo	Descrizione	Esempio
successo	Boolean	PDF4me stato operativo - Boolean Indicatore che segnala il successo o il fallimento del processo di estrazione delle righe. PDF4me resi true per operazioni di successo e false per eventuali errori	true
nomefileoriginale	String	Nome del file del documento Excel originale - Il nome del file di input del documento Excel	myExcelFile.xlsx
Nome del foglio di lavoro	String	Nome del foglio di lavoro - Il nome del foglio di lavoro da cui sono state estratte le righe	First Worksheet
ha la riga di intestazione	Boolean	Stato della riga di intestazione - Indica se la prima riga è stata trattata come intestazione. true se sono state utilizzate le intestazioni, false Altrimenti	true
primaRiga	Numero	Indice della prima riga (basato su 0) - L'indice basato su 0 della prima riga estratta	0
ultimaRiga	Numero	Indice dell'ultima riga (basato su 0) - L'indice (basato su 0) dell'ultima riga estratta. -1 indica l'estrazione fino all'ultima riga di dati	2
prima colonna	Numero	Indice della prima colonna (basato su 0) - L'indice a base 0 della prima colonna estratta (0 = colonna A)	0
ultima colonna	Numero	Indice dell'ultima colonna (basato su 0) - L'indice (basato su 0) dell'ultima colonna estratta. -1 indica l'estrazione nell'ultima colonna di dati	-1
escludiRigheVuote	Boolean	Esclusione delle righe vuote - Indica se le righe vuote sono state escluse. true se escluso, false se incluso	true
escludiRigheNascoste	Boolean	esclusione di righe nascoste - Indica se le righe nascoste sono state escluse. true se escluso, false se incluso	true
escludiColonneNascoste	Boolean	esclusione delle colonne nascoste - Indica se le colonne nascoste sono state escluse. true se escluso, false se incluso	true
exportValuesAsText	Boolean	Modalità di esportazione del testo - Indica se i valori sono stati esportati come testo. true se costretti a stringhe, false se i tipi nativi vengono preservati	false
esportaCelleVuote	Boolean	esportazione di celle vuote - Indica se le celle vuote sono state esportate. true se inclusi con stringhe vuote, false se omesso	false
esportaComeOggetto	Boolean	Modalità di esportazione oggetto - Indica se i dati sono stati esportati in formato oggetto	false
Formato collegamento ipertestuale	String	Formato collegamento ipertestuale - Formato utilizzato per i collegamenti ipertestuali nei dati estratti. Valori: "Testo", "URL", ecc.	Text
cultura	String	Codice culturale/locale - Codice cultura utilizzato per l'estrazione dei dati (ad esempio, "en-US", "de-DE", "fr-FR")	en-US
righe estratte	Numero	Numero di righe estratte - Il numero totale di righe estratte con successo	1
dati estratti	Object	Oggetto dati estratto - Oggetto annidato contenente i dati della riga estratti con l'array rowData	{"rowData": [{"Column1": 1, "First Name": "Dulce"}]}
messaggio	String	Messaggio operativo - Messaggio descrittivo che indica il risultato dell'operazione di estrazione delle righe, incluso il numero di righe estratte e il nome del foglio di lavoro.	Successfully extracted 1 row(s) from worksheet 'First Worksheet'

N8N Risposta all'azione

IL PDF4me Estrarre righe da un foglio di lavoro Excel API Restituisce una risposta che può essere visualizzata in diversi formati. Scegli la visualizzazione più adatta alle tue esigenze:

JSON

JSON Formato di risposta

Il grezzo JSON risposta da API:

[
{
"success": true,
"originalFileName": "myExcelFile.xlsx",
"worksheetName": "First Worksheet",
"hasHeaderRow": true,
"firstRow": 0,
"lastRow": 2,
"firstColumn": 0,
"lastColumn": -1,
"excludeEmptyRows": true,
"excludeHiddenRows": true,
"excludeHiddenColumns": true,
"exportValuesAsText": false,
"exportEmptyCells": false,
"exportAsObject": false,
"hyperlinkFormat": "Text",
"culture": "en-US",
"rowsExtracted": 1,
"extractedData": {
"document": null,
"fileName": null,
"success": true,
"errorMessage": null,
"rowData": [
{
"Column1": 1,
"First Name": "Dulce",
"Last Name": "Abril",
"Gender": "Female",
"Country": "United States",
"Age": 32,
"Date": "15/10/2017",
"Id": 1562
},
{
"Column1": 2,
"First Name": "Mara",
"Last Name": "Hashimoto",
"Gender": "Female",
"Country": "Great Britain",
"Age": 25,
"Date": "16/08/2016",
"Id": 1582
}
]
},
"message": "Successfully extracted 1 row(s) from worksheet 'First Worksheet'"
}
]

Table

Visualizzazione tabella

Dati di risposta in formato tabellare strutturato:

Parametro	Valore
successo	true
nomefileoriginale	myExcelFile.xlsx
Nome del foglio di lavoro	First Worksheet
ha la riga di intestazione	true
primaRiga	0
ultimaRiga	2
prima colonna	0
ultima colonna	-1
escludiRigheVuote	true
escludiRigheNascoste	true
escludiColonneNascoste	true
exportValuesAsText	false
esportaCelleVuote	false
esportaComeOggetto	false
Formato collegamento ipertestuale	Text
cultura	en-US
righe estratte	1
dati estratti	Oggetto contenente l'array rowData
messaggio	Successfully extracted 1 row(s) from worksheet 'First Worksheet'

Oggetto dati estratto:

Parametro	Valore
documento	null
Nome file	null
successo	true
messaggio di errore	null
dati riga	Array di oggetti riga estratti

Nota: rowData contiene gli oggetti riga estratti come un array con le intestazioni di colonna come chiavi.

Schema

Vista dello schema

Struttura dei dati e tipologie di risposta:

1 item
success: ☑ true
originalFileName: T myExcelFile.xlsx
worksheetName: T First Worksheet
hasHeaderRow: ☑ true
firstRow: # 0
lastRow: # 2
firstColumn: # 0
lastColumn: # -1
excludeEmptyRows: ☑ true
excludeHiddenRows: ☑ true
excludeHiddenColumns: ☑ true
exportValuesAsText: ☑ false
exportEmptyCells: ☑ false
exportAsObject: ☑ false
hyperlinkFormat: T Text
culture: T en-US
rowsExtracted: # 1
extractedData: {} Object
document: null
fileName: null
success: ☑ true
errorMessage: null
rowData: [] Array
[0]: {} Object
Column1: # 1
First Name: T Dulce
Last Name: T Abril
Gender: T Female
Country: T United States
Age: # 32
Date: T 15/10/2017
Id: # 1562
[1]: {} Object
Column1: # 2
First Name: T Mara
Last Name: T Hashimoto
Gender: T Female
Country: T Great Britain
Age: # 25
Date: T 16/08/2016
Id: # 1582
message: T Successfully extracted 1 row(s) from worksheet 'First Worksheet'

Indicatori di tipo:

• T = String (Testo)
• # = Numerico
• ☑ = Boolean
• [] = Array
• {} = Object
• null = Valore nullo

Binary

Visualizzazione dei dati binari

I dati estratti vengono restituiti come JSON nella risposta. Accedi ai dati della riga direttamente da extractedData.rowData vettore:

extractedData
─────────────────────────────
rowData: Array of row objects
success: true
errorMessage: null

Accesso ai dati:

• Array di dati riga: $json.extractedData.rowData
• Righe singole: $json.extractedData.rowData[0]
• Valori delle colonne: $json.extractedData.rowData[0]["First Name"]
• JSON Risposta: Disponibile in forma strutturata JSON In n8n risposta

Casi d'uso

• API mangimi: Estrai le righe filtrate e inviale direttamente a REST endpoint o consumatori di webhook.
• Ingestione del databaseTrasforma i report Excel in report strutturati JSON ogni notte prima dell'inserimento nei database SQL/NoSQL.
• Validazione e controllo qualitàConsente di estrarre intervalli per verificare le regole, inviare avvisi o arricchire altri flussi di lavoro senza esportare manualmente.

Richiedi assistenza

n8n Integration Guiden8n SampleGetting Started