Excel Open (Session)

Excel Open (Session)

Tipo: excel-open  ·  Paquete: Excel Activities v1.0.0  ·  Salida: ZoanExcelSession

Abre un libro de Excel y devuelve una sesión (ZoanExcelSession) que compartes con las demás actividades de Excel. Es el inicio del modo sesión, recomendado cuando vas a hacer varias operaciones sobre el mismo archivo: abrirlo una sola vez es mucho más rápido que abrir y cerrar en cada paso.

Si el archivo no existe, lo crea.

Cómo funciona

Tienes dos formas de uso:

• Con variable de salida: guardas la sesión en una variable (ej. libro), la pasas a las actividades con session = = libro, y al final cierras con Excel Close.
• Con body: las actividades dentro del sub-flujo trabajan sobre el libro y, al terminar, este se guarda y se cierra automáticamente. No necesitas un Excel Close.

Parámetros requeridos

Parámetro	Editor	Descripción
path	expresión	Ruta al archivo .xlsx. Se crea si no existe. Admite expresiones (ej. = asset("datos.xlsx")).

Parámetros opcionales

Ninguno.

Sub-flujos (lanes)

body opcional

Actividades a ejecutar con este libro. Si se omite, devuelve la sesión como salida (y debes cerrarla tú con Excel Close).

Salida

Devuelve un ZoanExcelSession. Pásalo como session a las demás actividades de Excel.

Ejemplo

Con variable de salida:

Excel Open   path = = asset("reporte.xlsx")   → output: libro
Write Excel Sheet   session = = libro   sheet = "Datos"     data = = tabla
Write Excel Cell    session = = libro   sheet = "Resumen"   cell = "B2"   value = = total
Excel Close  session = = libro

Modo rápido para una sola operación

Si solo vas a hacer una lectura o escritura, no necesitas abrir una sesión: usa directamente el parámetro path de la actividad correspondiente, que abre y cierra el archivo por ti. Ver modo rápido vs. sesión.

Actividades relacionadas

• Excel Close — guardar y cerrar la sesión.
• Excel Save — guardar sin cerrar.
• Read Excel Sheet / Write Excel Sheet — operar con la sesión.