Zum Hauptinhalt springen

Arbeitsblätter extrahieren aus Excel In Power Automate

PDF4me Arbeitsblätter extrahieren ist ein Power Automate Aktion, die ein, mehrere oder alle Arbeitsblätter von einem Excel Arbeitsbuch in strukturierte JSONVerwenden Sie dabei die erste Zeile jedes Tabellenblatts als Spaltenüberschriften. Nutzen Sie es, um Tabellenblattdaten in ein System einzuspeisen. API, ein Datenbankimport oder ein JSON Archivierung ohne Programmierung von Parsing-Code.

Was diese Aktion bewirkt

PDF4me Arbeitsblätter extrahieren nimmt ein Excel Datei plus eine optionale Arbeitsblattauswahl und gibt eine zurück JSON Jedes Objekt enthält einen Schlüssel pro extrahiertem Tabellenblattnamen. Jeder Schlüssel enthält ein Array von Zeilenobjekten, die aus der Kopfzeile und den Datenzeilen des jeweiligen Tabellenblatts erstellt wurden, wobei Zahlen, Datumsangaben, boolesche Werte und Text in ihrer ursprünglichen Form erhalten bleiben. JSON Typen.

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

Authentifizierung Ihres API Anfrage

Um auf die PDF4me Web API durch Power AutomateJede Anfrage muss einen gültigen API Schlüssel. Die Authentifizierung bestätigt Ihre Identität und ermöglicht dem Connector die Verbindung. PDF4me'S Excel Arbeitsblattextraktionsdienst aus Ihrem Workflow.

Wichtige Fakten, die Sie nicht verpassen sollten

Leere Auswahl bedeutet alle Arbeitsblätter
Lassen Sie sowohl die Felder „Arbeitsblattnamen“ als auch „Arbeitsblattindizes“ leer, um alle Arbeitsblätter der Arbeitsmappe in einem einzigen Aufruf zu extrahieren.
Namens- und Indexauswahlen werden zu einer Union kombiniert.
Wenn beide Felder ausgefüllt sind, wird jedes Arbeitsblatt, das einer der beiden Listen entspricht, einmal extrahiert, nicht nur diejenigen, die beiden entsprechen.
Die Indizes der Arbeitsblätter beginnen bei 0.
Index 0 ist das erste Arbeitsblatt, Index 1 das zweite usw. Beim Vergleich der Arbeitsblattnamen wird zwischen Groß- und Kleinschreibung unterschieden.
Die Power Automate PDF4me Excel-Aktion „Arbeitsblätter extrahieren“ zeigt die Felder „Dateiinhalt“, „Dateiname“, „Arbeitsblattnamen“ und „Arbeitsblattindizes“ an.

Dateiinhalt und Dateiname aus einer vorherigen Aktion zuordnen, dann Arbeitsblattnamen und/oder Arbeitsblattindizes festlegen oder beides leer lassen, um jedes Blatt zu extrahieren.

Parameter

Erforderlich: Dateiinhalt und Dateiname müssen immer angegeben werden. Arbeitsblattnamen und Arbeitsblattindizes sind optional; wenn diese Felder leer gelassen werden, werden alle Arbeitsblätter extrahiert.

ParameterErforderlichWas es tutBeispiel
File ContentRequiredBase64 or buffer content of the source Excel file, typically mapped from a prior action like SharePoint or OneDrive Get File Content.[File Content from Get File]
File NameConditionalName of the Excel file including its extension. Shown as a plain field in the connector UI and used for processing and output naming; supply it even though the connector does not mark it with an asterisk.data.xlsx
Worksheet NamesOptionalComma-separated list of worksheet names to extract. Case-sensitive, and combines with Worksheet Indexes as a union when both are set.Employees,Sales
Worksheet IndexesOptionalComma-separated list of 0-based worksheet indexes to extract, for example "0,2,4" for the first, third, and fifth sheets.0,2,4

Was gibt „Arbeitsblätter extrahieren“ zurück?

FeldTypWas es enthält
documentBase64The extracted JSON data as a byte array, saved as a .txt file, keyed by worksheet name.
FileNameStringOutput file name with a .txt extension.
SuccessBooleantrue when extraction completed, false if the request failed validation or processing.
Error MessageStringDescription of what went wrong, null when Success is true.
ErrorsArrayDetailed error entries, empty when Success is true.
{
"document": "[Base64 JSON Data]",
"FileName": "report.txt",
"Success": true,
"ErrorMessage": null,
"Errors": []
}

