Extraer hojas de trabajo de Excel en Power Automate

PDF4me Extraer hojas de trabajo es un Power Automate acción que convierte una, varias o todas las hojas de cálculo de un Excel libro de trabajo en estructura JSON, utilizando la primera fila de cada hoja como encabezados de columna. Úselo para introducir datos de la hoja de cálculo en una API, una importación de base de datos o una JSON archivar sin escribir ningún código de análisis.

Lo que hace esta acción

PDF4me Extraer hojas de trabajo toma un Excel archivo más una selección de hoja de cálculo opcional y devuelve un JSON objeto con una clave por nombre de hoja de cálculo extraído. Cada clave contiene una matriz de objetos de fila construidos a partir de la fila de encabezado y las filas de datos de esa hoja, con números, fechas, booleanos y texto conservados en su formato nativo. JSON tipos.

Entradas de blog relacionadas

Aún no hay ninguna entrada de blog sobre esta función; estará disponible próximamente.

Mientras tanto, echa un vistazo al blog de PDF4me para encontrar tutoriales y flujos de trabajo para todas las plataformas.

Visita el blog →

Autenticando su API Pedido

Para acceder al PDF4me Web API a través de Power Automate, cada solicitud debe incluir un número válido API clave. La autenticación valida su identidad y permite que el conector alcance PDF4me's Excel Servicio de extracción de hojas de cálculo de su flujo.

Get your API Key

Datos importantes que no debes perderte

La selección en blanco significa todas las hojas de cálculo.

Deje los campos Nombres de las hojas de cálculo e Índices de las hojas de cálculo vacíos para extraer todas las hojas de cálculo del libro de trabajo en una sola llamada.

Las selecciones de nombre e índice se combinan como una unión.

Si ambos campos están completos, todas las hojas de cálculo que coincidan con cualquiera de las listas se extraerán una sola vez, no solo las que coincidan con ambas.

Los índices de las hojas de cálculo están basados en cero.

El índice 0 corresponde a la primera hoja de cálculo, el índice 1 a la segunda, y así sucesivamente. La comparación de nombres de hojas de cálculo distingue entre mayúsculas y minúsculas.

Acción de Power Automate PDF4me para extraer hojas de cálculo de Excel que muestra los campos Contenido del archivo, Nombre del archivo, Nombres de las hojas de cálculo e Índices de las hojas de cálculo. — Asigne el contenido y el nombre del archivo a partir de una acción anterior, luego establezca los nombres de las hojas de cálculo y/o los índices de las hojas de cálculo, o déjelos ambos en blanco para extraer todas las hojas.

Parámetros

Requerido: El contenido y el nombre del archivo deben proporcionarse siempre. Los nombres e índices de las hojas de cálculo son opcionales; si se dejan en blanco, se extraerán todas las hojas de cálculo.

Parámetro	Requerido	Lo que hace	Ejemplo
File Content	Required	Base64 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 Name	Conditional	Name 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 Names	Optional	Comma-separated list of worksheet names to extract. Case-sensitive, and combines with Worksheet Indexes as a union when both are set.	`Employees,Sales`
Worksheet Indexes	Optional	Comma-separated list of 0-based worksheet indexes to extract, for example "0,2,4" for the first, third, and fifth sheets.	`0,2,4`

¿Qué devuelve la función Extraer hojas de cálculo?

Campo	Tipo	Lo que contiene
`document`	Base64	The extracted JSON data as a byte array, saved as a .txt file, keyed by worksheet name.
`FileName`	String	Output file name with a .txt extension.
`Success`	Boolean	true when extraction completed, false if the request failed validation or processing.
`Error Message`	String	Description of what went wrong, null when Success is true.
`Errors`	Array	Detailed error entries, empty when Success is true.

JSON Response
Error Response

{
  "document": "[Base64 JSON Data]",
  "FileName": "report.txt",
  "Success": true,
  "ErrorMessage": null,
  "Errors": []
}

Ejemplo de contenido de documento decodificado:

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

{
  "document": null,
  "FileName": null,
  "Success": false,
  "ErrorMessage": "Invalid worksheet selection",
  "Errors": [
    {
      "Code": "WORKSHEET_ERROR",
      "Message": "Worksheet 'NonExistent' not found. Available worksheets in workbook (3 total)"
    }
  ]
}

Mensajes de error comunes

