OneDrive/SharePoint — Connect

OneDrive/SharePoint — Connect

Tipo: msfiles-connect  ·  Paquete: OneDrive / SharePoint v1.0.0  ·  Salida: ZoanMicrosoftFilesSession

Abre una sesión autenticada con OneDrive o SharePoint a través de Microsoft Graph. Es el punto de partida del paquete: las actividades de archivos (subir, descargar, listar, mover…) y las de listas de SharePoint trabajan sobre esta sesión.

Cómo funciona

Se autentica con una conexión OAuth de Microsoft 365 de Nexus y resuelve el drive sobre el que operar. 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 Close.

Drive y sitio

Las actividades de archivos usan driveId (OneDrive del usuario por defecto, o una biblioteca de documentos de SharePoint). Las de listas de SharePoint requieren siteId. Para app-only, indica mailbox.

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
mailbox	texto	Usuario (email/UPN) cuyo OneDrive usar. Obligatorio para acceso app-only. Omítelo para el usuario firmado.
driveId	texto	ID del drive de archivos. Por defecto, el OneDrive del usuario. Usa el ID del drive de una biblioteca de SharePoint para apuntar a SharePoint.
siteId	texto	ID del sitio de SharePoint — solo necesario para las actividades de listas de SharePoint.

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 ZoanMicrosoftFilesSession. 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

OneDrive/SharePoint — Connect   credential = "m365-operaciones"
 └─ body:
      OneDrive/SharePoint — Upload   path = "C:\\reportes\\hoy.pdf"   destination = "Documents/Informes/hoy.pdf"   → output: subido
      OneDrive/SharePoint — Share    id = subido["id"]   email = "cliente@correo.com"   role = view

Archivos vs. Listas

Las actividades de archivos usan driveId (OneDrive por defecto, o una biblioteca de documentos de SharePoint). Las de listas de SharePoint requieren siteId en Connect. Sube/descarga por ruta (Documents/archivo.pdf); usa asPdf para exportar documentos de Office a PDF.

Actividades relacionadas

• OneDrive/SharePoint — Upload — subir un archivo.
• OneDrive/SharePoint — List files — listar o buscar archivos.
• SharePoint — Get list items — leer una lista de SharePoint.
• Todas las actividades de OneDrive / SharePoint