Actividad Enumerar archivos FTP

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.

Utilice 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 si se cumple cualquiera de las siguientes condiciones:

Enlaces simbólicos

La compatibilidad de los enlaces simbólicos para la actividad Enumerar archivos FTP durante el tiempo de ejecución depende de los siguientes factores: Para determinar la compatibilidad de un enlace simbólico determinado para un servidor FTP determinado en un sistema operativo determinado, consulte la documentación de su sistema operativo y servidor FTP.

Proceso de subdirectorios con el punto final FTP de Microsoft

Para el punto final FTP de Microsoft IIS (Internet Information Services), el comportamiento en tiempo de ejecución de la actividad Enumerar archivos FTP cuando procesa subdirectorios y los archivos de los subdirectorios depende de la expresión regular especificada en el campo Archivo llamado de la tarea Configurar de la actividad, como se describe en los siguientes casos:

Adición de una actividad Enumerar archivos FTP a la orquestación

  1. Cree o abra una orquestación. Se visualiza una representación gráfica de la orquestación.
  2. Seleccione el separador Actividades y expanda la carpeta FTP.
  3. Arrastre la actividad Enumerar archivos a la orquestación.
  4. Seleccione la actividad. Se mostrará la Lista de comprobación.

Crear, seleccionar o editar un punto final FTP

  1. Pulse la tarea Elegir punto final de la Lista de comprobación y elija una de las siguientes acciones:
    • Seleccione un punto final existente:
      1. Seleccione Examinar. Se mostrará el Explorador de proyectos.
        Atención: La especificación de un punto final FTP con una estructura de directorio diferente a la del punto final FTP original puede causar que el trabajo de orquestación falle durante el tiempo de ejecución. Puede especificar un nuevo servidor FTP que coincida con la estructura de directorio del servidor FTP especificado originalmente o cambiar el directorio configurado del campo En el directorio pulsando Examinar como se describe a continuación en el procedimiento "Configuración de la actividad".
      2. Seleccione un punto final existente y pulse Aceptar. Salte al procedimiento "Configuración de la actividad".
    • Seleccione un punto final existente y edítelo:
      1. Seleccione Examinar. Se mostrará el Explorador de proyectos.
      2. Seleccione un punto final existente y pulse Aceptar.
        Atención: La especificación de un punto final FTP con una estructura de directorio diferente a la del punto final FTP original puede causar que el trabajo de orquestación falle durante el tiempo de ejecución. Puede especificar un nuevo servidor FTP que coincida con la estructura de directorio del servidor FTP especificado originalmente o cambiar el directorio configurado del campo En el directorio pulsando Examinar como se describe a continuación en el procedimiento "Configuración de la actividad".
      3. Pulse Editar. Se mostrará el panel Editar punto final.
    • Cree un punto final. Seleccione Nuevo. Se mostrará el panel Crear punto final.
  2. Cree o edite un punto final FTP: Creación o edición de un punto final FTP

Configuración de la actividad

  1. Seleccione la tarea Configurar en la Lista de comprobación. Se mostrará el panel Configurar.
  2. Configure todos los campos del panel como se describe en la siguiente tabla:
    Tabla 2.
    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:
    • Especificar directamente la vía de acceso al directorio pulsando en el campo y escribiendo una de las siguientes vías de acceso a directorio:
      • Una vía de acceso al directorio relativa, por ejemplo: /process. (Se da por supuesto que el inicio FTP ha sido configurado para la cuenta de usuario que se conecta al servidor FTP. Consulte la nota que aparece más abajo para obtener más información.)
      • Una vía de acceso al directorio completa, por ejemplo en una máquina UNIX: /home/user/process.
    • Pulsar Examinar... para llenar la lista desplegable de directorios disponibles. Seleccione el directorio apropiado de la lista desplegable.
    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:
    • * - cero o más caracteres
    • ? - cero o un carácter
    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.
    • Si la casilla de verificación Enumerar sólo archivos (NLST) está seleccionada, sólo se devuelven los nombres de archivos cuando se pulsa el botón Probar, como se muestra en el siguiente listado de ejemplo:
      bidAcmeInc.txtbidBudgetManufacture.txtbidCrankCo.txtbidSamAndSons.txtbidWidgetRUs.txt
      Además, cuando la casilla de verificación Enumerar sólo archivos (NLST) está seleccionada, el parámetro de salida fileListing se enumera en la tarea Correlacionar salidas. Durante el tiempo de ejecución, el conjunto de nombres de archivos se devuelve al nodo repetitivo fileName del parámetro de salida fileListing. Para este ejemplo, la primera instancia del elemento repetitivo fileListing/fileName es igual a bidAcmeInc.txt, la segunda instancia del elemento repetitivo fileListing/fileName es igual a bidBudgetManufacture.txt, etc.
    • 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 cuando se pulsa el botón Probar, como se muestra en el siguiente listado de ejemplo:
      -rw-r--r--   1 551
           551
                 65
      May  3 11:39 bidAcmeInc.txt-rw-r--r--   1 551
           551
                 43
      May  3 11:39 bidBudgetManufacture.txt-rw-r--r--   1 551
           551
                  0
      May  3 11:39 bidCrankCo.txt-rw-r--r--   1 551
           551
                 73
      May  3 11:39 bidSamAndSons.txt-rw-r--r--   1 551
           551
                 33
      May  3 11:39 bidWidgetRUs.txt
      Además, cuando la casilla de verificación Enumerar sólo archivos (NLST) está seleccionada, el parámetro de salida directoryListing se enumera en la tarea Correlacionar salidas. Durante el tiempo de ejecución, se proporciona el listado completo de directorios como una única serie y se devuelve utilizando el parámetro de salida directoryListing.

Especificación de opciones de reintento

  1. Seleccione la tarea Reintentar en la Lista de comprobación. Se mostrará el panel Reintentar.
  2. Configure las opciones de reintento para conectarse a un servidor FTP. En la siguiente tabla se definen las opciones de reintento de una conexión a un servidor FTP:
    Tabla 3.
    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.

Correlacionar la entrada de la actividad

  1. Seleccione la tarea Correlacionar entradas en la Lista de comprobación. Se mostrará el panel Reintentar. Los parámetros de salida de la actividad se mostrarán en el panel A actividad.
  2. Es opcional correlacionar los parámetros de entrada de la actividad Enumerar archivos FTP. La actividad Enumerar archivos FTP tiene los siguientes parámetros de entrada opcionales: 
    • directory
    • connection

    Si los parámetros de entrada incluidos en la siguiente tabla no se muestran en el panel A actividad del panel Correlacionar entradas, seleccione Correlación > Mostrar parámetros opcionales en el menú de barra de herramientas o pulse con el botón derecho en el panel A actividad y seleccione la opción Mostrar parámetros opcionales. Si no se puede seleccionar la opción Correlación > Mostrar parámetros opcionales en el menú de barra de herramientas, pulse sobre un nodo en el panel Correlacionar entradas para activar esta opción.

    Tambié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.

Tabla 4.
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.

Correlacionar la salida de la actividad

  1. Seleccione la tarea Correlacionar salidas en la Lista de comprobación. El parámetro de salida directoryListing o fileListing se visualiza en el panel Desde actividad.
  2. Correlacione el parámetro de salida directoryListing o fileListing con una variable. Consulte Creación de una correlación para obtener instrucciones generales sobre las correlaciones.

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.