OneDrive/SharePoint — Move

OneDrive/SharePoint — Move

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

Mueve un archivo o carpeta a otra carpeta de la unidad y, de paso, puede renombrarlo. El elemento conserva su ID, su historial de versiones y sus permisos de uso compartido; solo cambia de ubicación (y de nombre, si lo indicas). Es la forma natural de archivar lo procesado.

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.

Indica el elemento con su id y la carpeta de destino con folderId. Para renombrarlo en el mismo paso, usa name. Para solo renombrar, pasa como folderId la carpeta en la que ya está (info["parentId"] de Get info).

Ten en cuenta:

• La operación es inmediata y la carpeta de destino debe estar en la misma unidad de la sesión.
• Si en el destino ya hay un elemento con el mismo nombre, Microsoft 365 rechaza el movimiento (no sobrescribe). Usa name para darle uno distinto.
• Volver a moverlo a la carpeta en la que ya está no cambia nada.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
id	string	—	ID del elemento a mover.
folderId	string	—	ID de la carpeta de destino.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanMicrosoftFilesSession	—	Sesión de Connect. Dentro del body de Connect se hereda.
name	string	—	Nuevo nombre, con extensión. Si se omite, conserva el actual.

Salida

Devuelve un Dictionary<string,object> con los datos actualizados del elemento: id (el mismo de antes), name, isFolder, size, webUrl (la nueva dirección), parentId (la carpeta de destino), modifiedTime, createdTime y childCount.

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.
'id' es obligatorio. / 'folderId' es obligatorio.	El parámetro está vacío o su expresión dio null.
itemNotFound (Microsoft Graph, 404)	No existe el elemento o la carpeta de destino en la unidad de la sesión.
nameAlreadyExists (Microsoft Graph, 409)	Ya hay un elemento con ese nombre en la carpeta de destino. Indica otro name (por ejemplo, con la fecha).
invalidRequest (Microsoft Graph, 400)	El nuevo nombre tiene caracteres no permitidos, o intentaste mover una carpeta dentro de sí misma.

Ejemplo

Archivar un reporte ya procesado con la fecha en el nombre:

OneDrive/SharePoint — Connect   credential = credential("m365-operaciones")
 └─ body:
      OneDrive/SharePoint — Move   id = idReporte   folderId = idCarpetaProcesados   name = "Procesado " + DateTime.Now.ToString("yyyy-MM-dd") + ".pdf"   → output: movido
      Log   message = "Archivado en " + movido["webUrl"]

Actividades relacionadas

• OneDrive/SharePoint — Copy — copiar en vez de mover.
• OneDrive/SharePoint — Create folder — crear la carpeta de destino.
• OneDrive/SharePoint — List files — localizar los IDs.
• Todas las actividades de OneDrive / SharePoint