OneDrive/SharePoint — Copy

OneDrive/SharePoint — Copy

Tipo: msfiles-copy  ·  Paquete: OneDrive / SharePoint v1.0.5

Crea una copia de un archivo o carpeta en la unidad. Puedes elegir el nombre de la copia y la carpeta de destino; ideal para generar un documento nuevo a partir de una plantilla.

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.

Por defecto la copia mantiene el nombre y queda en la misma carpeta; cambia name y folderId para personalizarlo. La carpeta de destino debe estar en la misma unidad de la sesión. Copiar una carpeta copia también todo su contenido.

La copia termina en segundo plano

En Microsoft 365 la copia es una operación asíncrona: la actividad termina en cuanto Microsoft acepta la solicitud, y la copia puede tardar unos segundos (o más, en carpetas grandes) en aparecer. La actividad no devuelve el ID de la copia ni espera a que termine. Para usarla después, búscala con List files (con una espera breve o dentro de un Retry).

Si copias en la misma carpeta sin cambiar name, la copia choca con el original por el nombre; indica siempre un name distinto en ese caso.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
id	string	—	ID del archivo o carpeta a copiar.

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	—	Nombre de la copia, con extensión. Si se omite, el mismo nombre del original.
folderId	string	—	ID de la carpeta de destino, en la misma unidad. Si se omite, la misma carpeta del original.

Salida

Esta actividad no devuelve ningún valor.

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.	id 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.
accessDenied (Microsoft Graph, 403)	La conexión no puede escribir en la carpeta de destino.

Los fallos que ocurren mientras Microsoft 365 hace la copia (por ejemplo, un nombre repetido) no llegan a la actividad; por eso conviene confirmar que la copia aparece antes de depender de ella.

Ejemplo

Crear el documento de un cliente a partir de una plantilla:

OneDrive/SharePoint — Connect   credential = credential("m365-operaciones")
 └─ body:
      OneDrive/SharePoint — Copy   id = idPlantilla   name = "Propuesta " + cliente + ".docx"   folderId = idCarpetaPropuestas
      Delay   milliseconds = 5000
      OneDrive/SharePoint — List files   folderId = idCarpetaPropuestas   → output: propuestas

Actividades relacionadas

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