FTP
Artículo 11/09/2023
7 colaboradores
Comentarios
En este artículo
Utilice el grupo de acciones FTP para cargar y descargar archivos y manipular directorios en servidores FTP.
Para establecer una conexión FTP, utilice la acción Abrir conexión FTP . El siguiente ejemplo tiene un host, puerto y credenciales especificados. Además, el tiempo de espera establecido hace que la acción falle si la conexión no se establece a tiempo.
Descargue archivos usando la acción Descargar archivos de FTP . El ejemplo siguiente muestra la variable de conexión en uso y la carpeta local que es el destino. El archivo remoto también se ha especificado y configurado para sobrescribir archivos existentes en la misma ubicación.
Cargue archivos usando la acción Cargar archivos en FTP especificando el archivo y la ubicación remota.
Abrir conexión FTP
Esta acción establece una conexión específica con un servidor FTP remoto y almacena esa conexión como una variable para su uso posterior.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
Host
No
Valor de texto Escriba la dirección del servidor FTP aquí.
Port
Sí
Valor numérico 21
Escriba el puerto del servidor FTP aquí.
Active mode
N/D
Valor booleano False
Especifica el modo de la conexión
Username
No
Valor de texto Especificar el nombre de usuario de la cuenta de FTP que va a usar
Contraseña
Sí
Entrada directa cifrada o valor de texto
Especificar la contraseña de la cuenta de FTP que va a usar
Temporización
Sí
Valor numérico 10
Establezca el tiempo, en segundos, que desea esperar a que se establezca la conexión antes de que se produzca un error en la acción
Variables producidas
Argumento
Type
Descripción
FTPConnection
Conexión FTP La conexión FTP
Excepciones
Excepción
Descripción
Error de inicio de sesión
Indica que se produjo un error de inicio de sesión
Error de conexión
Indica que hay un problema con la conexión
Mostrar directorio FTP
Esta acción devuelve los subdirectorios y archivos contenidos en el directorio actual de una conexión FTP.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
Connection
No
Conexión FTP La conexión FTP
Path
Sí
Valor de texto Ruta que desea mostrar.
Variables producidas
Excepciones
Excepción
Descripción
Error de lista
Indica que no se pudo mostrar el contenido de la carpeta
Error debido a la falta de conexión
Indica que no hay ninguna conexión abierta con el servidor FTP
Error debido a que el directorio no existe
Indica que no se encontró el directorio
Abrir conexión FTP segura
Esta acción establece una conexión segura específica con un servidor FTP remoto y almacena esa conexión como una variable para su uso posterior.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
Host
No
Valor de texto Escriba la dirección del servidor FTP aquí.
Port
Sí
Valor numérico 22
Escriba el puerto del servidor FTP aquí.
Active mode
N/D
Valor booleano True
Especifica el modo de la conexión
Secure FTP Protocol
N/D
SFTP, FTPS explícito, FTPS implícito
SFTP
Elija el protocolo FTP que desea usar para cifrar la conexión
Authentication method
N/D
Nombre de usuario y contraseña, clave privada, clave privada y frase de contraseña
Nombre de usuario y contraseña
Elija el método que desea usar para autenticarse en el servidor FTP
User name
No
Valor de texto Especificar el nombre de usuario de la cuenta de FTP que va a usar
Contraseña
Sí
Entrada directa cifrada o valor de texto
Especifique la contraseña de la cuenta de FTP que desea usar
Path to private key
No
Valor de texto Escriba la ruta de acceso del archivo a la clave privada que se usará para la autenticación
Frase de contraseña de clave privada
Sí
Entrada directa cifrada o valor de texto
Escriba una variable que contenga la frase de contraseña de clave privada aquí
Timeout
Sí
Valor numérico 10
Establezca el tiempo, en segundos, que desea esperar a que se establezca la conexión antes de que se produzca un error en la acción
Variables producidas
Argumento
Type
Descripción
SftpConnection
Conexión FTP Conexión SFTP
Excepciones
Excepción
Descripción
Error de inicio de sesión
Indica que se produjo un error de inicio de sesión
Error de conexión
Indica que hay un problema con la conexión
Cerrar conexión
Esta acción cierra una conexión FTP abierta.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
Connection
No
Conexión FTP La conexión FTP
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Excepción
Description
Error debido a la falta de conexión
Indica que no hay ninguna conexión abierta con el servidor FTP
Cambiar el directorio de trabajo
Esta acción establece el directorio de trabajo actual para una conexión FTP.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
Connection
No
Conexión FTP La conexión FTP
Set working directory to
No
Valor de texto Establecer la ruta de acceso que será el directorio de trabajo
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Excepción
Description
Error debido a la falta de conexión
Indica que no hay ninguna conexión abierta con el servidor FTP
Error debido a que el directorio no existe
Indica que no se encontró el directorio
Error debido a que no se puede cambiar el directorio de trabajo
Indica que no es posible cambiar el directorio de trabajo
Descargar archivos de FTP
Descarga uno o varios archivos de un servidor FTP.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
FTP connection
No
Conexión FTP La conexión FTP con la que trabajar. Esta variable se debe especificar previamente en una acción Abrir conexión FTP
Download into folder
No
Carpeta Carpeta que será el destino de los archivos que se descargarán
Archivos a descargar
No
Lista de archivos de FTP Archivos para descargar
Tipo de transferencia
N/D
Automático, Binario, ASCII
Automático
Introduzca ASCII o binario para especificar el método para descargar un solo archivo. Si el tipo de archivo es incierto o si se descarga más de uno, elija Auto para seguir las reglas de transferencia especificadas en las opciones
If file exists
N/D
Sobrescribir, no descargar, descargar con nombre único
Sobrescribir
Especifique qué hacer si el archivo ya existe. Sobrescribir escribe sobre el archivo original para que deje de estar accesible y descargar con nombre único agrega un guion bajo y un número secuencial al final
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Excepción
Description
Error debido a la falta de conexión
Indica que no hay ninguna conexión abierta con el servidor FTP
Error debido a que el archivo remoto no existe
Indica que el archivo no existe en el servidor FTP
Error debido a que el directorio no existe
Indica que no se encontró el directorio
Error debido a que se anuló la conexión FTP
Indica que se anuló la conexión FTP
Error debido a que no se puede descargar el archivo
Indica que no fue posible descargar el archivo
Descargar las carpetas de FTP
Descarga una o varias carpetas desde un servidor FTP.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
FTP connection
No
Conexión FTP La conexión FTP con la que trabajar. Esta variable se debe especificar previamente en una acción Abrir conexión FTP
Folder(s) to download
No
Lista de directorios de FTP Nombre de las rutas de carpetas o carpetas FTP que se van a descargar
Download into local folder
No
Carpeta Ruta completa del destino de las carpetas FTP que está descargando
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Excepción
Description
Error debido a la falta de conexión
Indica que no hay ninguna conexión abierta con el servidor FTP
Error debido a que el directorio remoto no existe
Indica que el directorio no existe en el servidor FTP
Error debido a que el directorio no existe
Indica que no se encontró el directorio
Error debido a que se anuló la conexión FTP
Indica que se anuló la conexión FTP
Error debido a que no se puede descargar el directorio
Indica que no fue posible descargar el directorio
Cargar archivos en FTP
Carga uno o varios archivos en un servidor FTP.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
FTP connection
No
Conexión FTP La conexión FTP con la que trabajar. Esta variable se debe especificar previamente en una acción Abrir conexión FTP
File(s) to upload
No
Lista de archivos Los archivos para cargar
Remote location
Sí
Valor de texto Ubicación en la que se cargarán los archivos
Transfer type
N/D
Automático, Binario, ASCII
Automático
Introduzca ASCII o binario para especificar el método para descargar un solo archivo. Si no sabe con seguridad el tipo de archivo o va a descargar más de uno, elija Automático para seguir las reglas de transferencia especificadas en Opciones
If file exists
N/D
Sobrescribir, no descargar, descargar con nombre único
Sobrescribir
Especifique qué hacer si el archivo ya existe. Sobrescribir escribe sobre el archivo original para que deje de estar accesible y descargar con nombre único agrega un guion bajo y un número secuencial al final
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Excepción
Description
Error debido a la falta de conexión
Indica que no hay ninguna conexión abierta con el servidor FTP
Error de archivo no encontrado
Indica que no se encontró el archivo
Error debido a que se anuló la conexión FTP
Indica que se anuló la conexión FTP
Error de carga de archivo
Indica que no se pudo cargar el archivo
Cargar las carpetas en FTP
Carga una o varias carpetas en un servidor FTP.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
FTP connection
No
Conexión FTP La conexión FTP con la que trabajar. Esta variable se debe especificar previamente en una acción Abrir conexión FTP
Folder(s) to upload
No
Lista de carpetas Las carpetas a cargar. Las carpetas que se van a cargar no deben existir en el directorio activo del servidor FTP
Remote location
No
Valor de texto Ubicación en la que se cargarán las carpetas
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Excepción
Description
Error debido a la falta de conexión
Indica que no hay ninguna conexión abierta con el servidor FTP
Error debido a que el directorio remoto no existe
Indica que el directorio no existe en el servidor FTP
Error debido a que se anuló la conexión FTP
Indica que se anuló la conexión FTP
Error al cargar el directorio
Indica que no se pudo cargar el directorio
Eliminar archivo FTP
Elimina uno o varios archivos de un servidor FTP.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
FTP connection
No
Conexión FTP La conexión FTP con la que trabajar. Esta variable se debe especificar previamente en una acción Abrir conexión FTP
Archivos para eliminar
No
Lista de archivos de FTP Archivos a eliminar
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Excepción
Description
Error debido a la falta de conexión
Indica que no hay ninguna conexión abierta con el servidor FTP
Error de archivo no encontrado
Indica que no se encontró el archivo
Error debido a que no se puede eliminar el archivo
Indica que no se ha podido eliminar el archivo
Cambiar el nombre del archivo FTP
Cambia el nombre de un archivo que se encuentra en un servidor FTP.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
FTP connection
No
Conexión FTP La conexión FTP con la que trabajar. Esta variable se debe especificar previamente en una acción Abrir conexión FTP
Archivo que se va a cambiar de nombre
No
Archivo FTP Archivo cuyo nombre se va a cambiar
Nuevo nombre de archivo
No
Valor de texto Nuevo nombre del archivo. Si ingresa un nombre con una ruta, el archivo también se moverá a esa ubicación. Si la ubicación no existe, lanzará una excepción
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Excepción
Description
Error debido a la falta de conexión
Indica que no hay ninguna conexión abierta con el servidor FTP
Error debido a que no se puede cambiar de nombre el archivo
Indica que no fue posible cambiar de nombre el archivo
Error de archivo no encontrado
Indica que no se encontró el archivo
Crear directorio FTP
Crea un directorio en un servidor FTP.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
FTP connection
No
Conexión FTP La conexión FTP con la que trabajar. Esta variable se debe especificar previamente en una acción Abrir conexión FTP
New directory
No
Directorio FTP El nuevo directorio. Si se especifica una ruta de acceso, se crearán todas las carpetas nuevas que conducen al nuevo directorio.
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Excepción
Descripción
Error de acceso denegado
Indica que esta cuenta no tiene acceso para una operación
Error debido a que el archivo ya existe
Indica que el archivo ya existe
Error al crear el directorio
Indica que no fue posible crear el directorio
Error debido a que el directorio no existe
Indica que no se encontró el directorio
Error debido a la falta de conexión
Indica que no hay ninguna conexión abierta con el servidor FTP
Eliminar el directorio FTP
Elimina un directorio de un servidor FTP.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
FTP connection
No
Conexión FTP La conexión FTP con la que trabajar. Esta variable se debe especificar previamente en una acción Abrir conexión FTP
Directory to delete
No
Directorio FTP La carpeta que se eliminará. Todo lo que se almacena en la carpeta también se eliminará.
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Excepción
Descripción
Error al eliminar el directorio
Indica que no fue posible eliminar el directorio
Error debido a que el directorio remoto no existe
Indica que el directorio no existe en el servidor FTP
Error debido a que no se puede cambiar el directorio de trabajo
Indica que no se pudo cambiar el directorio de trabajo
Error debido a la falta de conexión
Indica que no hay ninguna conexión abierta con el servidor FTP
Invocar comando FTP
Invoca el comando FTP literal especificado en el servidor.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
FTP connection
No
Conexión FTP La conexión FTP con la que trabajar. Esta variable se debe especificar previamente en una acción Abrir conexión FTP
FTP command
No
Valor de texto El comando para ejecutar junto con cualquier argumento. Por ejemplo, puede ejecutar FEAT o CHMOD aquí
Valid reply code(s)
Sí
Valor de texto Los códigos que podría devolver el comando, separados por punto y coma. Si el comando FTP devuelve un código que no se ingresó aquí, esta acción generará una excepción. Solo se aplica a conexiones simples FTP o FTPS
Variables producidas
Argumento
Type
Descripción
ReplyCode
Valor de texto El código real que se devolvió. Solo se aplica a conexiones simples FTP o FTPS
ReplyText
Valor de texto Texto devuelto por el servidor FTP
Excepciones
Excepción
Description
Error al invocar un comando
Indica que se ha producido un error al invocar un comando FTP
Error debido a la falta de conexión
Indica que no hay ninguna conexión abierta con el servidor FTP
Sincronizar directorios
Sincroniza los archivos y subdirectorios de una determinada carpeta con un directorio FTP remoto determinado.
Argumento
Opcionales
Acepta
Valor predeterminado
Descripción
FTP connection
No
Conexión FTP La conexión FTP con la que trabajar. Esta variable se debe especificar previamente en una acción Abrir conexión FTP
Synchronization direction
N/A
Remoto -> local (Descarga), Local -> Remoto (Carga)
Remoto -> local (Descarga)
Dirección del método de sincronización. Si la carpeta local se va a sincronizar con el directorio remoto (DESCARGA) o el directorio remoto se va a sincronizar con la carpeta local (CARGA)
Files to sync
N/D
Todos los archivos, solo los archivos que coinciden con el filtro de archivos, solo los archivos que no coinciden con el filtro de archivos
Todos los archivos
Elija si desea sincronizar todos los archivos o si desea usar un filtro de archivos para incluir o excluir un conjunto específico de archivos
Filtro de archivo
No
Valor de texto *
Patrón de nombre de archivo que controla qué archivos se incluirán o excluirán. Esta opción permite usar comodines como ".txt", "documento?.doc". La opción también permite varios filtros utilizando la coma como separador: " .txt,*.pdf,documento?".
Local folder
No
Carpeta Nombre de la carpeta local que se va a sincronizar
FTP directory
Sí
Directorio FTP /
Nombre del directorio FTP que se va a sincronizar
Delete if source is absent
N/D
Valor booleano False
Esta opción eliminará un archivo o una carpeta que existe en el directorio de destino y no en el origen.
Include subdirectories
N/D
Valor booleano True
Esta opción incluirá los subdirectorios en el proceso de sincronización.
Time difference in hours
Sí
Valor numérico 0
Diferencia horaria (en horas) del servidor remoto, en caso de que funcione en otra zona horaria.
Time difference in minutes
Sí
Valor numérico 0
Diferencia horaria (en minutos) del servidor remoto, en caso de que funcione en otra zona horaria.
Time difference ahead
N/D
Valor booleano True
Especifique si la zona horaria del servidor está adelantada o no.
Variables producidas
Argumento
Type
Descripción
FtpFilesAdded
Lista de archivos de FTP Lista de archivos FTP que existían inicialmente en el origen y que, después del proceso de sincronización, se agregaron al destino.
FtpFilesModified
Lista de archivos de FTP Lista de archivos FTP que existían inicialmente en el origen y en el destino y que, después del proceso de sincronización, se agregaron al destino.
FtpFilesDeleted
Lista de archivos de FTP Lista de archivos FTP que existían inicialmente en el directorio de destino y que, después del proceso de sincronización, se eliminaron.
FilesAdded
Lista de archivos Lista de archivos que existían inicialmente en el origen y que, después del proceso de sincronización, se agregaron al destino.
FilesModified
Lista de archivos Lista de archivos que existían inicialmente en el origen y en el destino y que, después del proceso de sincronización, se agregaron al destino.
FilesDeleted
Lista de archivos Lista de archivos que existían inicialmente en el directorio de destino y que, después del proceso de sincronización, se eliminaron.
Excepciones
Excepción
Description
Error de lista
Indica que no se pudo mostrar el contenido de la carpeta
Error debido a la falta de conexión
Indica que no hay ninguna conexión abierta con el servidor FTP
Error de archivo no encontrado
Indica que no se encontró el archivo
Error debido a que se anuló la conexión FTP
Indica que se anuló la conexión FTP
Error de carga de archivo
Indica que no se pudo cargar el archivo
Error debido a que el archivo remoto no existe
Indica que el archivo no existe en el servidor FTP
Error debido a que no se puede descargar el archivo
Indica que no fue posible descargar el archivo
Error al eliminar el directorio
Indica que no fue posible eliminar el directorio
Error de sincronización
Indica que el proceso de sincronización no se pudo realizar debido a un error inesperado.
