Actividad Obtener archivo FTP

Durante el tiempo de ejecución, la actividad Obtener archivo FTP se conecta a un servidor FTP e intenta obtener un solo archivo en la ubicación especificada. Puede configurar la actividad Obtener archivo FTP para que devuelva los contenidos del archivo a una variable de la orquestación. Además, puede configurar la actividad Obtener archivo FTP para que devuelva la indicación de fecha y hora del archivo devuelto por el servidor FTP a una variable de la orquestación.

La actividad Obtener archivo FTP difiere de la actividad Sondear directorio FTP en los siguientes aspectos:

Enlace simbólico

La compatibilidad de los enlaces simbólicos para la actividad Obtener archivo 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.

Adición de una actividad Obtener archivo 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 Obtener archivo 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. Debe 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 "Configurar 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. Debe 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

Especificar las reglas de entrega

  1. Seleccione la tarea Reglas de entrega en la Lista de comprobación. Se mostrará el panel Reglas de entrega. Si la seguridad no está habilitada para el punto final FTP, se habilitan las opciones Transferir como texto (ASCII) y Transferir como binario (BINARY). Si la seguridad está habilitada para el punto final FTP, el tipo de transferencia del archivo es siempre binaria.
  2. Seleccione el tipo de transferencia de archivo entre el Dispositivo de integración y el servidor FTP a partir de una de las siguientes opciones:
    • Transferir como texto (ASCII) - Sólo se transfieren siete bits de cada carácter del archivo del Dispositivo de integración al servidor FTP. Esta opción se utiliza para transferir archivos ASCII, como HTML y archivos de texto.
      PRECAUCIÓN:
      El uso de esta opción con archivos binarios puede provocar una pérdida de datos.
    • Transferir como binario (BINARY) - Se transfieren los ocho bits de cada byte del archivo del Dispositivo de integración al servidor FTP. Esta opción se utiliza para transferir archivos binarios.
    Nota: El establecimiento del modo de transferencia en la tarea Reglas de entrega es equivalente al establecimiento del modo de transferencia a través de una sesión de línea de mandatos con un servidor FTP utilizando los siguientes mandatos:
    • ascii
    • binary

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
    Archivo llamado Este campo no se utiliza para esta actividad. Especifique el nombre del archivo de salida utilizando el parámetro de entrada filename de la tarea Correlacionar entrada.
    Desde el directorio Especifica el directorio del servidor FTP donde el Dispositivo de integración coloca el archivo generado en esta actividad. 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: /output. (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/output.
    • 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.
    Del tipo Especifica cómo se leen los contenidos del archivo: como datos binarios o como texto codificado. Si se selecciona la opción Texto, establezca el tipo de codificación utilizando una de las siguientes opciones:
    • En la lista desplegable Codificado con, seleccione uno de los tipos de codificación predeterminados.  
    • Especifique el tipo de codificación directamente pulsando en el campo Codificado con y escribiendo su tipo de codificación.
    Atención: Debe especificar la opción Transferir como texto (ASCII) para actividades FTP al recuperar archivos de texto y colocar archivos de texto en un servidor FTP para puntos finales que manipulan datos de texto mientras transfieren datos desde/hasta el punto final FTP en modo ASCII. Por ejemplo, los puntos finales FTP del sistema principal y de DOS manipulan los datos ASCII al pasar los datos en modo ASCII.
    Por ejemplo, si su orquestación recupera archivos ASCII utilizando la actividad Sondear directorio FTP y coloca los archivos ASCII utilizando la actividad Colocar archivo FTP en un servidor FTP del sistema principal, debe especificar las opciones en las siguientes tareas de Studio:
    • En la tarea Configurar de una actividad Sondear directorio FTP, para el campo Del tipo seleccione la opción Texto.
    • En la tarea Reglas de entrega de una actividad Sondear directorio FTP, para el campo Tipo de transferencia de archivo seleccione la opción Transferir como texto (ASCII).
    • En la tarea Configurar de una actividad Colocar archivo FTP, para el campo Del tipo seleccione la opción Texto.
    • En la tarea Reglas de entrega de una actividad Colocar archivo FTP, para el campo Tipo de transferencia de archivo seleccione la opción Transferir como texto (ASCII).

Especificación de las 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 y detener el proceso del trabajo de orquestación actual.

    Si se despliega una orquestación que incluye una actividad Obtener archivo 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 los registros del sistema y la orquestación hasta que se alcanza el total de reintentos. Cuando se alcanza el recuento de reintentos, el Dispositivo de integración registra un error en el sistema y en los registros de orquestación y detiene el proceso del trabajo de orquestación actual.

    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 detiene el proceso del trabajo de orquestación actual.

Correlacionar la entrada en la actividad

  1. Seleccione la tarea Correlacionar entradas en la Lista de comprobación. Los parámetros de salida de la actividad se mostrarán en el panel A actividad.
  2. El parámetro filename es el único parámetro que necesita para proporcionar un valor en la actividad. Los demás parámetros son opcionales. El parámetro filename especifica el nombre del archivo que se va a obtener del servidor FTP. Proporcione un valor para el parámetro filename creando un vínculo desde el parámetro de entrada filename con una variable o definiendo un valor predeterminado para el parámetro de entrada filename.

    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 el archivo 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, el Dispositivo de integración intenta obtener el archivo 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 Desde el directorio de la tarea Configurar.
encoding Especifica cómo se escriben los datos salientes en el archivo:
  • Si no se necesita aplicar ninguna codificación, especifique la serie: binary .
  • Si se necesita la descodificación, especifique el tipo de codificación que debería utilizarse para codificar los datos salientes, por ejemplo: UTF-8, US-ASCII, ISO_8859-1, EBCDIC-US o SHIFT-JIS.
El parámetro de entrada encoding sustituye a la codificación especificada en el campo Del tipo de la tarea Configurar, pero si está seleccionada la opción Binary en el campo Del tipo de la tarea Configurar, se ignora la codificación especificada por el parámetro de entrada encoding.
connection/timeout Especifica el tiempo de espera de conexión: el número de 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. Para una actividad Obtener 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. Los parámetros de salida de la actividad se mostrarán en el panel Desde actividad como se describe en la siguiente tabla:
    Tabla 5.
    Nombre del parámetro de salida Descripción
    data Contiene los contenidos del archivo.
    timestamp Contiene la indicación de fecha y hora para el archivo devuelto desde el servidor FTP, normalmente la fecha de creación o de última modificación del archivo.  
  2. Correlacione los parámetros de salida deseados con las variables.