Get Excel Used Range

Tipo: excel-get-used-range · Paquete: Excel Activities v1.0.6 · Salida: Dictionary

Devuelve las dimensiones del área que contiene datos en una hoja (el “rango usado”). Te dice cuántas filas y columnas hay y dónde empiezan y terminan, sin tener que leer todo el contenido. Útil para saber el tamaño de los datos antes de procesarlos, o para construir un rango dinámico.

Cómo funciona

Calcula el rectángulo mínimo que abarca todas las celdas con contenido (valores o fórmulas) y devuelve un diccionario con sus métricas. Las celdas que solo tienen formato (color, bordes) no cuentan. Acepta session o path — ver los dos modos.

Solo lee: en modo rápido no modifica el archivo.

Parámetros requeridos

Ninguno — pero debes indicar session o path (o estar dentro del body de un Excel Open).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanExcelSession`	—	Sesión de Excel Open (en vez de `path`).
`path`	`string`	—	Ruta al `.xlsx` (requerido si no hay sesión). El archivo debe existir.
`sheet`	`string \| int`	—	Nombre o índice (desde 1) de la hoja. Si se omite, la primera.

Salida

Devuelve un Dictionary con estas claves exactas:

Clave	Tipo	Descripción
`address`	`string`	Dirección del rango usado, ej. `"A1:F120"` (sin `$` ni nombre de hoja).
`rows`	`int`	Número de filas del rango.
`columns`	`int`	Número de columnas del rango.
`firstRow`	`int`	Número de la primera fila (desde 1).
`firstColumn`	`int`	Número de la primera columna (desde 1: `A` = 1).
`lastRow`	`int`	Número de la última fila.
`lastColumn`	`int`	Número de la última columna.

Hoja vacía: address es null y todas las demás claves valen 0 (además deja un aviso en el log). Compruébalo con dim["rows"] == 0.

Errores comunes

Mensaje	Causa y solución
`Indica 'session' o 'path'.`	Falta `session` y `path`.
`No se encontró el archivo.`	`path` no existe.
`There isn't a worksheet named '…'.`	No hay una hoja con ese nombre.
`There isn't a worksheet associated with that position.`	El índice de hoja no existe (o el nombre es solo un número y se tomó como índice).

Ejemplo

Get Excel Used Range   path = asset("datos.xlsx")   → output: dim
Log   message = "La hoja tiene " + dim["rows"] + " filas y " + dim["columns"] + " columnas"

Leer solo las columnas A a C, hasta la última fila con datos:

Get Excel Used Range   path = asset("datos.xlsx")   sheet = "Ventas"   → output: dim
Read Excel Range       path = asset("datos.xlsx")   sheet = "Ventas"   range = "A1:C" + dim["lastRow"]   → output: ventas

Actividades relacionadas

Read Excel Sheet — leer el área con datos a una DataTable.
Get Excel Sheet Names — listar las hojas del libro.