Zeilen extrahieren aus Excel
PDF4me Zeilen extrahieren ist ein REST Endpunkt, der Arbeitsblattzeilen aus einem Excel Arbeitsmappe und gibt sie strukturiert zurück JSONDie POST die .xlsx als Base64 Zu office/ApiV2Excel/ExcelExtractRows, den Arbeitsblatt- und Zeilenbereich im Aktionsobjekt festlegen und die rowData Es gibt ein Array zurück, keine Datei: document wird als Null zurückgegeben.
Wandelt einen Arbeitsblattausschnitt in einen um JSON Array: Jede Zeile wird zu einem Objekt in rowData, bereit für einen Datenbankeintrag, ein API Anruf oder Bericht. Es ist das schreibgeschützte Gegenstück zu Zeilen hinzufügen und Zeilen aktualisieren, und das API-seitiges Äquivalent zum Exportieren Excel Daten ohne Öffnen ExcelEs wird keine veränderte Datei erzeugt.
Authentifizierung Ihres API Anfrage
Jeder PDF4me REST Der Anruf muss Ihre API Schlüssel im Authorization Header als Basic Auth. Ihren Schlüssel erhalten oder ändern Sie ihn im Entwickler-Dashboard.
Endpunkt
office/ApiV2Excel/ExcelExtractRowsWichtige Fakten, die Sie nicht verpassen sollten
dokumentieren Und fileName wird absichtlich als Nullwert zurückgegeben; Code, der einen Wert erwartet Base64 Die Datei wird beschädigt.HTTP aufstellen
Verfahren: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractRows
Inhaltstyp: application/json
Authorization: Basic <Ihre PDF4me API Schlüssel>
Die Antwort lautet: JSON: Überprüfen Sie die success Flagge, dann iteriere die rowData Array. Es ist keine Datei zum Dekodieren vorhanden.
Worin unterscheidet sich „Zeilen extrahieren“ von den anderen Funktionen? Excel Zeilenaktionen?
Die Zeilenfamilie umfasst die Optionen Schreiben, Überschreiben und Lesen. Wählen Sie die Option je nachdem, was mit dem Arbeitsbuch geschehen soll.
| Handlung vs. Verhalten | Was es mit dem Arbeitsbuch macht | Was Sie zurückbekommen |
|---|---|---|
| Zeilen extrahieren (dieser Endpunkt) | Nichts, nur lesbar | A rowData JSON Array, ein Objekt pro Zeile |
| Zeilen hinzufügen | Fügt neue Zeilen hinzu oder fügt sie ein | Die geänderte Arbeitsmappe als Base64 |
| Zeilen aktualisieren | Überschreibt Werte in bestehenden Zeilen | Die geänderte Arbeitsmappe als Base64 |
| Zeilen löschen | Entfernt Zeilen | Die geänderte Arbeitsmappe als Base64 |
API Körperfelder
| Parameter | Erforderlich | Typ | Was es tut | Beispiel |
|---|---|---|---|---|
document | Required | object | Document reference carrying Name, the Excel filename with its extension. | { "Name": "data.xlsx" } |
docContent | Required | string | Base64-encoded bytes of the workbook to read. | UEsDBBQABgAIAAAA... |
extractRowsToExcelAction | Required | object | Action configuration object. An empty object is valid and reads the default worksheet. | {} |
worksheetName | Optional | string | Inside the action object. Target worksheet by name. Names are matched exactly, so a typo silently misses the sheet. | Sheet1 |
worksheetIndex | Optional | number | Inside the action object. Target worksheet by position. The extraction engine counts 0-based, so 0 is the first sheet. | 0 |
fromRow / toRow | Optional | number | Inside the action object. Row range to extract. The engine counts rows 0-based with -1 meaning to the last data row, per the shared engine documented on the n8n Extract Rows action. | 0, -1 |
cultureName | Optional | string | Inside the action object. Culture used when serializing dates and numbers, for example en-US or de-DE. | en-US |
Beispielnutzlasten
Lesen Sie das Standardarbeitsblatt
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractRowsToExcelAction": {}
}
Lesen Sie ein benanntes Arbeitsblatt mit kultursensiblen Werten.
{
"document": { "Name": "sales.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractRowsToExcelAction": {
"worksheetName": "Q3",
"cultureName": "en-US"
}
}
Tipps zur Postboten-Abholung
Beispiel für curl
curl -X POST https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractRows \
-H "Content-Type: application/json" \
-H "Authorization: Basic YOUR_API_KEY" \
-d '{
"document": { "Name": "data.xlsx" },
"docContent": "'"$(base64 -w 0 data.xlsx)"'",
"extractRowsToExcelAction": { "worksheetName": "Sheet1" }
}' \
--output response.json
Was bedeutet das? API zurückkehren?
A JSON Ergebnis, dessen Nutzlast die rowData Array.
| Feld | Typ | Was es enthält |
|---|---|---|
rowData | Array of objects | The primary output. Each entry is one extracted row as a JSON object, with column names or indexes as keys. |
success | Boolean | true when extraction succeeded. Check this before iterating rowData. |
document | null | Null for this endpoint: no modified file is produced. Present only because the office family shares one response shape. |
fileName | null | Null for this endpoint, for the same reason as document. |
errorMessage | String | Populated when success is false: a missing worksheet, invalid Base64, or a corrupted workbook. |
{
"document": null,
"fileName": null,
"success": true,
"errorMessage": null,
"rowData": [
{ "ColumnA": "value1", "ColumnB": "value2" },
{ "ColumnA": "value3", "ColumnB": "value4" }
]
}
Codebeispiele
Excel Büroendpunkte sind noch nicht durch die pro-language Beispielordner; das Beispiel-Repository enthält das Anfragemuster, das von jedem verwendet wird PDF4me Endpunktfamilie:
Häufig gestellte Fragen
Warum extrahieren Excel verschenkt API statt manuell?
Die manuelle Methode besteht darin, die Arbeitsmappe zu öffnen, den Bereich auszuwählen, ihn irgendwohin zu kopieren und ihn dann manuell umzuformen – einmal pro Datei, einmal pro Aktualisierung. API liest dieselben Zeilen wie eine deterministische Anfrage und gibt sie Ihnen zurück JSON dass irgendein language wird nativ analysiert, ohne dass Excel Installation auf dem Server. Da der Quellcode ein Standard bleibt. Büro geöffnet XML Die Arbeitsmappe und der Vorgang sind schreibgeschützt, der gleiche Aufruf kann jedoch gefahrlos nach einem Zeitplan für Live-Dateien ausgeführt werden.