Árbol Environment

El árbol Environment es una parte del árbol de mensajes lógico en la que puede almacenar información mientras el mensaje pasa por el flujo de mensajes.

La raíz de un árbol Environment se llama Environment. Este árbol siempre está presente en el mensaje de entrada. Se crea un árbol Environment vacío cuando se recibe el mensaje y lo analiza el nodo de entrada. Puede utilizar este árbol a su elección y crear tanto su contenido como la estructura.

Hay una situación en la que WebSphere Business Integration Message Broker hace referencia a un campo de este árbol (pero no crea nunca). Si ha solicitado la recopilación de datos para obtener las estadísticas y el contador del flujo de mensajes y ha indicado que es necesario el soporte básico de origen contable, el intermediario comprueba si existe el campo Environment.Broker.AccountingOrigin. Si el campo existe, el intermediario utiliza su valor para establecer el origen contable del registro de datos actual. Para obtener más información acerca de cómo se utiliza este campo, consulte Establecimiento del origen de los datos estadísticos y de contabilidad del flujo de mensajes. Se ha de comparar con Árbol LocalEnvironment que utiliza el intermediario en diferentes situaciones.

El árbol Environment es diferente del árbol LocalEnvironment ya que se mantiene una sola instancia en todo el flujo de mensajes. Si incluye un nodo Compute en el flujo de mensajes, no tiene que especificar si desea que se incluya el árbol Environmenten el mensaje de salida. Esto sucede automáticamente y todo el contenido del árbol Environmentde entrada se retiene en el árbol Environment de salida, sujeto a las modificaciones que realice utilizando ESQL en el nodo. Cualquier cambio que realice estará disponible en los nodos siguientes del flujo de mensajes y en los nodos anteriores si el mensaje regresa (por ejemplo, a un nodo FlowOrder o TryCatch).

Se le recomienda que cree información en el árbol Environment dentro de un subárbol denominado Variables (aunque esto no es obligatorio).

A continuación se muestra un ejemplo de un árbol Environment.


Un árbol Environment con un subárbol Variables que contiene cinco hijos. El quinto hijo también contiene hijos.

Puede utilizar las siguientes sentencias ESQL para crear el contenido mostrado anteriormente.

SET Environment.Variables = 
      ROW('granary' AS bread, 'riesling' AS wine, 'stilton' AS cheese);
SET Environment.Variables.Colors[] =
      LIST{'yellow', 'green', 'blue', 'red', 'black'};
SET Environment.Variables.Country[] = LIST{ROW('UK' AS name, 'pound' AS currency),
   	 ROW('USA' AS name, 'dollar' AS currency)};

Cuando se completa el proceso del flujo de mensajes, se descarta el árbol Environment.

Conceptos relacionados
Diseño de mensajes
Árbol LocalEnvironment
Nombres de correlación

Tareas relacionadas
Desarrollo de aplicaciones de flujos de mensajes
Acceso al árbol Environment
Establecimiento del origen de los datos estadísticos y de contabilidad del flujo de mensajes

Referencia relacionada
Nodos incorporados