Nodo Throw

Este tema contiene las siguientes secciones:

Finalidad

Utilice el nodo Throw para generar una excepción dentro de un flujo de mensajes. La excepción puede se detectar y procesar por:

  • Un nodo TryCatch precedente
  • El nodo de entrada de flujo de mensajes (los nodos incorporados HTTPInput, MQInput, MQeInput y SCADAInput tienen todos terminales de captación (terminal catch))
  • Un nodo AggregateReply precedente

Puede incluir un nodo Throw para forzar una vía 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 contiene un campo concreto, puede comprobar que el campo existe (mediante el nodo Filter). Si no existe, el mensaje puede pasarse a un nodo Throw que anota los detalles sobre la excepción en el subárbol de la lista de excepciones dentro del mensaje.

El nodo Throw se representa en el área de trabajo por el icono siguiente:

Icono de nodo Throw

Utilización de este nodo en un flujo de mensajes

Consulte los ejemplos siguientes para ver cómo utilizar este nodo:

Incluya un nodo Throw con un nodo TryCatch en el flujo de mensajes para avisar al administrador de sistemas de una situación de error potencial. Por ejemplo, si dispone de un nodo Compute que calcula un número, puede probar el resultado de resultado de este cálculo y emitir una excepción si el resultado excede una determinada cantidad. El nodo TryCatch detecta esta excepción y propaga el mensaje a una secuencia de nodos que procesan el error.

Configuración del nodo Throw

Después de transferir una instancia del nodo Throw a un flujo de mensajes, puede configurarla. Pulse el botón derecho del ratón en el nodo en la vista de editor y seleccione Propiedades. Se visualizan las propiedades básicas de nodo.

Todas las propiedades obligatorias para las que se debe entrar un valor (las que no tienen definido un valor por omisión) se marcan con un asterisco en el diálogo de propiedades.

Configure el nodo Throw como se describe a continuación:

  1. En Catálogo de mensajes, especifique el nombre de archivo y la vía de acceso completos del catálogo de mensajes que contiene el origen del mensaje. Puede ser su propio catálogo de mensajes o el catálogo de mensajes por omisión que se suministra con WebSphere Business Integration Message Broker. Para utilizar el catálogo que se proporciona por omisión, deje en blanco esta propiedad.
  2. En Número de mensaje, especifique el número de error de la excepción que se emite.

    Si ha creado su propio catálogo de mensajes, especifique el número del mensaje en el catálogo que desea utilizar cuando se lanza esta 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 Business Integration Message Broker para usted. El texto de cada uno de estos mensajes del catálogo de mensajes por omisión es idéntico, aunque puede utilizar un número distinto de este rango para cada situación en la que se emite una excepción; utilice el número para identificar la causa exacta del error.

    El número de mensaje por omisión es 3001.

  3. En Texto del mensaje, especifique cualquier texto sin formato adicional que contenga la información que desea incluir con el mensaje cuando se graba en las anotaciones de error locales. Por ejemplo, si ha comprobado la existencia de un campo determinado en un mensaje y se ha emitido una excepción cuando no se ha encontrado dicho campo, podría incluir el texto:
    El mensaje no contenía el campo necesario: número de sucursal
    Si utiliza el catálogo de mensajes por omisión, este texto se inserta como &1 en el texto del mensaje.
  4. Seleccione Descripción en el navegador del diálogo de propiedades para entrar una descripción breve, una descripción larga o ambas.
  5. Pulse Aplicar para realizar los cambios en el nodo Throw sin cerrar el diálogo de propiedades. Pulse Aceptar para aplicar los cambios y cerrar el diálogo de propiedades.

    Pulse Cancelar para cerrar el diálogo y descartar todos los cambios realizados en las propiedades.

Terminales y propiedades

El terminal de nodo Throw se describe en la siguiente tabla.

Terminal Descripción
Terminal de entrada Terminal de entrada que acepta un mensaje para que el nodo lo procese.

En las siguientes tablas se 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 se debe entrar un valor cuando no se ha definido ningún valor por omisión), la columna con la cabecera C indica si la propiedad es configurable (se puede cambiar el valor cuando se añade el flujo de mensajes al archivo bar para difundirlo).

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 del que se extrae el texto del error para el número de error de la excepción. El valor por omisión (blanco) indica que el mensaje se extrae del catálogo de mensajes proporcionado con WebSphere Business Integration Message Broker.
Número de mensaje No No 3001 Número de error de la excepción que se emite.
Texto del mensaje No No   Texto adicional que explica 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   Breve descripción del nodo.
Descripción larga No No   Texto que describe la utilidad del nodo en el flujo de mensajes.

Conceptos relacionados
Flujos de mensajes
Árbol ExceptionList

Tareas relacionadas
Cómo decidir los nodos que utilizar
Manejo de errores en flujos de mensajes

Referencia relacionada
Nodo Filter
Nodo HTTPInput
Nodo MQeInput
Nodo MQInput
Nodo SCADAInput
Nodo Trace
Nodo TryCatch