Excel Online — Clear range

Tipo: excelonline-clear-range · Paquete: Excel Online v1.0.4

Borra el contenido de un rango de celdas (deja las celdas vacías). Útil para limpiar una zona antes de volver a escribirla, de modo que no queden restos de una ejecución anterior.

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 y el rango en notación A1 (A1:Z100). Borra valores y fórmulas, pero conserva el formato (colores, bordes, formato de número), así que la plantilla queda lista para recibir datos nuevos. El cambio se guarda automáticamente.

Borrar un rango ya vacío no tiene efecto, así que es seguro repetirla. Recuerda que el borrado no tiene deshacer desde el robot; el historial de versiones del archivo en OneDrive o SharePoint sí permite recuperar el contenido.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`sheet`	`string`	—	Nombre de la hoja.
`range`	`string`	—	Rango a borrar en notación A1. Ej.: `A2:Z1000`.

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.` / `'range' 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)	`range` no es una dirección A1 válida.

Ejemplo

Excel Online — Connect   credential = credential("m365-finanzas")   path = "Reportes/Reporte.xlsx"
 └─ body:
      Excel Online — Clear range   sheet = "Datos"   range = "A2:Z1000"
      Excel Online — Write range   sheet = "Datos"   range = "A2:C" + (nuevosDatos.Rows.Count + 1)   values = nuevosDatos

Actividades relacionadas

Excel Online — Write range — escribir tras limpiar.
Excel Online — Used range — conocer el rango a limpiar.
Excel Online — Read range — leer un rango.
Todas las actividades de Excel Online