Read Excel Cell

Tipo: excel-read-cell · Paquete: Excel Activities v1.0.6 · Salida: object

Lee el valor de una sola celda. Úsala cuando solo necesitas un dato concreto: un total en B10, una fecha en A1, un parámetro de configuración en una celda fija.

Cómo funciona

Devuelve el valor de la celda indicada (cell) de la hoja, con su tipo: a diferencia de las lecturas a DataTable, un número llega como número y una fecha como fecha. Acepta session o path — ver los dos modos.

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

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`cell`	`string`	—	Dirección de la celda, ej. `"B3"`.

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 object con el valor de la celda:

Contenido de la celda	Valor devuelto
Número (también enteros)	`double` — `1500` llega como `1500.0`
Fecha	`DateTime`
`VERDADERO` / `FALSO`	`bool`
Texto	`string`
Fórmula	Su resultado, con el tipo de ese resultado
Error de Excel	El texto del error, ej. `"#DIV/0!"`
Vacía	`null`

Errores comunes

Mensaje	Causa y solución
`'cell' es obligatorio.`	Falta `cell`.
`Indica 'session' o 'path'.`	Falta `session` y `path`.
`No se encontró el archivo.`	`path` no existe.
`'…' is not A1 address or workbook named range.`	`cell` no es una dirección válida (ej. `"1A"`). Usa la forma `"B3"`.
`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

Read Excel Cell   path = asset("config.xlsx")   sheet = "Parametros"   cell = "B2"   → output: limite
If   condition = !isNull(limite) && toNumber(limite) > 1000
 └─ then:
      Log   message = "Límite alto"

Actividades relacionadas

Write Excel Cell — escribir una celda.
Read Excel Sheet — leer toda la hoja de una vez.
Find Excel Cell — encontrar una celda por su valor.