Extraer hoja de cálculo de un archivo de Excel usando n8n acción
PDF4me Extraer hojas de cálculo de Excel convierte hojas de cálculo completas de libros de Excel en hojas de cálculo estructuradas JSON a través de n8n flujos de trabajo de automatización. Procesar archivos de Excel mediante n8n disparadores, datos binarios, cadenas base64 o público URLs para extraer datos completos de la hoja de cálculo con detección automática de encabezado, selección flexible de la hoja de cálculo por nombre o índice, soporte para varias hojas y preservación del tipo de datos. Esta solución es ideal para la exportación completa de datos, procesamiento de varias hojas, API integración, migración de bases de datos y conversión integral de Excel aJSON Flujos de trabajo de transformación que requieren la extracción completa de la hoja de cálculo con una salida estructurada y una integración perfecta.
Configuración
Añade el PDF4me Nodo "Extraer hojas de cálculo" a su n8n flujo de trabajo y configure los parámetros necesarios. Para obtener instrucciones de configuración inicial, consulte nuestra n8n Guía de integración.
Requisitos previos:
- PDF4me API credenciales
- n8n acceso al flujo de trabajo
Configuración:
- Agregar PDF4me nodo a flujo de trabajo
- Seleccione la acción "Extraer hoja de cálculo del archivo de Excel".
- Configure los parámetros de entrada (véase más abajo).

