Durante el tiempo de ejecución, la actividad Enumerar archivos FTP se conecta a un servidor FTP y genera una lista de archivos desde la ubicación de directorio especificada utilizando una expresión regular especificada. La actividad Enumerar archivos FTP devuelve la lista de archivos a la orquestación utilizando el parámetro de salida directoryListing o fileListing.
Si la casilla de verificación Enumerar sólo archivos (NLST) no está seleccionada, se devuelve un listado completo de directorios, que incluye permisos de directorio, indicaciones de fecha y hora y propiedad, en el parámetro de salida directoryListing, como una única serie. Cuando se devuelve un listado completo de directorios como una serie, debe analizar el listado de directorios utilizando un esquema de archivo sin formato con la actividad Leer archivo sin formato. Si la casilla de verificación Enumerar sólo archivos (NLST) está seleccionada y la actividad Enumerar archivos FTP admite el formato del listado de directorios para su servidor FTP, se devuelve una estructura repetitiva con sólo nombres de archivos en el parámetro de salida fileListing. Cuando se devuelve una estructura repetitiva de nombres de archivos, no necesita analizar el listado de directorios y puede repetirse a lo largo de la lista utilizando una actividad Para cada o Bucle While.
En algunos casos, debe utilizar la actividad Enumerar archivos FTP junto a las actividades Obtener archivo FTP, Colocar archivo FTP, Suprimir archivo FTP y Renombrar archivo FTP para procesar un conjunto de archivos encontrados en un directorio FTP, mientras que en otros casos puede utilizar sólo la actividad Sondear directorio FTP.
Enlaces simbólicos con... | Enlaces simbólicos duros | Enlaces simbólicos blandos | Notas |
---|---|---|---|
Archivos | No admitidos | No admitidos | La actividad Enumerar archivos FTP no interpreta los enlaces simbólicos como archivos porque los archivos y, por lo tanto, los enlaces simbólicos con los archivos no son procesados por la actividad Enumerar archivos FTP durante el tiempo de ejecución. |
Directorios | Admitidos | Admitidos |
Campo | Descripción |
---|---|
En el directorio | Especifica el directorio del servidor FTP donde el Dispositivo de integración suprime el archivo especificado. Puede especificar un directorio utilizando una de las siguientes opciones:
Nota: UNIX:
Si especifica una vía de acceso al directorio relativa al conectarse a un servidor FTP en una máquina UNIX, compruebe que el directorio de inicio de FTP se ha especificado correctamente en el archivo /etc/password para la cuenta de usuario que se conecta al servidor FTP.
|
Archivo llamado | Especifica un patrón o expresión regular que define los nombres de archivos que se van a obtener del servidor FTP. El servidor FTP realiza el proceso de la expresión regular. Para obtener más información, consulte la documentación del servidor FTP sobre expresiones regulares. Normalmente,
los servidores FTP admiten los siguientes comodines en sus expresiones regulares:
Nota: Dado que el proceso de la expresión regular se realiza en el servidor FTP, es el servidor FTP el que determina la distinción entre mayúsculas y minúsculas.
Si el servidor FTP es sensible a las mayúsculas y minúsculas, la coincidencia de archivo realizada por la actividad Sondear directorio FTP también lo es.
|
Enumerar sólo archivos (NLST) | La casilla de verificación Enumerar sólo archivos (NLST) determina el tipo de listado de directorios devuelto por el botón Probar durante el tiempo de ejecución. Además, esta casilla de verificación define si el parámetro de salida fileListing o directoryListing se muestra en la tarea Correlacionar salidas y si es devuelto por la actividad durante el tiempo de ejecución.
|
Campo | Descripción |
---|---|
Reintentar | |
1) Esperar __ segundo(s) entre cada reintento. | El número de segundos que el Dispositivo de integración espera antes de intentar establecer una conexión con el servidor FTP. |
2) Intentar conectar __ veces antes de generar un error. | Especifica el total de reintentos: el número máximo de veces que
el Dispositivo de integración intenta establecer una conexión con el
servidor FTP antes de emitir un error. Si se despliega una orquestación que comienza con una actividad Enumerar archivos FTP y el Dispositivo de integración no puede conectarse con el servidor FTP especificado, el Dispositivo registra los errores de conexión como avisos en el registro del sistema hasta que se alcanza el total de reintentos. Cuando se alcanza el total de reintentos, el Dispositivo de integración registra un error en el registro del sistema, restablece el recuento de errores de conexión a cero y continúa intentando establecer una conexión con el servidor FTP. Por ejemplo, el usuario establece el recuento de reintentos en 3. El primer, el segundo y el tercer error de conexión aparecen en el registro del sistema como avisos. El Dispositivo de integración registra el cuarto error de conexión como un error y restablece el recuento de errores de conexión a cero. Por lo tanto, el quinto error de conexión generará un aviso en el registro del sistema. El Dispositivo de integración continuará intentando establecer una conexión con el servidor FTP. |
Si los parámetros de entrada incluidos en la siguiente tabla no se muestran en el panel A actividad del panel Correlacionar entradas, seleccione Mostrar parámetros opcionales. Si no se puede seleccionar la opción en el menú de barra de herramientas, pulse sobre un nodo en el panel Correlacionar entradas para activar esta opción.
en el menú de barra de herramientas o pulse con el botón derecho en el panel A actividad y seleccione la opciónTambién puede, opcionalmente, sustituir los valores que ha especificado en la tarea Configurar y Elegir punto final de la Lista de comprobación dinámicamente durante el tiempo de ejecución, utilizando los parámetros de entrada definidos en la tabla siguiente.
Por ejemplo, el directorio del servidor FTP donde el Dispositivo de integración obtiene la lista de archivos podría definirse en la tarea Configurar como el directorio llamado input. Durante el tiempo de ejecución, el nombre de directorio inputXML podría pasarse a la actividad utilizando el parámetro de entrada directory. El nombre de directorio especificado dinámicamente durante el tiempo de ejecución sustituye a la configuración original especificada en el panel Configurar. En este ejemplo, la lista de archivos se genera desde el directorio inputXML.
Nombre de parámetro de entrada/nodo | Descripción | ¿Sustituye la configuración en la tarea? |
---|---|---|
directory | Especifica el directorio del servidor FTP donde el Dispositivo de integración coloca el archivo generado en esta actividad. | El parámetro de entrada directory sustituye al campo En el directorio de la tarea Configurar. |
connection/timeout | Especifica la cantidad de tiempo en segundos para que se produzca un exceso del tiempo de espera entre el intento del Dispositivo de integración para establecer una conexión con el punto final y el tiempo que tarda el punto final en responder a la solicitud de conexión. En la actividad Suprimir archivo FTP, el intervalo de tiempo durante el cual el Dispositivo de integración intenta establecer una conexión con el servidor FTP antes de que se exceda el tiempo de espera. | El nodo tiempo de espera del parámetro de entrada connection sustituye al campo Tiempo de espera de conexión - Exceder el tiempo de espera después de ___ segundo(s) cuando se establece una conexión con el punto final del punto final FTP. |
connection/host | Especifica el nombre de host o la dirección IP del servidor FTP. | El nodo host del parámetro de entrada connection sustituye al campo Nombre de host del punto final FTP. |
connection/port | Especifica el número de puerto del nombre de host especificado. El puerto estándar para el tráfico FTP es 21. El puerto predeterminado para el tráfico SFTP es 22. | El nodo puerto del parámetro de entrada connection sustituye al campo Puerto del punto final FTP. |
connection/username | Especifica un nombre de usuario para la cuenta utilizada para conectarse con el servidor FTP. | El nodo nombre de usuario del parámetro de entrada connection sustituye al campo Nombre de usuario del punto final FTP. |
connection/password | Especifica una contraseña para la cuenta utilizada para conectarse con el servidor FTP. | El nodo contraseña del parámetro de entrada connection sustituye al campo Contraseña del punto final FTP. |
Durante el tiempo de ejecución, la actividad Enumerar archivos FTP devuelve la lista de archivos a la orquestación utilizando el parámetro de salida directoryListing o fileListing.
Si la casilla de verificación Enumerar sólo archivos (NLST) no está seleccionada en la tarea Configurar, se devuelve un listado completo de directorios, que incluye permisos de directorio, indicaciones de fecha y hora y propiedad, en el parámetro de salida directoryListing, como una única serie. Cuando se devuelve un listado completo de directorios como una serie, debe analizar el listado de directorios utilizando un esquema de archivo sin formato con la actividad Leer archivo sin formato. Puede crear un esquema de archivo sin formato utilizando el Editor de esquema de archivo sin formato. Para ver un ejemplo de orquestación que analiza un listado de directorios utilizando un esquema de archivo sin formato, consulte el ejemplo de análisis de listado de directorios: Analizar ejemplo de listado de directorio.
Si la casilla de verificación Enumerar sólo archivos (NLST) está seleccionada y la actividad Enumerar archivos FTP admite el formato del listado de directorios para su servidor FTP, se devuelve una estructura repetitiva con sólo nombres de archivos en el parámetro de salida fileListing. Cuando se devuelve una estructura repetitiva de nombres de archivos, no necesita analizar el listado de directorios y puede repetirse a lo largo de la lista utilizando una actividad Para cada o Bucle While.