Excel Online — Read cell

Tipo: excelonline-read-cell · Paquete: Excel Online v1.0.4 · Salida: object

Lee el valor de una sola celda de una hoja del libro.

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.

Indica la hoja por nombre y la celda en notación A1 (B3). Si das un rango (B3:C4), se devuelve solo el valor de su primera celda. Si la celda tiene una fórmula, obtienes el resultado calculado, no la fórmula.

Es solo lectura: no modifica el libro.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`sheet`	`string`	—	Nombre de la hoja.
`cell`	`string`	—	Celda en notación A1. Ej.: `B3`.

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

Contenido de la celda	Valor devuelto
Texto	`string`
Número	número (entero o decimal)
Verdadero / falso	`bool`
Fecha	número de serie de Excel (ej. `45458`); conviértelo con `DateTime.FromOADate(Convert.ToDouble(valor))`
Vacía	texto vacío (`""`)

Asígnalo a una variable; conviértelo si necesitas un tipo concreto (Convert.ToDecimal(total)). Para comprobar si la celda está vacía, usa string.IsNullOrEmpty(Convert.ToString(valor)).

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.` / `'cell' es obligatorio.`	El parámetro está vacío o su expresión dio `null`.
`itemNotFound` (Microsoft Graph, 404)	No existe una hoja con ese nombre.
`InvalidArgument` (Microsoft Graph, 400)	`cell` no es una dirección A1 válida.

Ejemplo

Excel Online — Connect   credential = credential("m365-finanzas")   path = "Reportes/Presupuesto.xlsx"
 └─ body:
      Excel Online — Read cell   sheet = "Resumen"   cell = "B3"   → output: total
      If   condition = Convert.ToDecimal(total) > 10000
       └─ Log   message = "El total supera el presupuesto: " + total

Actividades relacionadas

Excel Online — Write cell — escribir una celda.
Excel Online — Read range — leer varias celdas.
Excel Online — Find cell — localizar una celda por su valor.
Todas las actividades de Excel Online