4D Doc Center : FTP

4D Internet Commands v14

FTP_Send


FTP_Send ( ftp_ID ; rutaLocal ; rutaServidor ; Progreso ) -> resultado

Parámetro	Tipo	Descripción
ftp_ID	Entero largo	Referencia de una conexión FTP
rutaLocal	Texto	Ruta de acceso local del documento a enviar
rutaServidor	Texto	Ruta de acceso del documento en el servidor FTP
Progreso	Entero	1 = Mostrar progreso, 0 = Ocultar progreso
resultado	Entero	Código de error

Descripción

El comando FTP_Send envía el documento designado por rutaLocal a la ubicación designada por rutaServidor. Si se produce un error de estado de archivo FTP, FTP_Send lo devuelve inmediatamente.

ftp_ID es la referencia entero largo de la sesión FTP establecida con FTP_Login.

rutaLocal es la ruta del documento a enviar. Si pasa una cadena vacía, aparece la caja de diálogo estándar de apertura de archivos. Si rutaLocal es un nombre de archivo simple (sin ruta de acceso), el comando busca este archivo en la carpeta que contiene el archivo de estructura de la base de datos (con 4D monopuesto) o en la carpeta de 4D Client (con 4D Server). Al igual que con todas las rutas de acceso a documentos locales, los directorios deben estar separados por un delimitador apropiado para la plataforma. Para obtener más información, consulte la sección Glosario y terminología.

Nota: los comandos FTP trabajan con documentos cuyos nombres tienen una longitud limitada. Para obtener más información, consulte la sección Transferencia de archivos, Presentación.

rutaServidor designa la ruta de acceso al formato Unix del documento a crear. rutaServidor indica el nuevo nombre del archivo una vez recibido por el servidor FTP. Si rutaLocal es una cadena vacía que permite al usuario elegir un archivo del disco, rutaServidor también puede ser una cadena vacía, en cuyo caso se utilizará el nombre del archivo seleccionado.

rutaServidor puede ser una ruta de acceso Unix completa o simplemente un nombre de archivo:

Si pasa una ruta de acceso completa, el archivo especificado se ubicará en el directorio indicado por rutaServidor.
Si sólo pasa un nombre de archivo, o cadenas vacías en la selección del archivo, el archivo será enviado al directorio de trabajo actual [CWD].

Si el archivo o la ruta no pueden interpretarse correctamente, el comando devolverá un error. Si el usuario no tiene los privilegios suficientes para enviar un archivo a ese directorio, se devuelve un error. Al igual que con todas las rutas de acceso a los documentos Unix, la ruta debe utilizar barras oblicuas como separadores ("/"). Para obtener más información, consulte la sección Glosario y terminología.

Nota: el servidor FTP también puede imponer limitaciones específicas relativas a la longitud o caracteres para los nombres de archivo.

El parámetro progreso indica si el termómetro de progreso. Pase 1 para mostrar termómetro de progreso ó 0 para ocultarlo.

Ejemplo 1

 $OK:=False

 Case of

    :(FTP_Login("ftp.4d.com";"anonymous";vEmailID;vFTP_ID;vFTP_Msg)#0)

    :(FTP_Progress(-1;-1;"Progress window";"Getting requested file…";"Cancel")#0)

    :(FTP_Send(vFTP_ID;"My Hard Drive:Documents:July Sales Report";"/pub/reports/July_sales";1)#0)

    :(FTP_Logout(vFTP_ID)#0)

    Else

       $OK:=True `todos los comandos son ejecutados sin error

 End case

Nota: para mayor información sobre este uso particular de la estructura Case of, consulte el Anexo A: Consejos de programación 4D Internet Commands.

Ejemplo 2

$error:=FTP_Send(vFTP_ID;"";"";1)