El
árbol LocalEnvironment tiene su propio nombre de correlación,
LocalEnvironment, y debe utilizarlo en todas las sentencias ESQL que hacen referencia o
establecen el contenido de este árbol.
El árbol LocalEnvironment lo utiliza el intermediario y puede hacer referencia al mismo y modificar esta información. También puede ampliar el árbol para que contenga la información que ha creado. En este árbol puede crear subárboles que puede utilizar como
área de borrador o entorno de trabajo.
El flujo de mensajes establece la información en dos subárboles, Destination y WrittenDestination, debajo de la raíz
LocalEnvironment. Puede hacer referencia al contenido de ambos y puede
escribir en el árbol de destino para influir en el modo en que el flujo de mensajes
procesa el mensaje. Sin embargo, si escribe en el árbol de destino, siga la estructura definida para
asegurar que el árbol sigue siendo válido.
Si
desea que se incluya el árbol LocalEnvironment en el mensaje de salida propagado
por el nodo Compute, debe establecer
la propiedad de nodo Compute
Modalidad de cálculo en un valor que
incluya LocalEnvironment
(por ejemplo All). Si no es así, el árbol LocalEnvironment no se copia e el mensaje de salida.
La información que inserte en DestinationData o Defaults
depende de las características de la propiedad del nodo correspondiente:
- Si una propiedad de nodo se representa mediante un recuadro de selección
(por ejemplo Nuevo ID de mensaje),
establezca el elemento Defaults o DestinationData
en Yes (equivalente a la selección del
recuadro de selección) o No (equivalente
a borrar la marca de selección del recuadro).
- Si una propiedad de nodo se representa mediante una lista desplegable
(por ejemplo Modalidad de transacción),
establezca el elemento Defaults o DestinationData
en la serie de caracteres apropiada (por ejemplo
Automatic).
- Si se representa una propiedad del nodo mediante un campo de entrada de texto, por ejemplo, Nombre del gestor de colas, establezca el elemento Defaults o DestinationData en la serie de caracteres que entraría en este campo.
Si es necesario, configure el nodo de envío para indicar dónde está la información
de destino. Por ejemplo, para el nodo de salida
MQOutput,
establezca Modalidad de destino:
- Si establece la Modalidad de destino en Nombre de cola, se envía el mensaje de salida a la cola identificada en las propiedades del nodo de salida Nombre de cola y Nombre del gestor de colas.
El nodo no hace referencia al destino.
- Si establece Modalidad de destino en Lista de destinos, el nodo extrae la información de destino del subárbol Destination. Si utiliza este valor, puede enviar un solo mensaje a varios destinos, si configura
correctamente Destination y un solo nodo de salida. El nodo sólo comprueba las propiedades del nodo si no hay
disponible un valor en Destination (como se ha descrito anteriormente).
- Si establece Modalidad de destino en Cola de respuestas, el mensaje se envía a la cola de respuestas identificada en el MQMD de este mensaje (campo
ColaRespuestas)
El nodo no hace referencia al destino.
Para ver más
información sobre los procedimientos ESQL que realizan actualizaciones habituales en
LocalEnvironment, consulte Llenar el destino en el árbol LocalEnvironment. Revise las sentencias de ESQL de estos procedimientos para ver cómo se debe modificar
LocalEnvironment.
Puede utilizar estos procedimientos sin cambiarlos, o
modificarlos según sus necesidades.
Para ver más información sobre cómo ampliar el contenido de
este árbol para sus fines, consulte Utilizar áreas de borrador en LocalEnvironment.
Para
ver otro ejemplo sobre la utilización de LocalEnvironment para modificar el comportamiento
de un flujo de mensajes, consulte el flujo de mensajes de XML_PassengerQuery en el
siguiente programa
nsajssample:
El
nodo
Compute de este flujo de mensajes graba
una lista de destinos en el subárbol RouterList de Destination
que utiliza como etiquetas el nodo
RouteToLabel posterior que propaga el mensaje
al nodo
Label correspondiente.
Los ejemplos sólo pueden verse cuando se utiliza el
centro de información que está integrado en el Kit de herramientas de Message
Brokers.