Extrahieren von Zeilen aus einem Excel-Arbeitsblatt mithilfe von n8n Aktion

PDF4me Zeilen extrahieren wandelt jeden Arbeitsblattausschnitt in ein sofort einsatzbereites Format um. JSON innerhalb n8nGeben Sie nullbasierte Zeilen-/Spaltenbereiche an, legen Sie fest, ob die erste Zeile als Überschrift verwendet werden soll, überspringen Sie ausgeblendete oder leere Zeilen und wählen Sie aus, ob Werte typisiert bleiben (Zahlen, boolesche Werte, …). ISO Datumsangaben) oder in Text umgewandelt. Ideal zum Weiterleiten von Excel-Daten in APIs, Datenbanken oder zusätzliche PDF4me Aktionen.

Verwandte Blog-Beiträge

Zu dieser Funktion gibt es noch keinen Blogbeitrag – folgt in Kürze.

Schauen Sie sich in der Zwischenzeit im PDF4me-Blog Tutorials und Arbeitsabläufe für alle Plattformen an.

Besuchen Sie den Blog →

Aufstellen

Füge die PDF4me Knoten „Zeilen extrahieren“ zu Ihrem n8n Führen Sie den Workflow durch und konfigurieren Sie die erforderlichen Parameter. Anweisungen zur Ersteinrichtung finden Sie in unserer [Website/Dokumentation/etc.]. n8n IntegrationsleitfadenDie

Voraussetzungen

• PDF4me API Zugangsdaten
• n8n Workflow-Zugriff

Get Your API Key

Konfiguration

1. Füge die PDF4me Knoten zum Workflow
2. Wählen Sie die Aktion „Zeilen aus Excel-Arbeitsblatt extrahieren“ aus.
3. Geben Sie die Excel-Quelldatei und das Extraktionsfenster an.

Parameter

Wichtig: Mit einem Sternchen (***) gekennzeichnete Parameter sind Pflichtfelder. Zeilen-/Spaltenindizes sind 0-basiert (Zeile 0 = Excel-Zeile 1).

Parameter	Typ	Beschreibung	Beispiel
Eingabedatentyp***	String	Excel-Quellenauswahl (Binary Data, Base64 String, URL).	Binary Data
Binäres Eingabefeld***	Binär	Erforderlich, wenn Binary Data ist ausgewählt.	{{ $binary.data }}
Base64-Dokumentinhalt***	String	Erforderlich, wenn Base64 String ist ausgewählt.	UEsDBBQAAAA...
Dokument-URL***	String	Erforderlich, wenn URL ist ausgewählt. Link zur öffentlichen Datei.	https://files.example.com/report.xlsx
Dateiname***	String	Logischer Arbeitsmappenname mit Dateiendung.	analytics.xlsx
Name des Arbeitsblatts	String	Arbeitsblatt zum Lesen. Leer = erstes Blatt.	Summary
Erste Reihe***	Nummer	0basierte Startzeile für die Extraktion.	0
Letzte Reihe	Nummer	0-basierte Endzeile. Verwenden Sie -1 bis zur letzten Datenzeile lesen.	-1
Erste Spalte	Nummer	0-basierte Startspalte (0 = Spalte A).	0
Letzte Spalte	Nummer	0-basierte Endspalte. Verwenden Sie -1 für die letzte Datenspalte.	-1
Hat eine Kopfzeile	Boolean	true Verwendung First Row als Spaltenüberschriften und schließt sie von den Daten aus.	true
Ausgeblendete Zeilen ausschließen	Boolean	Überspringen Sie in Excel ausgeblendete Zeilen.	false
Ausgeblendete Spalten ausschließen	Boolean	Ausgeblendete Spalten überspringen.	false
Leere Zeilen ausschließen	Boolean	Entfernen Sie Zeilen, in denen alle Zellen leer sind.	true
Leere Zellen exportieren	Boolean	Leere Zellen mit leeren Zeichenkettenwerten sollten anstatt sie wegzulassen, mit einbezogen werden.	false
Werte als Text exportieren	Boolean	Alle Werte in Zeichenketten umwandeln. false Bewahrt die nativen Typen.	false
Name der Binärdatenausgabe***	String	Binärer Slot speichert serialisierte JSON (PDF4me Rückgaben JSON Bytes).	document

Ausgabe

Ausgabeparameter

