Excel Save (Session)

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

Guarda a disco los cambios de una sesión de Excel sin cerrarla. Útil para hacer guardados intermedios durante un proceso largo (para no perder el avance), o para guardar una copia en otra ruta (equivalente a “Guardar como”).

Cómo funciona

Persiste los cambios de la sesión al archivo. Si indicas savePath, escribe una copia en esa ruta; si lo omites, guarda en la ruta original. En ambos casos la sesión sigue abierta.

savePath no cambia la ruta de la sesión: los siguientes Excel Save sin savePath y el Excel Close final vuelven a guardar en la ruta original.
Si ya existe un archivo en la ruta de destino, se sobrescribe. Las carpetas que falten se crean.
La extensión de destino debe ser .xlsx, .xlsm, .xltx o .xltm.
Dentro del body de un Excel Open puedes omitir session.
Sobre una sesión ya cerrada, no hace nada.

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
`savePath`	`string`	—	Guardar una copia en una ruta distinta (Guardar como). Omítelo para guardar en la ruta original.

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. Pasa la variable de salida de Excel Open.
`Extension 'pdf' is not supported. Supported extensions are '.xlsx', '.xlsm', '.xltx' and '.xltm'.`	`savePath` tiene una extensión que no es de Excel. Para un PDF, guarda y usa Excel to PDF.
`The process cannot access the file '…' because it is being used by another process.`	El archivo de destino está abierto en Excel u otro programa. Ciérralo y reintenta.
`Workbooks need at least one worksheet.`	La sesión empezó con un archivo que no existía y todavía no tiene ninguna hoja. Escribe algo antes de guardar.

Ejemplo

Guardado intermedio dentro de un bucle largo, y una copia final con fecha:

Excel Open   path = asset("acumulado.xlsx")   → output: libro
For Each   items = lotes   itemVariable = lote
 └─ activities:
      Append Excel Rows   session = libro   data = lote
      Excel Save   session = libro          // guardado intermedio por seguridad
Excel Save   session = libro   savePath = "C:/backups/acumulado_" + today().ToString("yyyyMMdd") + ".xlsx"
Excel Close  session = libro

Actividades relacionadas

Excel Close — guardar y cerrar al terminar.
Excel Open — abrir la sesión.
Excel to PDF — convertir el archivo guardado a PDF.