Write Excel Cell

Write Excel Cell

Tipo: excel-write-cell  ·  Paquete: Excel Activities v1.0.6  ·  Salida: —

Escribe un valor en una celda concreta. Úsala para colocar un dato puntual: un total en B10, una fecha de proceso en A1, un estado en una celda fija. Crea el archivo si no existe.

Cómo funciona

Escribe el value en la celda indicada de la hoja, reemplazando lo que hubiera y conservando el formato de la celda. Acepta session o path — ver los dos modos.

• Tipo del valor: un número (int, double, decimal), una fecha (DateTime) o un booleano se guardan con su tipo, así que Excel puede calcular con ellos. Cualquier otro valor se guarda como texto, también un texto que parezca número ("1500"): para escribir un número usa una expresión que dé número (1500, toNumber(x)).
• Valor nulo: si value es null, la celda no se modifica. Para vaciar una celda, usa Clear Excel Range con range = "B3".
• Si el archivo o la hoja no existen, se crean.
• En modo rápido guarda el archivo en cada llamada; en modo sesión, al hacer Excel Save o Excel Close.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
cell	string	—	Dirección de la celda, ej. "B3".
value	object	—	El valor o expresión a escribir.

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 (se crea si no existe; requerido si no hay sesión).
sheet	string | int	—	Nombre o índice de la hoja; se crea si no existe. Si se omite, la primera hoja (o "Sheet1" en un libro nuevo).

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
'cell' es obligatorio.	Falta cell.
Indica 'session' o 'path'.	Falta session y path.
'…' is not A1 address or workbook named range.	cell no es una dirección válida (ej. "1A"). Usa la forma "B3".
The process cannot access the file '…' because it is being used by another process.	El archivo está abierto en otro programa al guardar. Ciérralo o reintenta con Retry.

Ejemplo

Write Excel Cell   path = "C:/salida/control.xlsx"   sheet = "Log"   cell = "A1"   value = "Procesado"
Write Excel Cell   path = "C:/salida/control.xlsx"   sheet = "Log"   cell = "B1"   value = now()
Write Excel Cell   path = "C:/salida/control.xlsx"   sheet = "Log"   cell = "C1"   value = rowCount(facturas)

now() queda como fecha y rowCount(...) como número, de modo que Excel puede darles formato y operar con ellos.

Muchas celdas seguidas → usa una sesión

Si vas a escribir varias celdas en el mismo archivo, abre una sesión y reusa session en cada Write Excel Cell — es mucho más rápido que abrir/cerrar el archivo en cada llamada del modo path.

Actividades relacionadas

• Read Excel Cell — leer una celda.
• Write Excel Range — escribir varias celdas a la vez.