SFTP Move / Rename

SFTP Move / Rename

Tipo: sftp-move  ·  Paquete: SFTP Activities v1.1.0  ·  Salida: string

Mueve o renombra un archivo dentro del servidor SFTP. Muy usado para archivar lo procesado: tras descargar un archivo, moverlo a una carpeta /procesados del servidor para que no se vuelva a tomar.

Cómo funciona

Renombra sourcePath como destinationPath (ambas rutas remotas, con el nombre de archivo). Si están en la misma carpeta con distinto nombre, equivale a renombrar; si cambian de carpeta, a mover. La operación ocurre en el servidor, sin transferir el contenido.

• La carpeta de destino debe existir.
• Si ya existe un archivo en destinationPath, la mayoría de servidores rechaza el cambio: borra o renombra antes el existente, o usa un nombre único (por ejemplo con la fecha).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
sourcePath	string	—	Ruta remota de origen.
destinationPath	string	—	Ruta remota de destino, con el nombre de archivo.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanSftpSession	—	Sesión de SFTP Connect. Dentro de un body se hereda.

Salida

Devuelve un string con la nueva ruta remota del archivo (el mismo valor de destinationPath). Desde la versión 1.1.0 el Designer la ofrece como salida.

Errores comunes

Mensaje	Causa y solución
'sourcePath' es obligatorio. / 'destinationPath' es obligatorio.	Falta el parámetro o la expresión dio null.
'session' debe ser una ZoanSftpSession.	La actividad está fuera del body de SFTP Connect y no recibió session.
Error del servidor: archivo no encontrado	sourcePath no existe (quizá ya se movió en una ejecución anterior). Compruébalo con SFTP Exists.
Error del servidor al renombrar	El destino ya existe, su carpeta no existe o el usuario no tiene permiso de escritura.

Ejemplo

Archivar en el servidor tras descargar, con la fecha en el nombre para no chocar con archivos anteriores:

SFTP Download   remotePath = "/salida/datos.csv"   localPath = "C:/descargas/datos.csv"
SFTP Move / Rename   sourcePath = "/salida/datos.csv"   destinationPath = "/salida/procesados/datos_" + now().ToString("yyyyMMdd-HHmmss") + ".csv"

Mover en vez de borrar

Mover los archivos procesados a otra carpeta del servidor es más seguro que eliminarlos: conservas el original y la carpeta de entrada solo tiene lo pendiente.

Actividades relacionadas

• SFTP Delete — eliminar en vez de archivar.
• SFTP Create Directory — crear la carpeta destino.