DocumentaciónWorkflowsApps y servicios
Excel nodo
Lee o escribe rangos de celdas en un archivo .xlsx en OneDrive. Usa la Graph Workbook-API. Consulta la configuración, las entradas y salidas, las pruebas y la solución de errores.
8 min de lecturaActualizado el
Qué hace este nodo
Lee o escribe rangos de celdas en un archivo .xlsx en OneDrive. Usa la Graph Workbook-API.
Usa Excel como un paso claramente definido en un workflow de anymize.
- Procesa 1 entrada.
- Ofrece 1 salida para los pasos siguientes.
- Se ejecuta como un paso normal del flujo.
Configurar el nodo
- 01Abre un workflow y añade Excel desde el catálogo de nodos.
- 02Selecciona tu conexión de microsoft. Puedes crearla directamente en el workflow.
- 03Completa los campos obligatorios y asigna valores de los pasos anteriores.
- 04Ejecuta el nodo con un conjunto pequeño de datos y revisa la salida.
- 05Conecta la salida correcta y activa el workflow después de una prueba completa.
Acciones y modos
Elige la función necesaria en Acción. El panel mostrará los ajustes correspondientes.
- Leer rango
- Escribir rango
- Añadir fila a la tabla
Ajustes
| Campo | Significado | Área |
|---|---|---|
| Acción | Opciones: Leer rango, Escribir rango, Añadir fila a la tabla | Estándar |
| ID del archivo (opcional) | El ID del archivo de Excel. Arrástralo desde un paso de OneDrive. O deja el campo vacío e indica abajo una ruta de archivo. | Estándar |
| Drive-ID (optional) | Configura este valor en el panel del nodo. | Estándar |
| Ruta del archivo | Ruta al .xlsx en tu OneDrive, p. ej. Reports/Q2.xlsx. Solo necesaria si arriba no hay un ID de archivo. | Estándar |
| Hoja de cálculo | Nombre de la hoja (la pestaña de abajo en Excel), p. ej. Sheet1 o Ventas. | Estándar |
| Rango de celdas | Qué celdas, en notación de Excel, p. ej. A1:C10 para las primeras tres columnas y diez filas. | Estándar |
| Valores | Los valores de las celdas. Al escribir un rango, una tabla (filas × columnas); al añadir, exactamente una fila. También puedes arrastrar valores de un paso anterior. | Estándar |
| Nombre de la tabla | Graph necesita una tabla con nombre para "append". En Excel: Seleccionar → "Dar formato como tabla" → nombre arriba a la izquierda. | Estándar |
| Ejecutar una vez por elemento | Desactivado (por defecto): el nodo se ejecuta una vez para toda la entrada. Activado: si recibe varios elementos (por ejemplo de «Dividir lista»), se ejecuta una vez POR elemento, y {{ $json }} es justo ese elemento. Así procesas una lista de archivos entrada por entrada. | Estándar |
| Si un elemento falla | «Omitir» escribe un campo `error` para el elemento fallido y sigue con el resto, en lugar de perder toda la ejecución por un único archivo ilegible. | Estándar |
| Pausa entre elementos (milisegundos) | Espera antes de cada ejecución excepto la primera. 1000 = 1 segundo por elemento. Útil si el otro extremo te limita. Máximo 300000 (5 minutos). | Estándar |
Entradas y salidas
| Entrada | Significado | Tipo |
|---|---|---|
| Estándar | Recibe el resultado completo del paso anterior. | JSON |
| Salida | Significado | Tipo |
|---|---|---|
| Estándar | Entrega el resultado al paso siguiente como JSON. | JSON |
Este nodo puede procesar listas elemento por elemento. La gestión de errores y la pausa están en los ajustes avanzados.
Ejemplo y prueba
Añadir fila al informe: empieza con un conjunto pequeño y reconocible. Revisa la salida y usa solo los campos que estén presentes.
Ejemplo de prueba
{
"file_path": "Reports/2026-Q1.xlsx",
"worksheet": "Umsätze",
"table": "UmsatzTabelle",
"values": [
"2026-04-19",
1250.5,
"Alice"
]
}Acceso y seguridad
Este nodo usa una conexión de microsoft. Revisa los permisos y concede solo el acceso necesario.
Guarda claves y credenciales en el gestor protegido. No las pegues en campos normales, datos de prueba ni descripciones.
Resolver errores
- Sin salida: revisa la última ejecución y los campos entregados por el nodo anterior.
- Variable vacía: abre la salida anterior y usa un campo presente en los datos reales.
- Conexión rechazada: vuelve a conectar el servicio con los permisos necesarios.
- La lista se procesa una sola vez: activa la ejecución por elemento.