Utilice el nodo FTEInput para recibir archivos mediante WebSphere MQ File Transfer Edition.
Este tema contiene las secciones siguientes:
Puede utilizar el nodo FTEInput para ampliar el soporte de WebSphere Message Broker Versión 8.0 para el proceso de archivos mediante su integración con WebSphere MQ File Transfer Edition. WebSphere MQ File Transfer Edition es un producto de transferencia de archivos gestionado que utiliza WebSphere MQ como transporte.
El nodo FTEInput se encuentra en la bandeja Archivo de la paleta y está representado en el WebSphere Message Broker Toolkit por el siguiente icono:
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.
Los terminales del nodo FTEInput están descritos en la siguiente tabla.
Terminal | Descripción |
---|---|
Failure | El terminal de salida al que se direcciona un mensaje si se produce un error antes de que el mensaje se propague al terminal Out (de salida). Los mensajes propagados a este terminal no se validan, incluso si ha especificado, utilizando la propiedad Validar, que la validación debe llevarse a cabo. |
Out | El terminal de salida al que se direcciona un mensaje si éste se extrae satisfactoriamente del archivo de entrada. Si no se producen errores en el nodo de entrada, un mensaje recibido de un recurso externo siempre se envía primero al terminal de salida. |
End of Data | El terminal de salida al que se direcciona el mensaje de fin de datos una vez que se han procesado todos los mensajes de un archivo. La transacción de flujo de mensajes de fin de datos se inicia sólo si este terminal está conectado. |
Catch (de captación) | El terminal de salida al que se direcciona un mensaje si se genera una excepción en sentido descendente y después este nodo la capta. Las excepciones se detectan sólo si este terminal está conectado. |
Las tablas siguientes describen las propiedades de nodo que el usuario puede establecer en un separador especificado. La columna con la cabecera M indica si la propiedad es obligatoria (marcada en el kit de herramientas con un asterisco si es necesario especificar un valor cuando no existe ningún valor predeterminado definido). La columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añada el flujo de mensajes al archivo BAR para desplegarlo).
Cuando el nodo FTEInput propaga un mensaje, almacena información sobre el mismo en los árboles de mensajes LocalEnvironment.FTE y LocalEnvironment.FTE.Transfer. Si el archivo de entrada está vacío, se propaga un mensaje vacío (suponiendo que sea válido). Si especifica un patrón de nombre de archivo que contiene caracteres comodines en la propiedad Filtro de nombre de archivo, el nodo FTEInput copia los caracteres en el nombre de archivo que coincide con los comodines, junto con cualquier carácter intermedio, al árbol de mensajes LocalEnvironment.Wildcard.WildcardMatch. Si desea más información, consulte Utilización de las variables de entorno local con los nodos de archivo.
Propiedades de Descripción
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | Entrada FTE | El nombre del nodo. |
Descripción corta | No | No | Ninguno | Descripción breve del nodo. |
Descripción larga | No | No | Ninguno | Texto que describe el propósito del nodo en el flujo de mensajes. |
Propiedades Básicas
Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Filtro de directorios | No | Sí | Ninguno | El directorio de destino de WebSphere MQ File Transfer Edition desde el que se procesan los archivos de entrada. | inputDirectory |
Filtro de nombres de archivo | Sí | Sí | * | Un nombre de archivo o una serie que contiene caracteres comodín especiales (* o ?) que identifica el archivo o archivos que deben procesarse del directorio de entrada. | filenamePattern |
Acción si el proceso es satisfactorio | Sí | No | No se requiere ninguna acción | La acción que el nodo lleva a cabo en el archivo después de procesar satisfactoriamente el contenido. Las opciones válidas son:
|
Propiedades de Análisis de mensaje de entrada:
Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Dominio de mensajes | No | No | Ninguno | Dominio que se utiliza para analizar el mensaje de entrada. | |
Conjunto de mensajes | No | No | Ninguno | Nombre o identificador del conjunto de mensajes en el que se
define el mensaje de entrada. Si establece esta propiedad y, a continuación, actualiza las dependencias del proyecto para eliminar esta referencia de conjunto de mensajes, se emite un aviso. Actualice la propiedad Conjunto de mensajes o restaure la referencia a este proyecto de conjunto de mensajes. |
|
Tipo de mensaje | No | No | Ninguno | Nombre del mensaje de entrada. | |
Formato del mensaje | No | No | Ninguno | Nombre del formato físico del mensaje de entrada. | |
ID de juego de caracteres codificado del mensaje | Sí | Sí | Valor predeterminado del sistema de intermediario | El ID del juego de caracteres codificado utilizado para interpretar los bytes del archivo que se lee. | messageCodedCharSetIdProperty |
Codificación del mensaje | Sí | Sí | Determinado por el sistema de intermediario | El esquema de codificación para números utilizado para interpretar los bytes del archivo que se lee. Los valores válidos son Determinado por el sistema de intermediario o un valor de codificación numérica. Para obtener más información sobre la codificación, consulte Conversión de datos. | messageEncodingProperty |
Propiedades de Opciones de análisis
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Temporización del análisis | No | No | A petición | Especifica cuando se analiza un mensaje de entrada. Los valores válidos son:
Si desea ver una descripción completa de esta propiedad, consulte Análisis a petición. |
Crear árbol utilizando los tipos de datos de esquema XML | No | No | Deseleccionado | Especifica si los elementos de sintaxis del árbol de mensajes tienen tipos de datos obtenidos del esquema XML. |
Utilizar analizador compacto XMLNSC para dominio XMLNS | No | No | Deseleccionado | Especifica si el analizador compacto
XMLNSC se utiliza para mensajes en el dominio XMLNS. Si establece esta
propiedad, los datos del mensaje aparecen bajo XMLNSC en los nodos que están
conectados al terminal de salida cuando uno de los siguientes elementos es
XMLNS:
|
Retener el contenido mixto | No | No | Deseleccionado | Especifica si el analizador XMLNSC crea elementos en el árbol de mensajes para texto combinado en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para el texto mixto. Si deselecciona el recuadro, el texto mixto se ignora y no se crea ningún elemento. |
Retener los comentarios | No | No | Deseleccionado | Especifica si el analizador XMLNSC crea elementos en el árbol de mensajes para comentarios en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para los comentarios. Si deselecciona el recuadro, los comentarios se ignoran y no se crea ningún elemento. |
Retener las instrucciones de proceso | No | No | Deseleccionado | Especifica si el analizador XMLNSC crea elementos en el árbol de mensajes para instrucciones de proceso en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para las instrucciones de proceso. Si deselecciona el recuadro, las instrucciones de proceso se ignoran y no se crea ningún elemento. |
Elementos opacos | No | No | Espacio en blanco | Especifica una lista de elementos en el mensaje de entrada que el analizador XMLNSC debe analizar de forma opaca. El análisis opaco sólo se realiza si la validación no está habilitada (es decir, si Validar tiene el valor Ninguno); las entradas que se especifiquen en Elementos opacos se omiten si la validación está habilitada. |
Propiedades Retry
Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Mecanismo de reintento | Sí | No | Anomalía | Cómo maneja el nodo una anomalía del flujo. Las opciones válidas son:
|
|
Umbral de reintentos | Sí | Sí | 0 | El número de veces que debe reintentarse la transacción de flujos cuando el valor de la propiedad Mecanismo de reintento es Reintento corto. | retryThreshold |
Intervalo de reintento corto (segundos) | No | Sí | 0 | El intervalo, en segundos, entre cada reintento si la propiedad Umbral de reintentos no es cero. | shortRetryInterval |
Intervalo de reintento largo (segundos) | No | Sí | 300 | El intervalo entre reintentos si la propiedad Mecanismo de reintento es Reintento corto y largo y se ha agotado el umbral de reintentos. | longRetryInterval |
Acción si el archivo falla | Sí | Sí | No se requiere ninguna acción | Acción que el nodo lleva a cabo con el archivo de entrada
si todos los intentos para procesar el contenido de este archivo fallan.
Las opciones válidas son:
|
Propiedades de Registros y elementos
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Detección de registros | Sí | No | Todo el archivo | El mecanismo utilizado para identificar registros en el archivo de entrada. Las opciones válidas son:
|
Longitud | Sí | No | 80 | La longitud de cada registro cuando se selecciona la detección de registros Longitud fija. |
Delimitador | Sí | No | Fin de línea de DOS o UNIX | El tipo de bytes de delimitador que separan o terminan cada registro cuando se ha seleccionado la detección de registros Delimitados. Las opciones válidas son:
|
Delimitador personalizado | No | No | Ninguno | Los bytes de delimitador, expresados en hexadecimal, cuando se selecciona la detección de registros Delimitados y el Delimitador personalizado. Esta propiedad sólo es obligatoria si la propiedad Delimitador no se ha establecido en Delimitador personalizado. |
Tipo de delimitador | Sí | No | Posfijo | La posición del delimitador cuando se selecciona la detección de registros Delimitados. Las opciones válidas son:
|
Propiedades de Validación
Para ver la descripción completa de estas propiedades, consulte Propiedades de validación.
Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Validar | No | Sí | Ninguno | Esta propiedad controla si tiene lugar la
validación. Los valores válidos son:
|
validateMaster |
Acción para anomalía | No | No | Excepción | Esta propiedad controla qué sucede si falla la
validación. Los valores válidos son:
|
Propiedades de Transacciones
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Modalidad de transacción | No | No | No | La modalidad de transacción de este nodo de entrada determina si el resto de los nodos del flujo
se ejecutan bajo el punto de sincronismo. Las opciones válidas son:
|
Propiedades de Instancias.
Para ver la descripción completa de estas propiedades, consulte Propiedades configurables del flujo de mensajes.
Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Agrupación de instancias adicionales | No | Sí | Utilizar agrupación asociada al flujo de mensajes | La agrupación de la que se obtienen instancias adicionales.
|
componentLevel |
Instancias adicionales | No | Sí | 0 | El número de instancias adicionales que el nodo puede iniciar si la propiedad Agrupación de instancias adicionales está establecida en Utilizar agrupación asociada al nodo. | additionalInstances |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Sucesos | No | No | Ninguno | Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y
Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles. Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado. |