Parameter	Typ	Beschreibung	Beispiel
Erfolg	Boolean	PDF4me Betriebsstatus - Boolean Flagge, die den Erfolg oder Misserfolg des Zeilenextraktionsprozesses anzeigt. PDF4me Rückgaben true für einen erfolgreichen Betrieb und false für etwaige Fehler	true
originalFileName	String	Dateiname des ursprünglichen Excel-Dokuments - Der Name der Excel-Eingabedatei	myExcelFile.xlsx
Arbeitsblattname	String	Name des Arbeitsblatts - Der Name des Arbeitsblatts, aus dem die Zeilen extrahiert wurden	First Worksheet
hatHeaderRow	Boolean	Status der Kopfzeile - Gibt an, ob die erste Zeile als Überschriften behandelt wurde. true falls Header verwendet wurden, false ansonsten	true
erste Zeile	Nummer	Index der ersten Zeile (beginnend bei 0) - Der 0-basierte Index der ersten extrahierten Zeile	0
letzte Zeile	Nummer	Index der letzten Zeile (beginnend bei 0) - Der nullbasierte Index der zuletzt extrahierten Zeile. -1 zeigt die Extraktion bis zur letzten Datenzeile an	2
ersteSpalte	Nummer	Index der ersten Spalte (beginnend bei 0) - Der nullbasierte Index der ersten extrahierten Spalte (0 = Spalte A)	0
letzteSpalte	Nummer	Index der letzten Spalte (beginnend bei 0) - Der 0-basierte Index der zuletzt extrahierten Spalte. -1 gibt an, dass die Daten bis zur letzten Spalte extrahiert wurden.	-1
leere Zeilen ausschließen	Boolean	Ausschluss leerer Zeilen - Gibt an, ob leere Zeilen ausgeschlossen wurden. true falls ausgeschlossen, false falls enthalten	true
AusgeblendeteZeilen ausschließen	Boolean	Ausschluss versteckter Zeilen - Gibt an, ob ausgeblendete Zeilen ausgeschlossen wurden. true falls ausgeschlossen, false falls enthalten	true
AusgeblendeteSpalten ausschließen	Boolean	Ausblenden von Spalten - Gibt an, ob ausgeblendete Spalten ausgeschlossen wurden. true falls ausgeschlossen, false falls enthalten	true
exportValuesAsText	Boolean	Textexportmodus - Gibt an, ob Werte als Text exportiert wurden. true Wenn es zu Strings gezwungen wird, false wenn native Typen erhalten bleiben	false
exportEmptyCells	Boolean	Export leerer Zellen - Gibt an, ob leere Zellen exportiert wurden. true falls mit leeren Zeichenketten angegeben, false wenn weggelassen	false
exportAsObject	Boolean	Objektexportmodus - Gibt an, ob die Daten im Objektformat exportiert wurden.	false
hyperlinkFormat	String	Hyperlink-Format - Format für Hyperlinks in den extrahierten Daten. Werte: "Text", "URL" usw.	Text
Kultur	String	Kultur-/Lokalisierungscode - Kulturcode, der für die Datenextraktion verwendet wurde (z. B. "en-US", "de-DE", "fr-FR")	en-US
extrahierte Zeilen	Nummer	Anzahl der extrahierten Zeilen - Die Gesamtzahl der erfolgreich extrahierten Zeilen	1
extrahierte Daten	Object	Extrahiertes Datenobjekt - Verschachteltes Objekt, das die extrahierten Zeilendaten mit dem rowData-Array enthält.	{"rowData": [{"Column1": 1, "First Name": "Dulce"}]}
Nachricht	String	Operationsmeldung - Eine beschreibende Meldung, die das Ergebnis der Zeilenextraktion angibt, einschließlich der Anzahl der extrahierten Zeilen und des Tabellenblattnamens.	Successfully extracted 1 row(s) from worksheet 'First Worksheet'

N8N Maßnahmenreaktion

Der PDF4me Zeilen aus dem Excel-Arbeitsblatt extrahieren API Die Antwort kann in verschiedenen Formaten angezeigt werden. Wählen Sie die Ansicht, die Ihren Bedürfnissen am besten entspricht:

JSON

JSON Antwortformat

Das Rohmaterial JSON Antwort von der 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

Tabellenansicht

Antwortdaten in strukturierter Tabellenform:

Parameter	Wert
Erfolg	true
originalFileName	myExcelFile.xlsx
Arbeitsblattname	First Worksheet
hatHeaderRow	true
erste Zeile	0
letzte Zeile	2
ersteSpalte	0
letzteSpalte	-1
leere Zeilen ausschließen	true
AusgeblendeteZeilen ausschließen	true
AusgeblendeteSpalten ausschließen	true
exportValuesAsText	false
exportEmptyCells	false
exportAsObject	false
hyperlinkFormat	Text
Kultur	en-US
extrahierte Zeilen	1
extrahierte Daten	Objekt, das das rowData-Array enthält
Nachricht	Successfully extracted 1 row(s) from worksheet 'First Worksheet'

Extrahiertes Datenobjekt:

Parameter	Wert
dokumentieren	null
Dateiname	null
Erfolg	true
Fehlermeldung	null
rowData	Array der extrahierten Zeilenobjekte

Hinweis: rowData enthält die extrahierten Zeilenobjekte als Array mit den Spaltenüberschriften als Schlüssel.

Schema

Schemaansicht

Die Datenstruktur und die Datentypen der Antwort:

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'

Typenindikatoren:

• T = String (Text)
• # = Zahl
• ☑ = Boolean
• [] = Array
• {} = Object
• null = Nullwert

Binary

Binärdatenansicht

Die extrahierten Daten werden zurückgegeben als JSON in der Antwort. Greifen Sie direkt auf die Zeilendaten zu. extractedData.rowData Array:

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

Datenzugriff:

• Zeilendatenarray: $json.extractedData.rowData
• Einzelne Zeilen: $json.extractedData.rowData[0]
• Spaltenwerte: $json.extractedData.rowData[0]["First Name"]
• JSON AntwortVerfügbar als strukturierte Version JSON In n8n Antwort

Anwendungsfälle

• API Futter: Gefilterte Zeilen extrahieren und direkt an senden REST Endpunkte oder Webhook-Konsumenten.
• Datenbankaufnahme: Excel-Berichte in strukturierte Formate umwandeln JSON nächtlich vor dem Einfügen in SQL/NoSQL-Speicher.
• Validierung & Qualitätssicherung: Bereiche für Regelprüfungen abrufen, Benachrichtigungen senden oder andere Arbeitsabläufe anreichern, ohne manuell exportieren zu müssen.

Hilfe erhalten

n8n Integration Guiden8n SampleGetting Started