Find Excel Cell

Tipo: excel-find-cell · Paquete: Excel Activities v1.0.0 · Salida: Dictionary

Busca un valor en la hoja y devuelve la ubicación de la primera celda que coincide (dirección, fila y columna). Es el equivalente al “Buscar” de Excel. Útil para localizar un encabezado, encontrar dónde está un dato concreto, o ubicar una fila por su identificador antes de leer o escribir alrededor.

Cómo funciona

Recorre la hoja (o el searchRange indicado) buscando el value según el matchType, y devuelve la primera coincidencia como un diccionario con su posición. Si no encuentra nada, devuelve nulo.

Parámetros requeridos

Parámetro	Editor	Descripción
`value`	expresión	El valor a buscar.

Parámetros opcionales

Parámetro	Editor	Descripción
`session`	expresión	Sesión de Excel Open (en vez de `path`).
`path`	expresión	Ruta al `.xlsx` (requerido si no hay sesión).
`sheet`	expresión	Nombre o índice de la hoja. Por defecto, la primera.
`matchType`	lista	Forma de comparar: `exact` (def.) · `contains` · `starts-with`.
`searchRange`	texto	Limitar la búsqueda a un rango, ej. `"A1:Z100"`. Por defecto, toda la hoja.

Salida

Devuelve un Dictionary con address, row, column y value de la celda encontrada, o nulo si no hay coincidencia.

Ejemplo

Find Excel Cell   path = = asset("datos.xlsx")   value = "Total"   → output: celda
If   condition = = isNull(celda)
 ├─ then:
 │    Log   level = warning   message = "No se encontró la celda 'Total'"
 └─ else:
      Log   message = = "Encontrada en " + celda["address"] + " (fila " + celda["row"] + ")"

Actividades relacionadas

Read Excel Cell — leer una celda en una posición conocida.
Read Excel Sheet — leer toda la hoja y filtrar con LINQ.