Passa al contenuto principale

Estrai i fogli di lavoro da Excel In Power Automate

PDF4me Estrarre i fogli di lavoro è un Power Automate azione che converte uno, diversi o tutti i fogli di lavoro da un Excel quaderno di lavoro in strutturato JSON, utilizzando la prima riga di ogni foglio come intestazione di colonna. Usalo per alimentare i dati del foglio di lavoro in un API, un'importazione di database o un JSON archivio senza scrivere alcun codice di analisi.

Cosa fa questa azione

PDF4me Estrarre i fogli di lavoro prende un Excel file più una selezione facoltativa del foglio di lavoro e restituisce un JSON oggetto con una chiave per ogni nome di foglio di lavoro estratto. Ogni chiave contiene un array di oggetti riga creati a partire dalla riga di intestazione e dalle righe di dati di quel foglio, con numeri, date, valori booleani e testo conservati nel loro formato nativo. JSON Tipi.

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

Autenticazione del tuo API Richiesta

Per accedere al PDF4me Web API Attraverso Power Automate, ogni richiesta deve includere un valido API chiave. L'autenticazione convalida la tua identità e consente al connettore di raggiungere PDF4me'S Excel Servizio di estrazione di fogli di lavoro dal tuo flusso di lavoro.

Informazioni importanti da non perdere

La selezione vuota significa tutti i fogli di lavoro
Lascia vuoti i campi "Nomi dei fogli di lavoro" e "Indici dei fogli di lavoro" per estrarre tutti i fogli di lavoro della cartella di lavoro in un'unica chiamata.
Le selezioni di nome e indice si combinano come un'unione
Se entrambi i campi sono compilati, ogni foglio di lavoro corrispondente a uno dei due elenchi viene estratto una sola volta, non solo quelli corrispondenti a entrambi.
Gli indici dei fogli di lavoro sono basati su 0
L'indice 0 corrisponde al primo foglio di lavoro, l'indice 1 al secondo e così via. Il confronto tra i nomi dei fogli di lavoro distingue tra maiuscole e minuscole.
Azione Power Automate PDF4me Excel Extract Worksheets che mostra i campi Contenuto file, Nome file, Nomi fogli di lavoro e Indici fogli di lavoro

Associa il contenuto del file e il nome del file da un'azione precedente, quindi imposta i nomi dei fogli di lavoro e/o gli indici dei fogli di lavoro, oppure lasciali entrambi vuoti per estrarre tutti i fogli.

Parametri

Necessario: Il contenuto e il nome del file devono essere sempre specificati. I nomi dei fogli di lavoro e gli indici dei fogli di lavoro sono facoltativi; lasciandoli vuoti verranno estratti tutti i fogli di lavoro.

ParametroNecessarioCosa faEsempio
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

Quali informazioni restituisce l'estratto dei fogli di lavoro?

CampoTipoCosa contiene
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": []
}

Esempio di contenuto del documento decodificato:

{
"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}
]
}

Messaggi di errore comuni

Messaggio di erroreCausaSoluzione
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.

Come impostare i fogli di lavoro di estrazione in Power Automate?

  1. Aggiungere PDF4meEstrarre i fogli di lavoro al tuo Power Automate fluire.
  2. Mappa Contenuto del file E Nome del file da un'azione precedente, come ad esempio SharePoint O OneDrive Recupera il contenuto del file.
  3. Impostato Nomi dei fogli di lavoro, Indici dei fogli di lavoro, entrambi, oppure lasciare entrambi vuoti per estrarre tutti i fogli di lavoro.
  4. Avvia il flusso. La prima riga di ogni foglio di lavoro selezionato diventa la JSON chiavi e il risultato viene restituito come document, un codificato in Base64 JSON oggetto identificato dal nome del foglio di lavoro.

Quando è preferibile utilizzare i nomi dei fogli di lavoro anziché gli indici?

Utilizzo Nomi dei fogli di lavoro quando i fogli di destinazione hanno nomi stabili e noti, come "Riepilogo" o "Dati cliente", poiché la selezione rimane corretta anche se l'ordine dei fogli cambia. Utilizzare Indici dei fogli di lavoro Quando un flusso genera cartelle di lavoro con un ordine di fogli prevedibile ma nomi variabili. Impostando entrambe le opzioni si estrae l'unione delle due selezioni, in modo che la sovrapposizione tra di esse non duplichi un foglio di lavoro nell'output.

Configurazioni tipiche

Esempi di flusso di lavoroCommon Power Automate flow patterns using Extract Worksheets from Excel.
Cartella di lavoro multi-foglio per API foraggio
  1. Un flusso si attiva quando un foglio multiplo Excel La cartella di lavoro viene caricata su un SharePoint Cartella "Esportazione dati".
  2. L'operazione Get File Content recupera la cartella di lavoro.
  3. Il programma Extract Worksheets viene eseguito lasciando vuoti sia il campo "Nome del foglio di lavoro" che il campo "Indice del foglio di lavoro" per convertire tutti i fogli.
  4. Analizza JSON elabora il risultato e un ciclo Applica a ogni invia i dati di ogni foglio di lavoro al proprio API punto finale.
Programmato JSON archivio
  1. Un trigger di ricorrenza avvia un flusso di archiviazione mensile.
  2. Recupera il contenuto del file, ovvero il progetto completato Excel file da SharePoint.
  3. Extract Worksheets converte ogni cartella di lavoro in JSON con tutti i fogli inclusi.
  4. IL JSON L'output viene memorizzato in Azure Blob Storage oppure SharePoint accanto al file originale archiviato.
Esportazione selettiva dei clienti
  1. L'invio di un modulo Microsoft Forms richiede l'esportazione di dati specifici per il cliente.
  2. Get File Content recupera la cartella di lavoro principale da un ambiente protetto SharePoint biblioteca.
  3. La funzione "Estrai fogli di lavoro" viene eseguita impostando i nomi dei fogli di lavoro solo sui fogli che il client è autorizzato a visualizzare, ad esempio "Riepilogo,DatiCliente".
  4. Il risultato JSON viene inviato via e-mail al richiedente, escludendo completamente dall'esportazione i fogli interni non correlati.

Consigli pratici

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.

Foglio riassuntivo

CampoValore
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

Domande frequenti

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.

Casi d'uso e applicazioni industriali

Casi d'uso per l'integrazione di sistemi e IT

  • Migrazione del sistemaEsporta intere cartelle di lavoro Excel in formato JSON per le migrazioni di sistema.
  • Integrazione multi-API: Invia fogli di lavoro diversi a endpoint API diversi
  • Backup dei dati: Crea backup JSON di file Excel con più fogli
  • Migrazione al cloudConvertire le cartelle di lavoro di Excel in formato JSON per l'archiviazione nel cloud.

Azioni correlate

Stessa attività su altre piattaforme

Richiedi assistenza