Utilice un nodo
FileOutput para grabar un
archivo en un directorio de un servidor FTP o SFTP remoto.
Este ejemplo muestra cómo una combinación de valores en las propiedades
Definición de registro,
Delimitador y
Tipo de delimitador dan como resultado la creación de un archivo a partir de varios mensajes. El ejemplo es una extensión de un ejemplo descrito en
Grabar un archivo en el sistema de archivos local y describe el nodo
FileOutput de un flujo de mensajes.
En estas instrucciones se da por supuesto que está utilizando un sistema Windows y que ya ha creado un flujo de mensajes que contiene un nodo FileOutput. También requiere los siguientes recursos:
Lleve a cabo los siguientes pasos:
- Establezca las propiedades de nodo necesarias en el nodo FileOutput. En la siguiente tabla se muestra un resumen de las propiedades del nodo
FileOutput que debería establecer, los separadores en las que aparecen, y los valores que se utilizan en este ejemplo:
| Separador |
Propiedad |
Valor |
| Básicas |
Directorio |
C:\FileOutput\TestDir |
| Nombre de archivo o patrón |
test_output1.xml |
| Modalidad para grabar en el archivo |
Almacenar provisionalmente en el directorio de tránsito y mover al directorio de salida cuando finalice el archivo |
| Acción si el archivo
existe |
Añadir indicación de fecha y hora, archivar y sustituir archivo existente |
| Sustituir archivos archivadores duplicados |
Seleccionado |
| Registros y elementos |
Definición de registro |
El registro tiene Datos delimitados |
| Delimitador |
Fin de línea del sistema del intermediario |
| Tipo de delimitador |
Posfijo |
| FTP |
Transferencia remota |
Seleccionado |
| Protocolo de transferencia |
FTP o SFTP |
| Servidor remoto y puerto |
ftpserver.hursley.abc.com |
| Identidad de seguridad |
myidentity |
| Directorio de servidor |
/ftpfileoutput |
| Modalidad de transferencia |
ASCII (solamente para FTP) |
| Acción si el archivo remoto existe |
Sustituir archivo existente o añadir archivo existente |
| Retener archivo local después de transferencia |
Seleccionado |
Si
ha utilizado otros valores para el recurso del servidor FTP
o SFTP, utilice estos valores. Los
valores que se utilizan aquí son idénticos a los valores que utilizados en el ejemplo
del tema Grabar un archivo en el sistema de archivos local, salvo que se ha seleccionado
la propiedad Transferencia
remota y ahora hay propiedades en el separador FTP.
Si
deselecciona la propiedad Transferencia
remota, el nodo opera igual que en el ejemplo del tema Grabar un archivo en el sistema de archivos local; las propiedades del separador
FTP permanecen establecidas pero se ignoran.
Puede alterar temporalmente la propiedad
Servidor remoto y
puerto en el nodo estableciendo un valor en el entorno
local. Para obtener más información, consulte
Alteraciones temporales del entorno local para el nodo FileOutput.
- Despliegue el flujo de mensajes en el intermediario. Consulte el apartado Empaquetado y despliegue.
- Envíe los tres primeros mensajes al terminal In (de entrada) del nodo FileOutput.
- Envíe el último mensaje al terminal Finish File del nodo
FileOutput.
- Si el archivo remoto existe, la
modalidad para grabar en un archivo
remoto se utiliza para especificar si el archivo que se
ha transferido sustituye a un archivo existente o añade datos al
archivo existente. La transferencia tiene lugar en la acción Finalizar archivo. Para dar soporte al uso de Añadir es posible que tenga que actualizar la configuración del servidor FTP.
Las siguientes acciones se efectúan al realizar estos pasos:
- El archivo se procesa. El nodo FileOutput genera un registro por mensaje con un terminador de sistema de archivos local después de cada uno. El archivo contiene los siguientes datos, con cada línea terminada por un par de caracteres de retorno de carro (X'0D') y salto de línea (X'0A') (en un sistema Windows):
<Message>test1</Message>
<Message>testtwo</Message>
<Message>testthree</Message>
- Los registros se acumulan en el archivo test_output1.xml del directorio C:\FileOutput\TestDir\mqsitransit.
Cuando se envía el último mensaje al terminal Finish File, el archivo se mueve al directorio del servidor FTP o SFTP (porque la propiedad Transferencia remota está seleccionada). Como resultado, se crea el archivo /ftpfileoutput/test_output1.xml.
- Si existe un archivo con el mismo nombre en el directorio del servidor FTP o SFTP remoto, se sobrescribirá el archivo.
Si el servidor FTP remoto no se está ejecutando en un sistema Windows y la propiedad Modalidad de transferencia se establece en ASCII, la codificación de caracteres y los caracteres de terminador de línea se pueden modificar después de la transferencia. Por ejemplo, en un servidor FTP z/OS, el texto ASCII normalmente se convierte en EBCDIC y los pares de caracteres de terminador se sustituyen por nuevos caracteres de línea
(X'15') de EBCDIC.
Otros servidores FTP pueden tratar las transferencias ASCII de forma distinta. Si está utilizando SFTP, se ignorará la propiedad Modalidad de transferencia y los archivos se enviarán como archivos binarios.
- Dado que se ha seleccionado Retener archivo local después de transferencia, el archivo local no se suprimirá pero se moverá del subdirectorio mqsitransit al directorio de salida C:\FileOutput\TestDir.
Si existe un archivo con el mismo nombre en el directorio de salida, se cambia el nombre del archivo existente y se pasa al directorio mqsiarchive.
Por ejemplo, podría crearse el siguiente archivo:
C:\FileOutput\TestDir\mqsiarchive\20081124_155346_312030_test_output1.xml
Sin embargo, si existe un archivo con este nombre en el directorio de archivado, éste se sobrescribe de acuerdo con el valor de la propiedad Sustituir archivos archivadores duplicados establecida en el nodo
FileOutput.
Para más información, consulte
Establecimiento de la propiedad Definición de registro para los nodos FileOutput y FTEOutput, que muestra los resultados de ejecutar esta tarea con distintos valores establecidos en las propiedades
Definición de registro,
Delimitador y
Tipo de delimitador del nodo
FileOutput.
En los ejemplos siguientes también se muestra cómo utilizar este nodo:
Puede
ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere
Message Broker Toolkit o el Information Center
en línea. Puede
ejecutar ejemplos sólo cuando utilice el Information Center que está
integrado en WebSphere
Message Broker Toolkit.