Beispiel für dekodierten Dokumentinhalt:

{
"Employees": [
{"Name": "John Doe", "Age": 30, "Department": "IT"},
{"Name": "Jane Smith", "Age": 28, "Department": "HR"}
],
"Sales": [
{"Product": "Widget", "Units": 100, "Revenue": 2500.00},
{"Product": "Gadget", "Units": 75, "Revenue": 1875.00}
]
}

Häufige Fehlermeldungen

FehlermeldungUrsacheLösung
Request is emptyRequest object is null.Provide a valid request object.
Document is emptyDocument object is null or DocData is null.Provide a valid Excel document.
Workbook contains no worksheetsExcel file has 0 worksheets.Provide a valid Excel file with at least one worksheet.
Invalid worksheet selectionWorksheet name does not exist or index is out of range.Use valid worksheet names or 0-based indexes.
Available worksheets in workbook (X total)Informational message appended when worksheet selection validation fails.Review worksheet names or indexes and use valid values from the X available worksheets listed.

Wie richte ich Extrakt-Arbeitsblätter ein in Power Automate?

  1. Hinzufügen PDF4meArbeitsblätter extrahieren zu Ihrem Power Automate fließen.
  2. Karte Dateiinhalt Und Dateiname aus einer vorherigen Aktion, wie zum Beispiel SharePoint oder OneDrive Dateiinhalt abrufen.
  3. Satz Arbeitsblattnamen, Arbeitsblattverzeichnisse, beides, oder lassen Sie beide leer, um alle Arbeitsblätter zu extrahieren.
  4. Führen Sie den Flow aus. Die erste Zeile jedes ausgewählten Arbeitsblatts wird zur JSON Schlüssel, und das Ergebnis wird zurückgegeben als document, ein Base64-kodierter JSON Objekt, das über den Namen des Arbeitsblatts identifiziert wurde.

Wann sollte ich Arbeitsblattnamen und wann Arbeitsblattindizes verwenden?

Verwenden Arbeitsblattnamen Wenn die Zieltabellenblätter stabile, bekannte Namen haben, wie z. B. „Zusammenfassung“ oder „Kundendaten“, bleibt die Auswahl auch dann korrekt, wenn sich die Reihenfolge der Tabellenblätter ändert. Arbeitsblattverzeichnisse Wenn ein Workflow Arbeitsmappen mit vorhersehbarer Blattreihenfolge, aber variablen Namen erzeugt, werden durch die Einstellung „Beide extrahieren“ die beiden Auswahlen zusammengeführt, sodass Überschneidungen keine doppelten Arbeitsblätter in der Ausgabe erzeugen.

Typische Konfigurationen

Workflow-BeispieleCommon Power Automate flow patterns using Extract Worksheets from Excel.
Mehrblatt-Arbeitsmappe API füttern
  1. Ein Datenfluss wird ausgelöst, wenn ein mehrschichtiges Dokument Excel Die Arbeitsmappe wird hochgeladen auf einen SharePoint Ordner „Datenexport“.
  2. Mit „Dateiinhalt abrufen“ wird die Arbeitsmappe abgerufen.
  3. Das Skript „Arbeitsblätter extrahieren“ wird so ausgeführt, dass sowohl die Tabellenblattnamen als auch die Tabellenblattindizes leer bleiben, um jedes Tabellenblatt zu konvertieren.
  4. Parse JSON verarbeitet das Ergebnis, und eine "Auf jedes Blatt anwenden"-Schleife lädt die Daten jedes Arbeitsblatts in sein eigenes API Endpunkt.
Geplant JSON Archiv
  1. Ein Wiederholungstrigger führt einen monatlichen Archivierungsprozess aus.
  2. Mit "Dateiinhalt abrufen" wird das abgeschlossene Projekt abgerufen Excel Dateien von SharePointDie
  3. Die Funktion „Arbeitsblätter extrahieren“ konvertiert jede Arbeitsmappe in JSON inklusive aller Blätter.
  4. Der JSON Die Ausgabe wird in Azure Blob Storage gespeichert oder SharePoint neben der ursprünglichen archivierten Datei.
