Excel Online — Connect

Excel Online — Connect

Tipo: excelonline-connect  ·  Paquete: Excel Online v1.0.0  ·  Salida: ZoanExcelOnlineSession

Abre un libro de Excel Online (en OneDrive o SharePoint) a través de Microsoft Graph. Es el punto de partida del paquete: todas las actividades de lectura y escritura trabajan sobre esta sesión, que representa un libro abierto. Es el equivalente en la nube del paquete Excel local.

Cómo funciona

Se autentica con una conexión OAuth de Microsoft 365 de Nexus y abre el libro indicado por path o por itemId. Tiene dos formas de uso:

• Con body: las actividades que coloques dentro heredan la sesión automáticamente; al terminar el bloque, se cierra sola.
• Sin body: devuelve la sesión como salida; guárdala en una variable, pásala por session a las demás actividades y ciérrala con Excel Online — Close.

Autenticación

La autenticación la define la conexión OAuth de Microsoft 365. Para app-only indica mailbox (el usuario cuyo OneDrive se usa). Para un libro en SharePoint, pasa el driveId de la biblioteca de documentos.

Parámetros requeridos

Parámetro	Editor	Descripción
credential	credencial	Nombre de la conexión OAuth de Microsoft 365 configurada en Nexus.

Parámetros opcionales

Parámetro	Editor	Descripción
path	texto	Ruta del libro en el drive. Usa esto o itemId. Ej.: Documents/Presupuesto.xlsx.
itemId	texto	ID de elemento del libro (alternativa a path).
driveId	texto	ID del drive. Por defecto, el OneDrive del usuario. Usa el ID del drive de una biblioteca de SharePoint para apuntar a SharePoint.
mailbox	texto	Usuario (email/UPN) cuyo OneDrive usar. Obligatorio para acceso app-only. Omítelo para el usuario firmado.

Sub-flujos

body opcional

Actividades a ejecutar dentro de la sesión. Heredan la sesión automáticamente y, al terminar, esta se cierra.

Salida

Devuelve un ZoanExcelOnlineSession. Si usas body no necesitas la salida (la sesión se hereda sola). Sin body, asígnala a una variable y pásala como session a las demás actividades.

Ejemplo

Excel Online — Connect   credential = "m365-finanzas"   path = "Documents/Presupuesto.xlsx"
 └─ body:
      Excel Online — Read range   sheet = "Datos"   range = "A1:E20"   has-headers = true   → output: tabla
      Excel Online — Write cell   sheet = "Datos"   cell = "G1"   value = "Procesado"

Sin “Guardar” — autoguarda

Excel Online guarda automáticamente cada escritura, por eso no existe una actividad Save. Abre el libro por ruta (Documents/archivo.xlsx) o por itemId. Para un libro en SharePoint, pasa el driveId de la biblioteca de documentos.

Actividades relacionadas

• Excel Online — Read range — leer un rango de celdas.
• Excel Online — Write range — escribir un rango.
• Excel Online — Close — cerrar la sesión (modo sin body).
• Todas las actividades de Excel Online