OneDrive/SharePoint — Upload

OneDrive/SharePoint — Upload

Tipo: msfiles-upload  ·  Paquete: OneDrive / SharePoint v1.0.5  ·  Salida: Dictionary<string,object>

Sube un archivo del equipo a una ruta de la unidad (OneDrive o biblioteca de SharePoint) y devuelve sus datos, ID incluido, listos para compartirlo, moverlo o registrarlo. Admite archivos de hasta 250 MB.

Cómo funciona

Opera sobre la sesión creada con OneDrive/SharePoint — Connect. Pásala en el parámetro session, o coloca esta actividad dentro del body de Connect para heredarla automáticamente.

En destination indica la ruta completa dentro de la unidad, desde su raíz, incluyendo las carpetas y el nombre del archivo (Informes/2026/hoy.pdf), con / como separador. El nombre del archivo en la nube es el de destination, no el del archivo local, así que puedes renombrarlo al subirlo. Si la carpeta de destino aún no existe, créala antes con Create folder.

Comportamiento:

• Si ya existe un archivo con ese nombre en esa carpeta, se reemplaza su contenido (OneDrive y SharePoint lo guardan como una versión nueva, así que la anterior sigue en el historial de versiones). Por eso reintentar la subida es seguro.
• El archivo se envía completo en una sola solicitud; el límite es de 250 MB y archivos grandes tardan según la conexión de la máquina del robot.
• El archivo local no se modifica ni se borra.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	Ruta del archivo local a subir.
destination	string	—	Ruta de destino en la unidad, desde la raíz (carpetas + nombre de archivo). Ej.: Informes/reporte.pdf.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanMicrosoftFilesSession	—	Sesión de Connect. Dentro del body de Connect se hereda.

Salida

Devuelve un Dictionary<string,object> con los metadatos del archivo subido: id, name, isFolder (false), size (bytes), webUrl, parentId, modifiedTime, createdTime y childCount (null). Accede por clave: subido["id"] (úsalo para compartir, mover o descargar), subido["webUrl"] (para enviar el enlace a quien ya tiene acceso).

Errores comunes

Mensaje	Causa y solución
No hay una sesión de OneDrive/SharePoint disponible. Indica 'session' desde una actividad msfiles-connect o coloca esta actividad dentro del cuerpo de la actividad Connect para que herede la sesión automáticamente.	La actividad está fuera del body de Connect y no recibió session. Colócala dentro del body o pasa session = sesion.
'path' es obligatorio. / 'destination' es obligatorio.	El parámetro está vacío o su expresión dio null.
No se encontró el archivo local.	No existe un archivo en path en la máquina del robot. Revisa la ruta (y que sea un archivo, no una carpeta).
accessDenied (Microsoft Graph, 403)	La conexión no puede escribir en esa unidad o carpeta.
invalidRequest (Microsoft Graph, 400)	El nombre o la ruta tienen caracteres no permitidos en OneDrive/SharePoint (" * : < > ? / \ |).
Error de Microsoft Graph por tamaño	El archivo supera los 250 MB. Comprímelo o divídelo antes de subirlo.

Para subidas grandes o redes inestables, envuélvela en Retry: al reemplazar el archivo, repetirla no genera duplicados.

Ejemplo

OneDrive/SharePoint — Connect   credential = credential("m365-operaciones")
 └─ body:
      OneDrive/SharePoint — Upload   path = "C:\reportes\hoy.pdf"   destination = "Informes/" + DateTime.Now.ToString("yyyy-MM-dd") + ".pdf"   → output: subido
      OneDrive/SharePoint — Share    id = subido["id"]   scope = organization   → output: enlace
      Log   message = "Reporte publicado en " + enlace["link"]

Actividades relacionadas

• OneDrive/SharePoint — Download — descargar un archivo.
• OneDrive/SharePoint — Create folder — crear la carpeta de destino.
• OneDrive/SharePoint — Share — compartir el archivo subido.
• Todas las actividades de OneDrive / SharePoint