Excel Online — Find cell

Tipo: excelonline-find-cell · Paquete: Excel Online v1.0.0 · Salida: Dictionary<string,object>

Busca la primera celda que contiene un valor dado y devuelve su ubicación. Útil para localizar una fila o columna por su rótulo sin saber de antemano dónde está.

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.

La comparación no distingue mayúsculas. Con match-type eliges si el valor debe coincidir exacto, contener el texto o empezar por él.

Parámetros requeridos

Parámetro	Editor	Descripción
`sheet`	texto	Nombre de la hoja.
`value`	texto	Valor a buscar.

Parámetros opcionales

Parámetro	Editor	Descripción
`session`	expresión	Sesión de Excel Online — Connect (se hereda dentro del `body`).
`match-type`	lista de opciones	Tipo de coincidencia: `exact` (por defecto), `contains` o `starts-with`. No distingue mayúsculas.

Salida

Devuelve un Dictionary<string,object> con address (dirección A1, p. ej. C5), row (nº de fila), column (nº de columna) y value. Si no encuentra nada, devuelve null — compruébalo antes de usar el resultado.

Ejemplo

Excel Online — Connect   credential = "m365-finanzas"   path = "Documents/Datos.xlsx"
 └─ body:
      Excel Online — Find cell   sheet = "Datos"   value = "Total"   → output: celda
      Excel Online — Write cell   sheet = "Datos"   cell = celda["address"]   value = "Revisado"

Actividades relacionadas

Excel Online — Read cell — leer la celda encontrada.
Excel Online — Write cell — escribir en la celda encontrada.
Excel Online — Read range — leer alrededor de la celda.
Todas las actividades de Excel Online