Actividad Renombrar archivo FTP

Utilice la actividad Renombrar archivo FTP para renombrar y/o mover un archivo a un directorio diferente durante el tiempo de ejecución.

El directorio que renombra la actividad Renombrar archivo FTP se muestra en los siguientes casos admitidos: Para ver un ejemplo de proyecto que utiliza la actividad Renombrar archivo FTP, consulte el ejemplo de análisis del listado de directorios: Analizar ejemplo de listado de directorio.

Enlace simbólico

La actividad Renombrar archivo FTP admite enlaces simbólicos a directorios si se cumplen las siguientes condiciones: 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 Renombrar 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 Renombrar 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. 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. 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 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 los campos del panel como se describe en la siguiente tabla:
    Tabla 1.
    Campo Descripción
    Renombrar  
    Archivo llamado Este campo no se utiliza para esta actividad. Especifique el nombre del archivo que se va a renombrar utilizando el parámetro de entrada fromFilename de la tarea Correlacionar entrada.
    Desde 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.
    Nueva vía de acceso Este campo no se utiliza para esta actividad. Especifique la vía de acceso completa, incluyendo el nuevo nombre de archivo y el nuevo directorio, en el servidor FTP, donde el Dispositivo de integración coloca el archivo que se ha movido utilizando el parámetro de entrada toPath de la tarea Correlacionar entrada.
    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.
    Opciones - Seleccione una de las siguientes opciones para definir el comportamiento cuando ya existe un archivo con el mismo nombre en el directorio de salida especificado:
    Sobrescribir el archivo existente si se encuentra un nombre de archivo duplicado Especifica que si el archivo ya existe, se destruyen los contenidos del archivo original con los nuevos datos devueltos desde la actividad.
    Emitir error si se encuentra un archivo con nombre duplicado Especifica que si el archivo ya existe, se mantienen los datos originales en el archivo, se emite un error y no se hace nada con los nuevos datos devueltos desde la actividad.

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 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 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 Renombrar 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 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 los siguientes parámetros de entrada:
    • fromFilename - Durante una acción de cambio de nombre, este parámetro especifica el nombre original del archivo que se va a renombrar.
    • toPath - Durante una acción de cambio de nombre, este parámetro especifica la vía de acceso, incluyendo el nombre del nuevo directorio y el nuevo nombre del archivo. Por ejemplo, para especificar que el archivo se mueva al directorio /output de la raíz del servidor FTP utilizando el nombre de archivo fileNewName.txt, especifique el siguiente valor para toPath: /output/fileNewName.txt

      Los demás parámetros de entrada son opcionales. Consulte Creación de una correlación para obtener instrucciones generales sobre la correlación.  

      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 coloca el archivo podría definirse en la tarea Configurar como el directorio llamado output. Durante el tiempo de ejecución, el nombre de directorio outputXML 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 colocaría en el directorio outputXML.

      Tabla 3.
      Nombre de parámetro de entrada/nodo Descripción ¿Sustituye la configuración en la tarea?
      fromDirectory Especifica el directorio del servidor FTP donde el Dispositivo de integración obtiene la lista de archivos. El parámetro de entrada directory sustituye al campo En el directorio de la tarea Configurar.
      overwrite 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. Para la actividad Enumerar archivos 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/timeout Especifica el nombre de host o la dirección IP del servidor FTP. 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 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 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 la correlación.

    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.