SYNC

Transferencia de archivos nuevos y modificados . Opcionalmente eliminar los archivos hurfanos.

Sintaxis: SYNC(local_dir, remoto_dir, mtodo,SUBDIRS,comodin)

  • local_dir: Directorio local para la sincronizacin .Este directorio debe existir , antes de utilizar SYNC.
  • remote_dir: Directorio remoto para la sincronizacin.Este dirctorio debe existir antes de utilizar SYNC.
  • method:
    UPLOAD Sincronizar dir_remoto de local_dir. Todos los archivos de local_dir remoto se cargarn. Si existe un archivo en ambas ubicaciones, ser cargado cada vez que el archivo loal_dir, sea mas reciente.
    DOWNLOAD Sincronizar local_dir, con local_dir remoto. Todos los archivos de dir_remoto que no existen en local_dir se descargarn. Si existe un archivo en ambas ubicaciones se descargar, cada vez que el archivo dir_remoto sea mas reciente.
    UPLOAD_DELETE Sincronizar dir_remoto de local_dir. Todos los archivos de local_dir que no existen en dir_remoto se cargarn. Si existe un archivo en ambas ubicaciones, ser cargado cada vez que el archivolocal_dir sea mas reciente. Ademas todos los archivos dir_remoto que no existen en local_dir ( archivos hurfanos, seran eliminados ).
    DOWNLOAD_DELETE Sincronizar local_dir de dir_remoto. Todos los archivos de dir_remoto que no existen en local_dir se descargaran. Si existe un archivo en ambas ubicaciones se descargar cada vez que el archivodir_remoto sea mas reciente. Adems todos los archivos local_dir que no existen en dir_remoto ( archivos hurfanos )sern eliminados.
  • SUBDIRS (opcional): Use este parmetro si desea ScriptFTP para sincronizar directorios, .
  • comodn (opcional): Use este parmetro para decir SYNC para sincronizar solo los archivos cuyos nombres coincidan con el comodn. Si este parmetro no usa SYNC se sincronizan todos los archivos.

Comentarios:

  • El comando SYNC siempre necesita permisos de escritura en el sitio FTP, ya que se crear un archivo temporal remoto, para el clculo de diferencia de tiempode cliente a servidor. Este valor es necesario, para saber si un archivo local es mas reciente que su equivalente remoto, ( o veceversa ). Sin embargo, si Ud quiere sincronizarun directorio local dsde un solo control remoto ( descargar ), y no tener privilegios de escritura en el servidor, se puede establecer esta diferencia de tiempo de forma manual, utilizando el comando SETCLOCKDIFF
  • Si DOWNLOAD_DELETE oUPLOAD_DELETE y SYNC se utiliza y es incapaz de eliminar ciertos archivos hurfanos o directorios, solo se mostrar una advertencia.No se detendr y generar un error en este caso.
  • SYNC comprobar si local_dir y dir_remoto, ya existan antes de comenzar la sincronizacin. Si esta comprobacin no se mostrase. Si este chequeo falla, mostrar un error y abortar

comando de compativilidad:
ScriptFTP 2.1 realizado el 2 de febrero de 2006: El parmetro opcional "comodn" se aade.
ScriptFTP 2.2 Realizado el 4 de Abril de 2006: El significado del tercer parmetro ha sido modificado.La UPLOAD y los parmetros de DOWNLOAD, ya no realizan ninguna eliminacin de archivos, utilizar , UPLOAD_DELETE and DOWNLOAD_DELETE en su lugar.

Valor de retorno:
SYNC devueve "OK" si todas las operaciones de sincronizacin, con excepcin de la eliminacin de archivoshurfanos, tubieron xito.
Si SYNC falla, devolver un cdigo de error. UD puede recuperar el valor de retorno, y ejecutar diversas operaciones en funcin de este valor. Ver el ( control de errores )

Ver tambin:
GETFILE
PUTFILE
SETCLOCKDIFF

Ejemplos:

# Conectar a servidirFTP
OPENHOST("ftp.myhost.com","myuser","mypassword")

# Sincronizar al directorio local, desde sitio FTP
SYNC("C:\accounting","/accounting",DOWNLOAD,SUBDIRS)

# Cerrar conexin
CLOSEHOST

# Conectar al servidorFTP, usando FTP over SSL (seguro)
SETPROTOCOL(FTPS_EXPLICIT)
OPENHOST("ftp.myhost.com","myuser","mypassword")

# SIncronice a sitio WEB, dsede un directorio local
SYNC("C:\local_website","/www",UPLOAD_DELETE)

# Cierre conexin
CLOSEHOST

# Conectar al servidor
OPENHOST("ftp.myhost.com","myuser","mypassword")

# Sincronizar solo un archivo
SYNC("C:\accounting","/accounting",DOWNLOAD,"accounts.xls")

# Cerrar conexin
CLOSEHOST

# Conectar al servidor
OPENHOST("ftp.myhost.com","myuser","mypassword")

# Sincronizar todos los archivos Excel, de un sitio FTP
SYNC("C:\accounting","/accounting",DOWNLOAD,SUBDIRS,"*.xls")

# Tambin se puede omitir el parmetro SUBDIRS :
# SYNC("C:\accounting","/accounting",DOWNLOAD,"*.xls")

# Desconectar
CLOSEHOST