Excel Online — Used range

Tipo: excelonline-get-used-range · Paquete: Excel Online v1.0.4 · Salida: Dictionary<string,object>

Devuelve las dimensiones del área usada de una hoja: cuántas filas y columnas tienen datos y la dirección del rango. Úsala para saber cuánto leer o dónde empezar a escribir sin asumir un tamaño fijo.

Cómo funciona

Opera sobre la sesión creada con Excel Online — Connect. Pásala en el parámetro session, o coloca esta actividad dentro del body de Excel Online — Connect para heredarla automáticamente.

El área usada es el rectángulo más pequeño que contiene todas las celdas con contenido o con formato. Por eso:

No siempre empieza en A1: si los datos empiezan en B3, la dirección empieza ahí.
Las celdas con solo formato (bordes, color) la agrandan aunque estén vacías.
En una hoja vacía, Microsoft 365 informa A1 (1 fila, 1 columna).

Es solo lectura: no modifica el libro.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`sheet`	`string`	—	Nombre de la hoja.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanExcelOnlineSession`	—	Sesión de Excel Online — Connect. Dentro del `body` de Connect se hereda.

Salida

Devuelve un Dictionary<string,object> con tres claves:

Clave	Tipo	Contenido
`rows`	`int`	Número de filas del área usada.
`columns`	`int`	Número de columnas del área usada.
`address`	`string`	Dirección A1 del área usada, con el nombre de la hoja delante: `Datos!A1:D250` (entre comillas simples si el nombre tiene espacios: `'Ventas 2026'!A1:D250`).

Accede por clave: usado["rows"], usado["address"]. Para usar la dirección en otra actividad de esta hoja, quítale el prefijo: usado["address"].ToString().Split('!')[1].

Errores comunes

Mensaje	Causa y solución
`No hay una sesión de Excel Online disponible. Indica 'session' desde una actividad excelonline-connect o coloca esta actividad dentro del cuerpo de la actividad Connect para que herede la sesión automáticamente.`	La actividad está fuera del `body` de Connect y no recibió `session`. Colócala dentro del `body` o pasa `session = libro`.
`'sheet' es obligatorio.`	`sheet` está vacío o su expresión dio `null`.
`itemNotFound` (Microsoft Graph, 404)	No existe una hoja con ese nombre.

Ejemplo

Excel Online — Connect   credential = credential("m365-finanzas")   path = "Reportes/Datos.xlsx"
 └─ body:
      Excel Online — Used range   sheet = "Datos"   → output: usado
      Excel Online — Read range   sheet = "Datos"   range = usado["address"].ToString().Split('!')[1]   has-headers = true   → output: tabla
      Log   message = "Filas con datos: " + (Convert.ToInt32(usado["rows"]) - 1)

Actividades relacionadas

Excel Online — Read range — leer el rango usado.
Excel Online — Append rows — añadir al final.
Excel Online — Clear range — limpiar el rango.
Todas las actividades de Excel Online