Actividad Colocar archivo FTP
Durante el tiempo de ejecución, la actividad Colocar archivo FTP toma datos de las variables de la orquestación, coloca los datos en un archivo, se conecta a un servidor FTP y coloca el archivo en la ubicación de directorio especificada.
Para ver un ejemplo del uso de la actividad Colocar archivo FTP, consulte la Guía de inicio.
Interrupción de la transferencia
La transferencia de archivos realizada por la actividad Colocar archivo FTP durante el tiempo de ejecución no es transaccional y, por lo tanto, no está garantizada. Por ejemplo, si una actividad Colocar archivo FTP transfiere un archivo desde el Dispositivo de integración a un servidor FTP y la transferencia del archivo se interrumpe porque el Dispositivo de integración se vuelve a arrancar, no se garantiza la transferencia del archivo.Enlace simbólico
La actividad Colocar archivo FTP admite los enlaces simbólicos a directorios si los enlaces simbólicos a directorios son admitidos por el sistema operativo que aloja el servidor FTP y por el propio servidor FTP. 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 Colocar archivo FTP a la orquestación
- Cree o abra una orquestación. Se visualiza una representación gráfica de la orquestación.
- Seleccione el separador Actividades y expanda la carpeta FTP.
- Arrastre la actividad Colocar archivo a la orquestación.
- Seleccione la actividad. Se mostrará la Lista de comprobación.
Crear, seleccionar o editar un punto final FTP
- Pulse la tarea Elegir punto final de la Lista de comprobación y elija una de las siguientes acciones:
- Seleccione un punto final existente:
- 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 actividad.
- Seleccione un punto final existente y pulse Aceptar. Salte al procedimiento "Configurar la actividad".
- Seleccione Examinar. Se mostrará el Explorador de proyectos.
- Seleccione un punto final existente y edítelo:
- Seleccione Examinar. Se mostrará el Explorador de proyectos.
- 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".
- Pulse Editar. Se mostrará el panel Editar punto final.
- Cree un punto final. Seleccione Nuevo. Se mostrará el panel Crear punto final.
- Seleccione un punto final existente:
- Cree o edite un punto final FTP: Creación o edición de un punto final FTP
Especificar las reglas de entrega
- 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.
- 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): esta opción se utiliza para transferir archivos, por ejemplo HTML, XML, y otro tipo de archivos de texto. Los finales de línea se convierten tal como es necesario y se siguen otros convenios de 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): esta opción se utiliza para transferir archivos binarios. Si utiliza esta opción el Dispositivo de integración transfiere datos sin conversiones.
Nota: El punto final SFTP del conector Cast Iron FTP admite solo el protocolo SFTP del lado del cliente versión 3. Por lo tanto, el protocolo SFTP no admite la transferencia de archivos en modo ASCII/texto. Asegúrese de establecer el Tipo de transferencia de archivos en Transferir como binario (BINARY) en . - Transferir como texto (ASCII): esta opción se utiliza para transferir archivos, por ejemplo HTML, XML, y otro tipo de archivos de texto. Los finales de línea se convierten tal como es necesario y se siguen otros convenios de archivos de texto.
Configuración de la actividad
- Seleccione la tarea Configurar en la Lista de comprobación. Se mostrará el panel Configurar.
- Configure los campos del panel como se describe en la siguiente tabla:
Tabla 1. Campo Descripción Guardar 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. En 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" para obtener información adicional).
- 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.
Nota: Algunos caracteres de doble byte no se convierten utilizando la codificación SHIFT-JIS. Para obtener más información, consulte Utilización de la codificación Shift-JIS.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).
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. Añadir al archivo existente Especifica que si el archivo ya existe, se mantienen los datos originales en el archivo y se añaden los nuevos datos (devueltos desde la actividad) al final del archivo. 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. Nota: Cuando selecciona esta opción, la actividad Colocar archivo FTP comprueba si el archivo existe en el servidor antes de subir el archivo. Es posible que en algunos servidores FTP no tenga el permiso para comprobar si el archivo existe antes de subirlo. A esto también se le llama Blind FTP (FTP ciego). En estos casos, el archivo se sobrescribe, aunque haya seleccionado la opción Emitir error si se encuentra un archivo con nombre duplicado. - 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:
Especificación de opciones de reintento
- Seleccione la tarea Reintentar en la Lista de comprobación. Se mostrará el panel Reintentar.
- 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 Colocar 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, suponga que el recuento de reintentos se ha establecido en 3. Los errores de conexión primero, segundo y tercero 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
- 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.
- No es necesario que correlacione todos los parámetros de entrada de la actividad.
Los parámetros necesarios son los siguientes:
- filename
- data
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 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.
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. |
encoding | Especifica cómo se escriben los datos salientes en el archivo:
|
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. |
overwrite | Especifica el comportamiento cuando ya existe un archivo con el mismo nombre en el directorio de salida especificado.
Especifique uno de los siguientes valores:
|
El parámetro de entrada overwrite sustituye al campo Opciones de la tarea Configurar. |
connection/timeout | Especifica el tiempo de espera de conexión: 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 Colocar 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. |