Mensaje de error	Causa	Solución
`Request is empty`	Request object is null.	Provide a valid request object.
`Document is empty`	Document object is null or DocData is null.	Provide a valid Excel document.
`Workbook contains no worksheets`	Excel file has 0 worksheets.	Provide a valid Excel file with at least one worksheet.
`Invalid worksheet selection`	Worksheet 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.

¿Cómo configuro la extracción de hojas de cálculo en Power Automate¿

Agregar PDF4me → Extraer hojas de trabajo a tu Power Automate fluir.
Mapa Contenido del archivo y Nombre del archivo de una acción anterior, como por ejemplo SharePoint o OneDrive Obtener el contenido del archivo.
Colocar Nombres de la hoja de trabajo, Índices de hojas de trabajo, ambos, o déjelos ambos en blanco para extraer todas las hojas de cálculo.
Ejecutar el flujo. La primera fila de cada hoja de cálculo seleccionada se convierte en la JSON claves, y el resultado se devuelve como document, un codificado en Base64 JSON Objeto identificado por el nombre de la hoja de cálculo.

¿Cuándo debo usar nombres de hojas de cálculo en lugar de índices de hojas de cálculo?

Usar Nombres de la hoja de trabajo cuando las hojas de destino tienen nombres estables y conocidos, como "Resumen" o "Datos del cliente", ya que la selección permanece correcta incluso si cambia el orden de las hojas. Índices de hojas de trabajo Cuando un flujo genera libros de trabajo con un orden de hojas predecible pero con nombres de variables. Al configurar ambas opciones, se extrae la unión de las dos selecciones, de modo que la superposición entre ellas no duplica una hoja de cálculo en la salida.

Configuraciones típicas

Ejemplos de flujo de trabajoCommon Power Automate flow patterns using Extract Worksheets from Excel.

Libro de trabajo de varias hojas para API alimentar

Se activa un flujo cuando una hoja múltiple Excel El libro de trabajo se carga en un SharePoint Carpeta "Exportación de datos".
La función Obtener contenido del archivo recupera el libro de trabajo.
La función Extraer hojas de cálculo se ejecuta dejando en blanco tanto los nombres como los índices de las hojas de cálculo para convertir todas las hojas.
Analizar JSON procesa el resultado y un bucle Aplicar a cada uno publica los datos de cada hoja de cálculo en su propio API punto final.

Programado JSON archivo

Un disparador recurrente ejecuta un flujo de archivo mensual.
Obtener contenido del archivo recupera el proyecto completado Excel archivos de SharePoint.
La función Extraer hojas de cálculo convierte cada libro de trabajo a JSON Con todas las sábanas incluidas.
El JSON La salida se almacena en Azure Blob Storage o SharePoint junto al archivo original archivado.

Exportación selectiva de clientes

Un formulario de Microsoft Forms solicita la exportación de datos específicos del cliente.
Obtener contenido del archivo recupera el libro de trabajo maestro de un archivo seguro. SharePoint biblioteca.
La función Extract Worksheets se ejecuta con los nombres de las hojas de cálculo configurados para que solo incluyan las hojas que el cliente está autorizado a ver, por ejemplo, "Resumen,Datos del cliente".
El resultado JSON Se envía por correo electrónico al solicitante, dejando fuera de la exportación por completo las hojas internas no relacionadas.

Consejos prácticos

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.

Hoja de trucos

Campo	Valor
Action	`Extract Worksheets`
File Content	`Mapped from a prior file-retrieval action`
File Name	`e.g. data.xlsx`
Worksheet Names	`Comma-separated, case-sensitive, or blank`
Worksheet Indexes	`0-based, comma-separated, or blank`
Blank + blank	`Extracts all worksheets`
Both filled	`Union of name matches and index matches`
Output	`document (Base64 JSON, .txt), FileName, Success, Error Message, Errors`

Preguntas frecuentes

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.

Casos de uso y aplicaciones en la industria

Casos de uso de integración de sistemas y TI

Migración de sistemasExportar libros de Excel completos como JSON para migraciones de sistemas.
Integración de múltiples API: Enviar diferentes hojas de cálculo a diferentes puntos finales de la API
Copia de seguridad de datos: Crear copias de seguridad JSON de archivos Excel con varias hojas
Migración a la nubeConvertir libros de Excel a JSON para almacenamiento en la nube.