Selektiver Kundenexport
  1. Eine Microsoft Forms-Übermittlung fordert einen kundenspezifischen Datenexport an.
  2. Get File Content ruft die Masterarbeitsmappe aus einem sicheren Speicher ab. SharePoint Bibliothek.
  3. Die Funktion "Arbeitsblätter extrahieren" wird so ausgeführt, dass nur die Arbeitsblattnamen auf die Blätter festgelegt sind, die der Client einsehen darf, z. B. "Summary,ClientData".
  4. Das Ergebnis JSON wird per E-Mail an den Anfragenden gesendet, wobei nicht zugehörige interne Tabellenblätter vollständig aus dem Export ausgeschlossen werden.

Praktische Tipps

Leave both selection fields blank for a full export
Extracting every worksheet in one call is simpler than chaining several Extract Worksheets actions when a flow needs the whole workbook as JSON.
Match Worksheet Names exactly, including case
Worksheet name comparison is case-sensitive. A mismatch returns an invalid worksheet selection error even if the name looks correct at a glance.
Remember Worksheet Indexes start at 0
Index 0 is the first sheet, not the second. Off-by-one index values are a common source of the wrong worksheet being extracted.
Combining names and indexes extracts a union, not an intersection
If a worksheet matches either list, it is included once. Use only one selection method if you need precise, predictable output.
Parse JSON before looping through worksheets
The output document decodes to an object keyed by worksheet name, so a Parse JSON action followed by Apply to each on the object's keys is the standard pattern for per-sheet processing.

Spickzettel

FeldWert
ActionExtract Worksheets
File ContentMapped from a prior file-retrieval action
File Namee.g. data.xlsx
Worksheet NamesComma-separated, case-sensitive, or blank
Worksheet Indexes0-based, comma-separated, or blank
Blank + blankExtracts all worksheets
Both filledUnion of name matches and index matches
Outputdocument (Base64 JSON, .txt), FileName, Success, Error Message, Errors

Häufig gestellte Fragen

How do I convert an Excel worksheet to JSON in Power Automate?+
Add the PDF4me Extract Worksheets action, map File Content and File Name from a prior action, then set Worksheet Names or Worksheet Indexes to choose which sheets to convert. Leaving both blank extracts every worksheet, returning a JSON document keyed by worksheet name. See the connector reference below for the full action list.
What happens if I leave Worksheet Names and Worksheet Indexes both blank?+
The action extracts every worksheet in the workbook and returns them all as JSON, one array per worksheet name in the output document. This is the simplest setup for a full workbook-to-JSON export.
Can I select worksheets by name and by index in the same request?+
Yes. If both Worksheet Names and Worksheet Indexes are provided, the action extracts the union of the two selections, so any worksheet matching either the name list or the index list is included once in the result.
Are Worksheet Indexes 0-based or 1-based?+
Worksheet Indexes are 0-based, so index 0 refers to the first worksheet, index 1 to the second, and so on. See <a href="https://learn.microsoft.com/en-us/office/dev/scripts/resources/samples/get-table-data" target="_blank" rel="noopener noreferrer">Microsoft's guide to reading Excel table data</a> for how worksheet and range indexing works natively in Excel.
What does the output JSON look like?+
The output document is a JSON object with one key per extracted worksheet name, and each key holds an array of row objects built from that sheet's header row and data rows, with numbers, dates, booleans, and text preserved in their native JSON types. See <a href="https://learn.microsoft.com/en-us/connectors/pdf4meconnect/" target="_blank" rel="noopener noreferrer">the PDF4me Power Automate connector reference</a> for the full action list.

Branchenspezifische Anwendungsfälle und Anwendungen

Anwendungsfälle für IT- und Systemintegration

  • Systemmigration: Exportieren Sie ganze Excel-Arbeitsmappen als JSON für Systemmigrationen
  • Multi-API-Integration: Unterschiedliche Arbeitsblätter an unterschiedliche API-Endpunkte senden
  • Datensicherung: JSON-Backups von mehrseitigen Excel-Dateien erstellen
  • Cloud-Migration: Excel-Arbeitsmappen für die Cloud-Speicherung in JSON konvertieren

Verwandte Aktionen

Dieselbe Aufgabe auf anderen Plattformen

Hilfe erhalten