Copy File

Copy File

Tipo: copy-file  ·  Paquete: Filesystem Activities v1.0.6  ·  Salida: string

Copia un archivo desde una ruta origen a una ruta destino, dejando el original en su lugar. Úsala para respaldar un archivo antes de modificarlo, duplicar una plantilla, o distribuir un documento a varias carpetas.

Cómo funciona

Copia el archivo de source a destination.

• Destino: destination es la ruta completa del archivo nuevo (carpeta + nombre), no solo la carpeta. Para conservar el nombre, usa pathJoin(carpetaDestino, fileName(origen)).
• Carpetas: si la carpeta de destino no existe, la crea (con las intermedias).
• Sobrescritura: por defecto no sobrescribe: si el destino ya existe, la actividad falla (a menos que pongas overwrite = true).
• Solo archivos: copia un archivo; para copiar una carpeta completa, lístala con List Files y copia cada archivo.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
source	string	—	Ruta del archivo origen.
destination	string	—	Ruta completa del archivo destino (carpeta + nombre).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
overwrite	bool	false	Reemplazar el destino si ya existe.

Salida

Devuelve un string con la ruta destino del archivo copiado (tal como la indicaste en destination).

Errores comunes

Mensaje	Causa y solución
Could not find file '…'.	El archivo source no existe. Compruébalo antes con File Exists.
The file '…' already exists.	El destino existe y overwrite es false. Pon overwrite = true o usa un nombre único (por ejemplo con la fecha).
The process cannot access the file '…' because it is being used by another process.	El origen o el destino está abierto en otro programa.
Access to the path '…' is denied.	Sin permiso en el origen o en la carpeta destino.
'source' es obligatorio. / 'destination' es obligatorio.	La expresión del parámetro dio nulo.

Ejemplo

Respaldar un archivo con la fecha en el nombre y trabajar sobre la copia:

Copy File   source = "C:/datos/maestro.xlsx"   destination = "C:/backups/maestro_" + today().ToString("yyyyMMdd") + ".xlsx"   overwrite = true   → output: respaldo
Log   message = "Respaldo creado en " + respaldo

No sobrescribe por defecto

A diferencia de Write File, Copy File tiene overwrite = false por defecto: falla si el destino existe. Pon overwrite = true si quieres reemplazarlo.

Actividades relacionadas

• Move File — mover en lugar de copiar (no deja el original).
• File Exists — comprobar antes de copiar.
• List Files — copiar varios archivos de una carpeta.