Actividad Suprimir archivo FTP

Utilice la actividad Suprimir archivo FTP para suprimir archivos específicos de directorios específicos durante el tiempo de ejecución.

La actividad Suprimir archivo FTP se utiliza normalmente junto a la actividad Enumerar archivos FTP, como se muestra en el siguiente ejemplo de orquestación:
  • La actividad Planificar trabajo crea un trabajo de orquestación cada hora.
  • La actividad Enumerar archivos FTP genera una lista de archivos encontrados en el directorio \temp ubicado en el directorio raíz del servidor FTP y almacena el resultado en una serie.
  • La actividad Leer archivo sin formato analiza la lista de archivos y almacena el resultado en una estructura XML repetitiva.
  • La actividad Para cada se repite a lo largo de la estructura repetitiva que contiene la lista de archivos:
    • Si el archivo termina en la extensión .tmp, la actividad Suprimir archivo FTP suprime el archivo especificado.
Para obtener un ejemplo de proyecto que utiliza la actividad Suprimir archivo FTP, consulte Analizar ejemplo de listado de directorio.

Enlace simbólico

La actividad Suprimir archivo FTP admite enlaces simbólicos a directorios si se cumplen las siguientes condiciones:
  • Si el sistema operativo que aloja el servidor FTP admite los enlaces simbólicos a directorios.
  • Si el propio servidor FTP admite los enlaces simbólicos a directorios.
Para determinar el soporte 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 Suprimir 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 Suprimir 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 en el procedimiento "Configuración de la actividad".
      2. Seleccione un punto final existente y pulse Aceptar. Vaya 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 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 los campos del panel como se describe en la siguiente tabla:
    Tabla 1.
    Campo Descripción
    Buscar  
    Archivo llamado Este campo no se utiliza para esta actividad. Especifique el nombre del archivo que se va a suprimir utilizando el parámetro de entrada filename de la tarea Correlacionar entrada.
    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" para obtener información adicional).
      • Directorio de la vía de acceso 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.
    Durante el tiempo de ejecución, el valor especificado en el campo En el directorio de la tarea Configurar se sobrescribe si se proporciona un valor para el parámetro de entrada directory opcional utilizando una de las siguientes opciones:
    • El parámetro de entrada directory se correlaciona con una variable.
    • Se proporciona un valor predeterminado para el parámetro de entrada directory.
    Para obtener más información, consulte el procedimiento "Correlacionar la entrada de la actividad".
    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.

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 describen las opciones de reintento para conectarse a un servidor FTP:
    Tabla 2.
    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 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 Suprimir 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 se muestran 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 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. Debe correlacionar una variable con el parámetro de entrada filename. Los demás parámetros de entrada son opcionales. El parámetro filename especifica el nombre del archivo que se va a suprimir en 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 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 suprime el archivo podría definirse en la tarea Configurar como el directorio llamado process. Durante el tiempo de ejecución, el nombre de directorio processXML 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 archivo se suprimiría del directorio processXML.

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