Extraer filas de una hoja de cálculo de Excel usando n8n acción
PDF4me Extraer filas convierte cualquier segmento de hoja de cálculo en una hoja lista para usar. JSON dentro n8n. Especifique rangos de filas/columnas basados en 0, decida si la primera fila debe convertirse en encabezados, omita filas ocultas o vacías y elija si los valores permanecen tipados (números, booleanos, ISO fechas) o forzado a texto. Ideal para canalizar datos de Excel a APIsbases de datos o adicionales PDF4me acciones.
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 →
Configuración
Añade el PDF4me Nodo “Extraer filas” 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
- Añade el PDF4me nodo al flujo de trabajo
- Seleccione la acción "Extraer filas de la hoja de cálculo de Excel".
- Proporcione la ventana de origen y extracción de Excel.
Parámetros
Importante: Los parámetros marcados con un asterisco (***) son obligatorios. Los índices de fila/columna son Basado en 0 (Fila 0 = Fila 1 de Excel).
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Tipo de datos de entrada*** | String | Selector de origen de Excel (Binary Data, Base64 String, URL). | Binary Data |
| Campo binario de entrada*** | Binario | Requerido cuando Binary Data es seleccionado. | {{ $binary.data }} |
| Contenido del documento en Base64*** | String | Requerido cuando Base64 String es seleccionado. | UEsDBBQAAAA... |
| URL del documento*** | String | Requerido cuando URL Está seleccionado. Enlace al archivo público. | https://files.example.com/report.xlsx |
| Nombre del archivo*** | String | Nombre lógico del libro de trabajo con extensión. | analytics.xlsx |
| Nombre de la hoja de trabajo | String | Hoja de trabajo para leer. Vacío = primera hoja. | Summary |
| Primera fila*** | Número | Fila de inicio basada en 0 para la extracción. | 0 |
| Última fila | Número | Fila final basada en 0. Usar -1 leer hasta la última fila de datos. | -1 |
| Primera columna | Número | Columna inicial basada en 0 (0 = columna A). | 0 |
| Última columna | Número | Columna final basada en 0. Utilizar -1 para la última columna de datos. | -1 |
| Tiene fila de encabezado | Boolean | true usos First Row como encabezados de columna y lo excluye de los datos. | true |
| Excluir filas ocultas | Boolean | Omitir las filas que estén ocultas en Excel. | false |
| Excluir columnas ocultas | Boolean | Omitir columnas ocultas. | false |
| Excluir filas vacías | Boolean | Elimine las filas donde todas las celdas estén vacías. | true |
| Exportar celdas vacías | Boolean | Incluya celdas vacías con valores de cadena vacía en lugar de omitirlas. | false |
| Exportar valores como texto | Boolean | Forzar que todos los valores sean cadenas de texto. false conserva los tipos autóctonos. | false |
| Nombre de salida de datos binarios*** | String | Ranura binaria que almacena datos serializados JSON (PDF4me devoluciones JSON bytes). | document |
Producción
Parámetros de salida
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| éxito | Boolean | PDF4me estado de operación - Boolean Bandera que indica si el proceso de extracción de filas fue exitoso o fallido. 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 |
| Nombre de la hoja de cálculo | String | Nombre de la hoja de trabajo - El nombre de la hoja de cálculo de la que se extrajeron las filas | First Worksheet |
| tieneFilaDeEncabezado | Boolean | Estado de la fila de encabezado - Indica si la primera fila se trató como encabezados. true si se usaran encabezados, false de lo contrario | true |
| primera fila | Número | Índice de la primera fila (basado en 0) - El índice basado en 0 de la primera fila extraída | 0 |
| última fila | Número | Índice de la última fila (basado en 0) - El índice basado en 0 de la última fila extraída. -1 indica la extracción hasta la última fila de datos | 2 |
| primera columna | Número | Índice de la primera columna (basado en 0) - El índice basado en 0 de la primera columna extraída (0 = columna A) | 0 |
| última columna | Número | Índice de la última columna (basado en 0) - El índice basado en 0 de la última columna extraída. -1 indica la extracción a la última columna de datos | -1 |
| excluir filas vacías | Boolean | exclusión de filas vacías - Indica si se excluyeron las filas vacías. true si se excluye, false si está incluido | true |
| excluir filas ocultas | Boolean | exclusión de fila oculta - Indica si se excluyeron las filas ocultas. true si se excluye, false si está incluido | true |
| excluirColumnasOcultas | Boolean | Exclusión de columna oculta - Indica si se excluyeron las columnas ocultas. true si se excluye, false si está incluido | true |
| exportarValoresComoTexto | Boolean | Modo de exportación de texto - Indica si los valores se exportaron como texto. true si se ve obligado a usar cuerdas, false si se conservan los tipos nativos | false |
| exportarCeldasVacías | Boolean | Exportación de celdas vacías - Indica si se exportaron celdas vacías. true si se incluyen con cadenas vacías, false si se omite | false |
| exportarComoObjeto | Boolean | Modo de exportación de objetos - Indica si los datos se exportaron en formato de objeto. | false |
| Formato de hipervínculo | String | Formato de hipervínculo - Formato utilizado para los hipervínculos en los datos extraídos. Valores: "Texto", "URL", etc. | Text |
| cultura | String | Código cultural/local - Código cultural utilizado para la extracción de datos (p. ej., "en-US", "de-DE", "fr-FR") | en-US |
| filas extraídas | Número | Número de filas extraídas - El número total de filas que se extrajeron correctamente | 1 |
| datos extraídos | Object | Objeto de datos extraído - Objeto anidado que contiene los datos de fila extraídos con el array rowData | {"rowData": [{"Column1": 1, "First Name": "Dulce"}]} |
| mensaje | String | Mensaje de operación - Mensaje descriptivo que indica el resultado de la operación de extracción de filas, incluyendo el número de filas extraídas y el nombre de la hoja de cálculo. | Successfully extracted 1 row(s) from worksheet 'First Worksheet' |
N8N Respuesta a la acción
El PDF4me Extraer filas de una hoja de cálculo 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:
[
{
"success": true,
"originalFileName": "myExcelFile.xlsx",
"worksheetName": "First Worksheet",
"hasHeaderRow": true,
"firstRow": 0,
"lastRow": 2,
"firstColumn": 0,
"lastColumn": -1,
"excludeEmptyRows": true,
"excludeHiddenRows": true,
"excludeHiddenColumns": true,
"exportValuesAsText": false,
"exportEmptyCells": false,
"exportAsObject": false,
"hyperlinkFormat": "Text",
"culture": "en-US",
"rowsExtracted": 1,
"extractedData": {
"document": null,
"fileName": null,
"success": true,
"errorMessage": null,
"rowData": [
{
"Column1": 1,
"First Name": "Dulce",
"Last Name": "Abril",
"Gender": "Female",
"Country": "United States",
"Age": 32,
"Date": "15/10/2017",
"Id": 1562
},
{
"Column1": 2,
"First Name": "Mara",
"Last Name": "Hashimoto",
"Gender": "Female",
"Country": "Great Britain",
"Age": 25,
"Date": "16/08/2016",
"Id": 1582
}
]
},
"message": "Successfully extracted 1 row(s) from worksheet 'First Worksheet'"
}
]
Vista de tabla
Datos de respuesta en formato de tabla estructurada:
| Parámetro | Valor |
|---|---|
| éxito | true |
| nombre de archivo original | myExcelFile.xlsx |
| Nombre de la hoja de cálculo | First Worksheet |
| tieneFilaDeEncabezado | true |
| primera fila | 0 |
| última fila | 2 |
| primera columna | 0 |
| última columna | -1 |
| excluir filas vacías | true |
| excluir filas ocultas | true |
| excluirColumnasOcultas | true |
| exportarValoresComoTexto | false |
| exportarCeldasVacías | false |
| exportarComoObjeto | false |
| Formato de hipervínculo | Text |
| cultura | en-US |
| filas extraídas | 1 |
| datos extraídos | Objeto que contiene el array rowData |
| mensaje | Successfully extracted 1 row(s) from worksheet 'First Worksheet' |
Objeto de datos extraído:
| Parámetro | Valor |
|---|---|
| documento | null |
| Nombre del archivo | null |
| éxito | true |
| mensaje de error | null |
| datos de fila | Matriz de objetos de fila extraídos |
Nota: rowData contiene los objetos de fila extraídos como una matriz con los encabezados de columna como claves.
Vista de esquema
Estructura de datos y tipos de respuesta:
1 item
success: ☑ true
originalFileName: T myExcelFile.xlsx
worksheetName: T First Worksheet
hasHeaderRow: ☑ true
firstRow: # 0
lastRow: # 2
firstColumn: # 0
lastColumn: # -1
excludeEmptyRows: ☑ true
excludeHiddenRows: ☑ true
excludeHiddenColumns: ☑ true
exportValuesAsText: ☑ false
exportEmptyCells: ☑ false
exportAsObject: ☑ false
hyperlinkFormat: T Text
culture: T en-US
rowsExtracted: # 1
extractedData: {} Object
document: null
fileName: null
success: ☑ true
errorMessage: null
rowData: [] Array
[0]: {} Object
Column1: # 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
Column1: # 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
message: T Successfully extracted 1 row(s) from worksheet 'First Worksheet'
Indicadores de tipo:
T= String (Texto)#= Número☑= Boolean[]= Array{}= Objectnull= Valor nulo
Vista de datos binarios
Los datos extraídos se devuelven como JSON en la respuesta. Acceda a los datos de la fila directamente desde el extractedData.rowData matriz:
extractedData
─────────────────────────────
rowData: Array of row objects
success: true
errorMessage: null
Acceso a los datos:
- Matriz de datos de fila:
$json.extractedData.rowData - Filas individuales:
$json.extractedData.rowData[0] - Valores de columna:
$json.extractedData.rowData[0]["First Name"] - JSON Respuesta: Disponible como estructurado JSON en n8n respuesta
Casos de uso
- API fuentes: Extraer filas filtradas y enviarlas directamente a REST puntos finales o consumidores de webhook.
- Ingesta de base de datos: Convertir informes de Excel en informes estructurados JSON cada noche antes de insertar datos en almacenes SQL/NoSQL.
- Validación y control de calidad: Extrae rangos para comprobar reglas, enviar alertas o enriquecer otros flujos de trabajo sin necesidad de exportarlos manualmente.