Microsoft 365 OneDrive

Descripcion

Este modulo integra Microsoft OneDrive mediante Microsoft Graph API. Operaciones disponibles:

• Listar archivos: Lista archivos y carpetas de una ubicacion especifica o raiz. Devuelve metadata incluyendo tipo MIME, tamano y URLs.
• Buscar archivos: Busca archivos por nombre o extension en todo el OneDrive.
• Descargar archivo: Descarga el contenido de un archivo. Lo retorna codificado en Base64 junto con metadata (nombre, tamano, tipo MIME).
• Subir archivo: Sube contenido (Base64 o texto) a una ubicacion especifica. Soporta carpeta destino configurable.
• Crear carpeta: Crea una nueva carpeta con deteccion de conflictos (renombra automaticamente si ya existe).
• Eliminar archivo/carpeta: Elimina un elemento por ID.
• Obtener info: Obtiene metadata detallada de un archivo o carpeta incluyendo ruta y carpeta padre.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Microsoft OAuth configurada
operation	select	Si	Operacion a realizar

Sub-nodo List Files

Parametro	Tipo	Requerido	Descripcion
folderId	string	No	ID de la carpeta (default: root)
top	string	No	Maximo de resultados (default: 50)
outputKey	string	No	Clave de salida (default: files)

Sub-nodo Download File

Parametro	Tipo	Requerido	Descripcion
fileId	string	Si	ID del archivo a descargar
outputKey	string	No	Clave de salida (default: fileContent)

Sub-nodo Upload File

Parametro	Tipo	Requerido	Descripcion
fileName	string	Si	Nombre del archivo a crear
folderId	string	No	Carpeta destino (default: root)
contentKey	string	No	Clave en data con el contenido (default: fileContent)

Sub-nodo Search Files

Parametro	Tipo	Requerido	Descripcion
query	string	Si	Termino de busqueda (ej: .xlsx, informe)
top	string	No	Maximo de resultados (default: 25)

Sub-nodo Delete File

Parametro	Tipo	Requerido	Descripcion
fileId	string	Si	ID del archivo a eliminar

Credenciales

Requiere credenciales de tipo Microsoft OAuth2 con:

• Scopes: Files.ReadWrite, Files.ReadWrite.All
• El modulo gestiona el refresh del token automaticamente

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "files": [
      {
        "id": "abc123",
        "name": "reporte.xlsx",
        "size": 45678,
        "createdTime": "2026-01-01T00:00:00Z",
        "modifiedTime": "2026-03-20T10:00:00Z",
        "webUrl": "https://onedrive.live.com/...",
        "isFolder": false,
        "isFile": true,
        "mimeType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "childCount": 0
      }
    ]
  },
  "_meta_": { "operation": "listFiles", "microsoftService": "onedrive" }
}

Ejemplo de Uso

Caso basico - Subir archivo

{
  "credentials_id": "mi-cuenta-ms365",
  "operation": "uploadFile",
  "fileName": "informe-mensual.pdf",
  "folderId": "root",
  "contentKey": "pdfContent"
}

API Utilizada

• Microsoft Graph API - OneDrive endpoints (/me/drive/root/children, /me/drive/items/{id})

Notas

• El contenido descargado se retorna en Base64 para facilitar su procesamiento posterior
• Al subir, el contenido se intenta decodificar desde Base64; si falla, se trata como UTF-8
• La creacion de carpetas usa conflictBehavior: rename para evitar errores si ya existe
• Los archivos se distinguen con los flags isFolder e isFile en la salida

Nodos Relacionados

• MS365 Excel - Archivos Excel en OneDrive
• MS365 Outlook - Correo electronico con Outlook
• MS365 Calendar - Calendario de Microsoft 365