Excel Close (Session)

Excel Close (Session)

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

Guarda y cierra una sesión de Excel abierta con Excel Open. Es la pareja obligatoria de Excel Open en el modo sesión: persiste los cambios a disco y libera el libro de la memoria.

Cómo funciona

Guarda los cambios pendientes de la sesión en la ruta con la que se abrió (salvo que pongas save = false) y la cierra. Después de cerrarla, la sesión ya no sirve: un Excel Save posterior sobre ella no guarda nada.

• Cerrar dos veces la misma sesión no falla: la segunda vez no hace nada.
• Dentro del body de un Excel Open puedes omitir session: cierra el libro del body.
• Si guardaste una copia con savePath en Excel Save, Excel Close guarda igualmente en la ruta original.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
session	ZoanExcelSession	—	La sesión devuelta por Excel Open.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
save	bool	true	Guardar los cambios antes de cerrar. Ponlo en false para descartar los cambios no guardados.

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
'session' debe ser una sesión de Excel válida (usa excel-open).	session está vacía o no es una sesión de Excel (por ejemplo, una ruta). Pasa la variable de salida de Excel Open.
The process cannot access the file '…' because it is being used by another process.	El archivo está abierto en Excel u otro programa al guardar. Ciérralo y reintenta.
Workbooks need at least one worksheet.	La sesión empezó con un archivo que no existía y no se escribió ninguna hoja. Escribe algo antes o cierra con save = false.

Ejemplo

Excel Open   path = asset("reporte.xlsx")   → output: libro
Write Excel Cell   session = libro   cell = "A1"   value = "Procesado"
Excel Close  session = libro

Descartar los cambios (por ejemplo, tras una validación fallida):

Excel Close  session = libro   save = false

Cierra siempre, incluso si algo falla

Para garantizar que el archivo se cierra aunque una actividad intermedia falle, envuelve las operaciones en un Try / Catch y pon Excel Close en el lane finally. Alternativamente, usa el body de Excel Open, que cierra automáticamente.

Actividades relacionadas

• Excel Open — abrir la sesión.
• Excel Save — guardar sin cerrar (para guardados intermedios).