Move File

Move File

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

Mueve un archivo de una ruta origen a una destino. El original deja de existir en su ubicación anterior. Como caso especial, si origen y destino están en la misma carpeta con distinto nombre, equivale a renombrar. Muy usada para archivar documentos ya procesados o reorganizar archivos descargados.

Cómo funciona

Mueve el archivo de source a destination.

• Destino: destination es la ruta completa del archivo (carpeta + nombre), no solo la carpeta.
• Carpetas: si la carpeta de destino no existe, la crea (con las intermedias).
• Sobrescritura: por defecto no sobrescribe: si el destino ya existe, falla (a menos que overwrite = true).
• Entre unidades: dentro de la misma unidad el movimiento es inmediato; hacia otra unidad o una carpeta de red, el archivo se copia y luego se borra el original.
• Solo archivos: no mueve carpetas.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
source	string	—	Ruta del archivo origen.
destination	string	—	Ruta completa del destino (o nuevo nombre, en la misma carpeta).

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 movido (tal como la indicaste en destination).

Errores comunes

Mensaje	Causa y solución
Could not find file '…'.	El archivo source no existe (quizá ya se movió en un intento anterior). Compruébalo con File Exists.
Cannot create a file when that file already exists.	El destino existe y overwrite es false. Pon overwrite = true o agrega al nombre algo único (fecha, id).
The process cannot access the file '…' because it is being used by another process.	El archivo 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.

Ejemplos

Archivar tras procesar y registrar dónde quedó:

Move File   source = ruta   destination = pathJoin("C:/procesados", fileName(ruta))   → output: archivado
Log   message = "Archivado en " + archivado

Renombrar:

Move File   source = "C:/datos/temp.csv"   destination = "C:/datos/clientes_final.csv"

No sobrescribe por defecto

Como Copy File, Move File tiene overwrite = false. Pon overwrite = true para reemplazar el destino.

Actividades relacionadas

• Copy File — copiar conservando el original.
• List Files — obtener los archivos a mover.