Excel Online — Write cell

Tipo: excelonline-write-cell · Paquete: Excel Online v1.0.4

Escribe un valor en una sola celda. El cambio se guarda automáticamente en el libro de la nube y lo ven al instante quienes lo tengan abierto.

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, la celda en notación A1 (B3) y el valor a escribir. El valor reemplaza lo que hubiera en la celda; el formato de la celda (color, formato de número) se conserva.

Según el tipo del valor:

Números (int, decimal, double…) y booleanos se escriben como número y verdadero/falso de Excel.
Cualquier otro valor (fechas incluidas) se escribe como texto. Para guardar una fecha como fecha de Excel, escribe su número de serie (fecha.ToOADate()) y dale formato de fecha a la celda en el libro.
Un valor null deja la celda sin cambios.

Escribir el mismo valor dos veces deja el mismo resultado, así que es seguro reintentarla.

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`.
`value`	`object`	—	Valor a escribir: texto, número o booleano.

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

Esta actividad no devuelve ningún valor. El cambio se guarda automáticamente.

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, o es un rango de más de una celda.
`accessDenied` (Microsoft Graph, 403)	La conexión solo tiene permisos de lectura o la cuenta no puede editar el libro.

Ejemplo

Excel Online — Connect   credential = credential("m365-finanzas")   path = "Reportes/Estado.xlsx"
 └─ body:
      Excel Online — Find cell    sheet = "Resumen"   value = "Estado"   → output: celda
      Excel Online — Write cell   sheet = "Resumen"   cell = "B" + celda["row"]   value = "Completado"

Actividades relacionadas

Excel Online — Read cell — leer una celda.
Excel Online — Write range — escribir varias celdas.
Excel Online — Find cell — localizar la celda a actualizar.
Todas las actividades de Excel Online