Clear Excel Range

Tipo: excel-clear-range · Paquete: Excel Activities v1.0.6 · Salida: —

Borra el contenido de un rango de celdas o de toda la hoja. Úsala para limpiar datos anteriores antes de escribir nuevos, o para vaciar un área de trabajo temporal. Opcionalmente puede borrar también el formato (colores, bordes), no solo los valores.

Cómo funciona

Vacía las celdas del range indicado (o, si lo omites, todo el rango usado de la hoja). Por defecto borra solo el contenido —valores y fórmulas— y conserva el formato; con clearFormat = true borra todo, también el formato. Acepta session o path — ver los dos modos.

A diferencia de las demás actividades de escritura, el archivo y la hoja deben existir.
Sobre una hoja vacía, sin range, no hace nada y no falla.
En modo rápido guarda el archivo al terminar; en modo sesión, al hacer Excel Save o Excel Close.

Parámetros requeridos

Ninguno — pero debes indicar session o path (o estar dentro del body de un Excel Open).

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` (requerido si no hay sesión). El archivo debe existir.
`sheet`	`string \| int`	—	Nombre o índice (desde 1) de la hoja. Si se omite, la primera.
`range`	`string`	—	Rango a borrar, ej. `"A1:D20"`, o una sola celda (`"B3"`). Si se omite, todo el rango usado.
`clearFormat`	`bool`	`false`	Borrar también el formato de las celdas. Con `false`, solo el contenido.

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
`Indica 'session' o 'path'.`	Falta `session` y `path`.
`No se encontró el archivo.`	`path` no existe. Esta actividad no crea archivos.
`There isn't a worksheet named '…'.`	No hay una hoja con ese nombre.
`There isn't a worksheet associated with that position.`	El índice de hoja no existe (o el nombre es solo un número y se tomó como índice).
`'…' is not A1 address or named range.`	`range` no es una dirección válida.
`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

Limpiar una hoja de resultados antes de volver a llenarla:

Excel Open   path = asset("tablero.xlsx")   → output: libro
Clear Excel Range   session = libro   sheet = "Resultados"
Write Excel Sheet   session = libro   sheet = "Resultados"   data = nuevosDatos
Excel Close  session = libro

Vaciar solo el bloque de datos de una plantilla, conservando títulos y formato:

Clear Excel Range   path = "C:/reportes/plantilla.xlsx"   sheet = "Detalle"   range = "A5:H500"

Actividades relacionadas

Write Excel Sheet — escribir limpiando la hoja en un solo paso.
Get Excel Used Range — saber qué área tiene datos.