Excel

Excel conecta tu flujo con los libros de Excel que guardas en Microsoft 365. Puedes buscar libros en una carpeta, leer o escribir un rango de celdas, crear y eliminar hojas, y consultar, crear o eliminar tablas.

Es útil cuando una hoja de Excel compartida hace de registro o de fuente de datos para un proceso: un listado de pedidos, un control de horas o una tabla de precios que otro flujo tiene que consultar o actualizar.

Cuándo usarlo

Cada vez que llega un pedido quieres escribir sus datos en una hoja de seguimiento.
Un agente de IA tiene que consultar una tabla de precios o de stock guardada en Excel.
Cada mes quieres crear una hoja nueva en el libro de informes.
Quieres localizar todos los libros de Excel de una carpeta de OneDrive para procesarlos.

Configuración

Necesitas una credencial Microsoft Excel, que se conecta iniciando sesión con tu cuenta de Microsoft. Al crearla eliges el acceso: con Read Only solo puedes leer; para escribir, crear o eliminar elige Full Access. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Microsoft Excel con la que se accede a tus archivos.
Operation (obligatorio)	Lo que hace el componente. Ver Operaciones. Por defecto, `Get Workbooks`.
Mode	Cómo indicas los archivos: `By Selector` (eliges carpetas, libros, hojas y tablas de una lista) o `By Manual Entry` (escribes sus identificadores). Por defecto, `By Selector`.
Select Folder Path (obligatorio)	La carpeta de tu OneDrive donde se buscan libros. Solo en `Get Workbooks` con `By Selector`.
Select Workbook (obligatorio)	El libro de Excel con el que se trabaja, elegido en tu OneDrive. En todas las operaciones salvo `Get Workbooks`, con `By Selector`.
Worksheet (obligatorio)	La hoja del libro. La lista se carga al elegir el libro. En `Get Range`, `Update Range`, `Delete Worksheet`, `Get Tables`, `Create Table` y `Get Table Rows`, con `By Selector`.
Table (obligatorio)	La tabla de la hoja. En `Get Table Rows` y `Delete Table`, con `By Selector`.
Worksheet Name	El nombre de la hoja nueva. Solo en `Create Worksheet`.
Range Address (obligatorio)	El rango de celdas, por ejemplo `A1:C10`. En `Get Range` y `Update Range`.
Range Values	Los valores que se escriben en el rango, organizados en filas y columnas. El número de filas y columnas debe coincidir con el rango. Si conectas un texto suelto, se escribe en una sola celda. Solo en `Update Range`.
Table Range (obligatorio)	El rango que ocupará la tabla nueva, por ejemplo `A1:D10`. La primera fila se usa como encabezados. Solo en `Create Table`.
Shallow Search	Si está activado, solo se buscan libros en la carpeta indicada; si no, también en sus subcarpetas. Desactivado por defecto. Solo en `Get Workbooks`.
Documents Count	Cuántos libros se devuelven como máximo. Por defecto, 50. Solo en `Get Workbooks`.

Con Mode en By Manual Entry, las listas se sustituyen por campos de texto, que aparecen en las mismas operaciones:

Campo	Qué hace
Drive ID	El identificador de la unidad de OneDrive o de la biblioteca de SharePoint. Si lo dejas vacío, se usa tu OneDrive.
Folder Path	La ruta de la carpeta donde se buscan libros. Vacío equivale a la carpeta raíz. Solo en `Get Workbooks`.
Workbook ID (obligatorio)	El identificador del libro.
Worksheet ID (obligatorio)	El identificador de la hoja.
Table ID (obligatorio)	El identificador de la tabla.

Operaciones

Operación	Qué hace
`Get Workbooks`	Busca los libros de Excel de una carpeta y devuelve su nombre, identificador, enlace y fecha de modificación.
`Get Worksheets`	Devuelve las hojas de un libro, con su nombre, posición y visibilidad.
`Get Range`	Lee un rango de celdas: los valores, las fórmulas y el formato de número.
`Update Range`	Escribe valores en un rango de celdas y guarda los cambios en el libro.
`Create Worksheet`	Añade una hoja nueva al libro.
`Delete Worksheet`	Elimina una hoja del libro.
`Get Tables`	Devuelve las tablas de una hoja.
`Create Table`	Convierte un rango de una hoja en una tabla de Excel con encabezados.
`Get Table Rows`	Devuelve las filas de una tabla, con su posición y los valores de cada celda.
`Delete Table`	Elimina una tabla del libro.

Resultado

La salida Data devuelve un elemento por cada libro, hoja, tabla o fila encontrados, o un único elemento con el resultado de la operación (por ejemplo, el rango leído o la confirmación de que se ha escrito). Si una operación falla, la salida trae un elemento con el mensaje de error en lugar de detener el flujo.

Puedes conectar el resultado a un agente para que use los datos en su respuesta, o a otro componente que los transforme o los envíe. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo leer o escribir en Excel. Ver Tool Mode.

Ejemplo

Una academia guarda las inscripciones en el libro Inscripciones 2026.xlsx de OneDrive y quiere añadir cada alumno nuevo que llega por formulario.

Añade Excel con la operación Update Range y la credencial Microsoft Excel de la academia.
Deja Mode en By Selector, elige el libro en Select Workbook y la hoja Alumnos en Worksheet.
En Range Address indica la fila donde se escribe, por ejemplo A25:D25.
Conecta a Range Values los datos del alumno en una fila de cuatro celdas: nombre, correo, curso y fecha.

Buenas prácticas

Usa Get Range antes de Update Range si necesitas saber cuál es la primera fila libre.
Para que un agente trabaje con libros distintos en cada ejecución, usa By Manual Entry y pásale los identificadores que devuelve Get Workbooks.
Antes de usar Delete Worksheet o Delete Table, comprueba en Get Worksheets o Get Tables que eliges lo correcto: no se puede deshacer desde NappAI.

Componentes relacionados

Files: leer, subir y gestionar archivos de OneDrive.
Word: trabajar con documentos de Word.
Documents: gestionar documentos de SharePoint.