Clear Excel Range

Clear Excel Range

Tipo: excel-clear-range  ·  Paquete: Excel Activities v1.0.0

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 área con datos de la hoja). Por defecto borra solo el contenido; con clearFormat = true también quita el formato. Acepta session o path — ver los dos modos.

Parámetros requeridos

Ninguno — pero debes indicar session o path.

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.
range	expresión	Rango a borrar, ej. "A1:D20". Por defecto, todo el área usada.
clearFormat	booleano	Borrar también el formato de las celdas. Por defecto false (solo contenido).

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

Borrar contenido, no eliminar filas

Clear Excel Range deja las celdas vacías pero no elimina filas ni desplaza el contenido de alrededor. Si necesitas reemplazar por completo una hoja, Write Excel Sheet ya la limpia antes de escribir (con clearSheet = true).

Actividades relacionadas

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