Este tema contiene las secciones siguientes:
Utilice el nodo Throw para generar una excepción dentro de un flujo de mensajes. La excepción puede captarla y procesarla:
Puede incluir un nodo Throw para forzar una ruta de errores a través del flujo de mensajes si el contenido del mensaje contiene datos inesperados. Por ejemplo, para restituir un mensaje que no contenga un campo determinado, puede comprobar (utilizando un nodo Filter) si el campo existe. Si no existe, el mensaje puede pasarse a un nodo Throw que registre detalles sobre la excepción en el subárbol de lista de detalles dentro del mensaje.
El nodo Throw se representa en el entorno de trabajo con el siguiente icono:
Consulte los ejemplos siguientes para ver cómo se debe utilizar este nodo:
Incluya un nodo Throw con un nodo TryCatch en el flujo de mensajes para alertar al administrador del sistema de una situación de error potencial. Por ejemplo, si tiene un nodo Compute que calcula un número, puede probar el resultado de este cálculo y generar una excepción si el resultado sobrepasa un cierto valor. El nodo TryCatch capta esta excepción y propaga el mensaje a una secuencia de nodos que procesan el error.
Cuando se haya transferido una instancia del nodo Throw a un flujo de mensajes, podrá configurarlo. Pulse el botón derecho del ratón en el nodo en la vista de editor y seleccione Propiedades. Aparecen las propiedades básicas del nodo.
Todas las propiedades obligatorias para las que ha de entrar un valor (las que no tienen definido un valor por omisión) aparecen con un asterisco en el diálogo de propiedades.
Configure el nodo Throw de la manera siguiente:
Si ha creado su propio catálogo de mensajes, entre el número para el mensaje en el catálogo que desee utilizar cuando se genere la excepción.
Si utiliza el catálogo de mensajes por omisión, especifique un número entre 3001 y 3049. Estos números están reservados en el catálogo de WebSphere Message Broker para su uso. En el catálogo de mensajes por omisión, el texto de cada uno de estos mensajes es idéntico, pero puede utilizar un número distinto dentro de ese rango para cada situación en la que genera una excepción; utilice el número para identificar la causa exacta del error.
El número de mensaje por omisión es 3001.
El mensaje no contenía el campo necesario: Número de sucursalSi está utilizando el catálogo de mensajes por omisión, este texto se inserta como &1 en el texto del mensaje.
Pulse Cancelar para cerrar el diálogo y eliminar todos los cambios que ha efectuado en las propiedades.
El terminal del nodo Throw se describe en la siguiente tabla.
Terminal | Descripción |
---|---|
In (de entrada) | El terminal de entrada que acepta un mensaje para que lo procese el nodo. |
Las tablas siguientes describen las propiedades del nodo; la columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco en el diálogo de propiedades si tiene que entrar un valor cuando no hay definido ningún valor por omisión), la columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo bar para desplegarlo).
Las propiedades básicas del nodo Throw se describen en la siguiente tabla.
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
Catálogo de mensajes | No | No | Nombre del catálogo de mensajes desde el que se extrae el texto de error que corresponde al número de error de la excepción. El valor por omisión (espacio en blanco) indica que el mensaje se toma del catálogo de mensajes que se proporciona con WebSphere Message Broker. | |
Número de mensaje | No | No | 3001 | Número de error de la excepción que se ha generado. |
Texto del mensaje | No | No | Texto adicional que indica la causa del error. |
Las propiedades de descripción del nodo Throw se describen en la siguiente tabla.
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
Descripción corta | No | No | Descripción breve del nodo. | |
Descripción larga | No | No | Texto que describe el propósito del nodo en el flujo de mensajes. |