Parámetros
Lista completa de parámetros para la acción Extraer hojas de cálculo. Configure estos parámetros para controlar la extracción de hojas de cálculo.
Importante: Los parámetros marcados con un asterisco (***) son obligatorios y deben proporcionarse para que la acción funcione correctamente.
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Tipo de datos de entrada*** | String | Selección del formato de entrada de Excel • Elija el formato de entrada de datos de Excel. • PDF4me admite varios tipos de entrada • Opciones: Datos binarios, Base64 Cuerda o URL | Binary Data |
| Campo binario de entrada*** | Binario | Entrada de archivo binario de Excel (Obligatorio si se trata de datos binarios) • Referencia al archivo Excel (.xlsx, .xls) del archivo anterior. n8n carga de nodos o archivos • PDF4me Procesa archivos binarios de Excel con detección automática de formato. • Obligatorio cuando el tipo de datos de entrada es "Datos binarios". | {{ $binary.data }} |
| Contenido de Excel en Base64*** | String | Base64 Entrada de Excel codificada (Obligatorio si se trata de una cadena Base64) • Proporcione el contenido de Excel (.xlsx, .xls) como una cadena codificada en base64. • PDF4me decodifica y procesa automáticamente el contenido de Excel. • Obligatorio cuando el tipo de datos de entrada es "Base64 Cadena" | UEsDBBQABgAI... |
| URL de Excel*** | String | Excel público URL Aporte (Obligatorio si se trata de una URL) • Proporcionar un permiso público/abierto URL al archivo de Excel (.xlsx, .xls) • PDF4me descarga y procesa el archivo de Excel desde el proporcionado URL • Obligatorio cuando el tipo de datos de entrada es "URL" | https://abc.com/data.xlsx |
| Nombre de Excel*** | String | Nombre del archivo de entrada de Excel • Especifique el nombre del archivo Excel de entrada con la extensión adecuada (.xlsx, .xls). • PDF4me Utiliza esto para la detección de formato y la optimización del procesamiento. | data.xlsx |
| Nombres de la hoja de trabajo | String | Nombres de hojas de trabajo separados por comas • Lista de nombres de hojas de cálculo para extraer • Formato: "Hoja1,Resumen,Informe" • Lógica de selecciónSi se proporcionan → Extraer las hojas de cálculo con nombre. Si se proporcionan tanto WorksheetNames como WorksheetIndexes → Extraer las hojas de cálculo que coincidan con CUALQUIERA (unión). Si NO se proporciona NINGUNO → Extraer TODAS las hojas de cálculo. • Nombres de hojas de cálculo que distinguen entre mayúsculas y minúsculas | Employees,Sales |
| Índices de hojas de trabajo | String | Índices separados por comas (basados en 0) • Lista de índices de hojas de cálculo para extraer • Formato: "0,1,2" (Índice 0 = primera hoja, Índice 1 = segunda hoja, etc.) • Lógica de selección: Si se proporciona → Extraer esas hojas de cálculo indexadas. Si se proporcionan ambos parámetros → Extraer las hojas de cálculo que coincidan CON CUALQUIERA (unión) • Indexación basada en 0: Índice 0 = primera hoja de cálculo | 0,2,4 |
Producción
Parámetros de salida
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Nombre de archivo json | String | JSON nombre del archivo de salida - El nombre del generado JSON archivo que contiene los datos de la hoja de cálculo extraídos | excel_extracted.json |
| nombreArchivotxt | String | nombre del archivo de salida TXT - El nombre del archivo TXT generado que contiene los datos de la hoja de cálculo extraídos. | excel_extracted.txt |
| Tamaño del archivo json | Número | JSON Tamaño del archivo en bytes - El tamaño de la JSON archivo de salida en bytes | 206933 |
| Tamaño del archivo txt | Número | Tamaño del archivo TXT en bytes - El tamaño del archivo de salida TXT en bytes | 206933 |
| éxito | Boolean | PDF4me estado de operación - Boolean Bandera que indica si el proceso de extracción de la hoja de cálculo se realizó correctamente o no. PDF4me devoluciones true para operaciones exitosas y false por cualquier error | true |
| nombre de archivo original | String | Nombre del archivo del documento original de Excel - El nombre del archivo de documento Excel de entrada | myExcelFile.xlsx |
| extractoPor | String | Método de extracción - Método utilizado para identificar las hojas de cálculo que se extraerán. Valores: "name" si se extraen por nombre de hoja de cálculo, "index" si se extraen por índice de hoja de cálculo. | name |
| nombres de las hojas de cálculo | String | Nombres de hojas de cálculo extraídos - Lista separada por comas de los nombres de las hojas de cálculo que se extrajeron | Sheet2 |
| datos analizados | Object | Datos de la hoja de cálculo analizados - Object Contiene datos de hojas de cálculo extraídos con los nombres de las hojas de cálculo como claves y matrices de objetos de fila como valores. Cada objeto de fila contiene los encabezados de columna como claves y los valores de las celdas como valores. | {"Sheet2": [{"First Name": "Dulce", "Age": 32}]} |
| mensaje | String | Mensaje de operación - Mensaje descriptivo que indica el resultado de la operación de extracción de la hoja de cálculo, incluyendo los nombres de las hojas de cálculo y el método de extracción. | Successfully extracted worksheet(s) 'Sheet2' by name and created JSON and TXT outputs |
N8N Respuesta a la acción
El PDF4me Extraer la hoja de cálculo del archivo de Excel API Devuelve una respuesta que se puede visualizar en varios formatos. Elija la vista que mejor se adapte a sus necesidades:
- JSON
- Table
- Schema
- Binary
JSON Formato de respuesta
El crudo JSON respuesta de la API:
[
{
"jsonFileName": "excel_extracted.json",
"txtFileName": "excel_extracted.txt",
"jsonFileSize": 206933,
"txtFileSize": 206933,
"success": true,
"originalFileName": "myExcelFile.xlsx",
"extractBy": "name",
"worksheetNames": "Sheet2",
"parsedData": {
"Sheet2": [
{
"": 1,
"First Name": "Dulce",
"Last Name": "Abril",
"Gender": "Female",
"Country": "United States",
"Age": 32,
"Date": "15/10/2017",
"Id": 1562
},
{
"": 2,
"First Name": "Mara",
"Last Name": "Hashimoto",
"Gender": "Female",
"Country": "Great Britain",
"Age": 25,
"Date": "16/08/2016",
"Id": 1582
},
{
"": 3,
"First Name": "Philip",
"Last Name": "Gent",
"Gender": "Male",
"Country": "France",
"Age": 36,
"Date": "21/05/2015",
"Id": 2587
}
]
},
"message": "Successfully extracted worksheet(s) 'Sheet2' by name and created JSON and TXT outputs"
}
]
Vista de tabla
Datos de respuesta en formato de tabla estructurada:
| Parámetro | Valor |
|---|---|
| Nombre de archivo json | excel_extracted.json |
| nombreArchivotxt | excel_extracted.txt |
| Tamaño del archivo json | 206933 |
| Tamaño del archivo txt | 206933 |
| éxito | true |
| nombre de archivo original | myExcelFile.xlsx |
| extractoPor | name |
| nombres de las hojas de cálculo | Sheet2 |
| datos analizados | Objeto con nombres de hojas de cálculo como claves y matrices de filas como valores. |
| mensaje | Successfully extracted worksheet(s) 'Sheet2' by name and created JSON and TXT outputs |
Estructura de datos analizada:
| Nombre de la hoja de trabajo | Datos de fila |
|---|---|
| Hoja2 | Matriz de objetos de fila con encabezados de columna como claves |
Nota: La acción devuelve dos salidas binarias. data_json (JSON formato) y data_txt (formato TXT), ambos contienen los mismos datos de la hoja de cálculo extraídos. El parsedData El objeto proporciona acceso directo a los datos extraídos en el JSON respuesta.
Vista de esquema
Estructura de datos y tipos de respuesta:
1 item
jsonFileName: T excel_extracted.json
txtFileName: T excel_extracted.txt
jsonFileSize: # 206933
txtFileSize: # 206933
success: ☑ true
originalFileName: T myExcelFile.xlsx
extractBy: T name
worksheetNames: T Sheet2
parsedData: {} Object
Sheet2: [] Array
[0]: {} Object
"": # 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
"": # 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
[2]: {} Object
"": # 3
First Name: T Philip
Last Name: T Gent
Gender: T Male
Country: T France
Age: # 36
Date: T 21/05/2015
Id: # 2587
message: T Successfully extracted worksheet(s) 'Sheet2' by name and created JSON and TXT outputs
Indicadores de tipo:
T= String (Texto)#= Número☑= Boolean[]= Array{}= Object
Vista de datos binarios
Los datos de la hoja de cálculo extraídos se devuelven como dos archivos binarios: uno en JSON formato y uno en formato TXT:
data_json
─────────────────────────────
File Name: excel_extracted.json
File Extension: json
Mime Type: application/json
File Size: 207 kB
data_txt
─────────────────────────────
File Name: excel_extracted.txt
File Extension: txt
Mime Type: text/plain
File Size: 207 kB
Ambos archivos binarios contienen los mismos datos de la hoja de cálculo extraídos en formatos diferentes. parsedData objeto en el JSON La respuesta proporciona acceso directo a los datos estructurados sin necesidad de analizar los archivos binarios.
Acceso a datos binarios:
- JSON Objeto binario:
$binary.data_json.data - Objeto binario TXT:
$binary.data_txt.data - Base64 ContenidoDisponible para uso directo en ambos formatos.
- Operaciones de archivosListo para descargar, enviar por correo electrónico o almacenar.
Casos de uso
Exportación y migración completa de datos
- Extraer libros de trabajo de Excel completos como JSON para migraciones de sistemas, archivado de datos y operaciones de copia de seguridad
- Convertir archivos de Excel de varias hojas a JSON formato para almacenamiento en la nube e importación de bases de datos
- Exportar datos completos de la hoja de cálculo para API integración y sincronización entre sistemas
Procesamiento y análisis de múltiples hojas
- Extraer varias hojas de cálculo simultáneamente para su procesamiento en paralelo en n8n flujos de trabajo
- Procesar diferentes pestañas de hojas de cálculo con diferentes lógicas de negocio y transformaciones.
- Integrar datos completos del libro de trabajo con datos externos APIs y plataformas de análisis de datos
Inteligencia empresarial e integración de datos
- Exportar datos de Excel a JSON para herramientas de inteligencia empresarial y plataformas analíticas
- Convertir informes de Excel a formato estructurado JSON para informes automatizados y actualizaciones del panel de control
- Integrar datos de Excel con CRM sistemas, bases de datos y servicios en la nube