|
|
|
|
- Gestión del progreso de la transferencia
- Tiempo límite de transferencia
- Permisos de usuarios
- Ruta relativa o absoluta
- Servidor FTP de tipo AS/400 FTP
- Permisos necesarios
Transfiere un archivo o directorio desde un servidor FTP (File Transfer Protocol) al ordenador actual.
Sintaxis
<Result> = FTPGet(<Connection identifier> , <File/Directory to retrieve> , <Destination file/directory> [, <WLanguage procedure> [, <Transfer mode>]])
<Result>: booleano - True si se realizó la transferencia,
- False en caso contrario. Para obtener más información sobre el error, utilice la función ErrorInfo con la constante errMessage.
Observación: El resultado puede ser incorrecto en algunos servidores Unix: es posible que no se encuentre un archivo o directorio existente.
<Connection identifier>: Integro Identificador de la conexión, devuelto por la función FTPConnect.
<File/Directory to retrieve>: Cadena de caracteres Nombre y ruta completa (o relativa) del archivo (o directorio) a recuperar. Este archivo (o directorio) se encuentra en el servidor FTP. Las secciones de la ruta están separadas por barras oblicuas ("/"). Atención: el nombre del directorio distingue entre mayúsculas y minúsculas. Se deben utilizar las mismas mayúsculas y minúsculas que se utilizaron en el servidor FTP. No se pueden utilizar caracteres comodín (* o?). Para obtener varios archivos, primero utilice la función FTPListFile para obtener el nombre de los archivos a recuperar.
Una ruta absoluta tiene el siguiente formato: "/<NombreDirectorio>/<NombreArchivo>". La jerarquía obtenida tiene el siguiente formato: "/<NombreDirectorio>/<NombreArchivo>". Una ruta relativa tiene el siguiente formato: "<NombreDirectorio>/<NombreArchivo>". La jerarquía obtenida tiene el siguiente formato: "/<DirectorioActualServidor>/<NombreDirectorio>/<NombreArchivo>".
Si este parámetro corresponde a un directoriose recuperan todos los archivos que se encuentran en este directorio.. Se crea un directorio con el mismo nombre en el ordenador actual en la ubicación especificada por <Fichero/Directorio de destino>.
Si este parámetro corresponde a un archivo:- si <Fichero/Directorio de destino> es un directorio encontrado en el ordenador actual, el fichero a recuperar se copia en el directorio de destino.
- si <Fichero/Directorio de destino> es un fichero encontrado en el ordenador actual, el fichero a recuperar es copiado y renombrado.
<Destination file/directory>: Cadena de caracteres Nombre y ruta completa (o relativa) del archivo (o directorio) de destino. Se puede utilizar una ruta de tipo UNC. <WLanguage procedure>: Nombre de Procedure Nombre de un procedimiento WLanguage llamado automáticamente para controlar el progreso de la transferencia. Este procedimiento puede ser un método global de clase (en el siguiente formato: <Nombre Clase>::<NombreMétodoGlobal>).
<Transfer mode>: Constante opcional de tipo Integer Modo de transferencia utilizado: | | ftpASCIIMode | Transferencia realizada en modo ASCII. Este modo se utiliza para transferir datos entre dos sistemas operativos diferentes, por ejemplo, de UNIX a Windows: el archivo transferido cambia al formato ASCII del sistema de destino. | ftpBinaryMode (Valor predeterminado) | Transferencia realizada en modo binario. El archivo es idéntico entre el envío y la recepción. |
Observaciones Tiempo límite de transferencia De forma predeterminada, todas las funciones FTP fallan si no se recibe ninguna respuesta del servidor FTP después de 20 segundos. Este tiempo de espera se puede modificar al conectarse al servidor FTP con la función FTPConnect. Permisos de usuarios Solo un usuario con permisos de lectura en el servidor FTP puede recuperar archivos del servidor FTP. En la mayoría de los casos, los usuarios "anónimos" tienen permisos de lectura. Ruta relativa o absoluta Las nociones de ruta relativa y ruta absoluta son de gran importancia en una aplicación FTP. - Una ruta que comienza con un slash se considera como una ruta absoluta: es la ruta con respecto a la raíz del servidor FTP (parámetro específico del servidor).
ej: /publicidad/usuario/JULIA - Si la ruta no comienza con un slash, se considera como una ruta relativa, es decir, una ruta con respecto al directorio en curso. El directorio en curso puede conocerse o modificarse con la función FTPCurrentDir.
Al conectarse a un sitio FTP, el directorio inicial ("home directory" del usuario) no necesariamente es la raíz del servidor FTP. Por lo tanto, se recomienda utilizar rutas relativas. Servidor FTP de tipo AS/400 FTP FTPGet no funciona correctamente en un servidor FTP AS/400. En este caso, le recomendamos que utilice FTPCommand con el comando FTP "RETR" (para más detalles, consulte la documentación sobre el servidor FTP). Clasificación Lógica de negocio / UI: Lógica de negocio
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|