WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Configuración de la carpeta Variables del árbol de entorno local mediante la función Convertir

La función Convertir se puede utilizar para definir variables en una correlación de mensajes definidas en la carpeta Variables del árbol de entorno local.

Antes de empezar

Personalice la correlación de mensajes para incluir el árbol de entorno local. Para obtener más información, consulte Personalización de una correlación de mensajes para incluir el árbol de entorno local.

Acerca de esta tarea

El árbol de entorno local es una parte del árbol lógico de mensaje en la que puede almacenar información mientras el flujo de mensajes procesa el mensaje. Puede utilizar el árbol de entorno local para almacenar variables a las que los nodos de proceso de mensajes que aparecen posteriormente en el flujo de mensajes pueden hacer referencia y que estos pueden actualizar. También puede utilizar el árbol de entorno local para definir destinos (internos o externos al flujo de mensajes) a los que se envía un mensaje.

Al añadir el árbol de entorno local para una correlación de mensajes, debe proporcionar transformaciones para todos los elementos de forma que no se pierdan los valores de entrada de ninguno de los elementos. Puede copiar el campo de entrada sin modificar o modificado mediante una transformación. Muchos nodos WebSphere Message Broker dependen de información del árbol de entorno local que se copia junto con el flujo de mensajes.

La carpeta de variables del árbol de entorno local se define como xsd:any. Al añadir el árbol de entorno local, puede ver la estructura de las carpetas de destino con todos sus elementos, así como una carpeta Variables con un único elemento definido con un tipo genérico.

Esta figura muestra gráficamente cómo se define la carpeta de variables con el tipo any.

Los elementos incluidos en la carpeta Variables se definen manualmente. No hay ninguna estructura predefinida para la carpeta Variables. Cada flujo de mensajes tiene su propia carpeta Variables de árbol de entorno local. Por esta razón, si desea acceder a cualquiera de estos elementos de la correlación de mensajes, debe definir cada uno de los elementos que desee utilizar en la correlación de mensajes mediante la función Convertir.

Nota:
  • La función Convertir se puede utilizar para definir explícitamente otros elementos del conjunto de mensajes de la correlación de mensajes.
  • En WebSphere Message Broker, el árbol de entorno local predefine otras carpetas para que reflejen los datos que crean y utilizan los nodos WebSphere Message Broker.

En este escenario crea un elemento denominado Country en la carpeta Variables del entorno local que utilizarán posteriormente para el direccionamiento otros nodos del flujo de mensajes.

Procedimiento

Para añadir el elemento Country a la carpeta Variables del árbol de entorno local, realice los pasos siguientes:

  1. Defina una transformación Move entre el árbol de entorno local de entrada y el árbol de entorno local de salida. Cree una conexión entre el árbol de entorno local de entrada y el árbol de entorno local de salida. Puede hacerlo de una de las formas siguientes:
    • En la correlación de mensajes, pulse el botón derecho del ratón en el árbol de entorno local de entrada y seleccione Crear conexión. Mueva el puntero del ratón al árbol de entorno local de salida y pulse el entorno local para definir la transformación Move.
    • En la correlación de mensajes, pulse el botón derecho del ratón en el árbol de entorno local de entrada y seleccione Enlace rápido. Aparece una nueva ventana donde puede seleccionar el entorno local del elemento de salida. Utilice esta opción cuando tenga una larga lista de elementos de salida. También puede filtrar la lista en Enlace rápido.

    Si debe modificar sólo algunos campos del árbol de entorno local, puede utilizar la transformación Move para copiar el árbol de entorno local sin modificar, y a continuación utilizar la función Alterar temporalmente para modificar los elementos que debe actualizar.

    La figura siguiente muestra gráficamente cómo se define la transformación Move entre el árbol de entorno local de entrada y el árbol de entorno local de salida.

    Esta figura muestra gráficamente cómo se define la transformación Move entre el árbol de entorno local de entrada y el árbol de entorno local de salida.

    Todos los valores de entrada se copian en los valores de salida.

  2. Cree un archivo de esquema en la aplicación, servicio, o biblioteca para definir los elementos de la carpeta Variables del árbol de entorno local, así como su tipo:
    • En vista Desarrollo de aplicaciones, seleccione Nuevo... > Modelo de mensaje... > Otro XML. Pulse Siguiente.
    • Seleccione Crear un archivo de esquema XML vacío, modelaré mis datos utilizando el editor de esquemas XML y a continuación pulse Siguiente.
      Esta figura muestra la ventana que se abre al seleccionar la opción Crear un archivo de esquema XML vacío, modelaré mis datos utilizando el editor de esquemas XML.
    • Cree el archivo XSD LEVariablesFolderStructure.xsd en el proyecto AddressBookProvider. A continuación, pulse Finalizar.
      Esta figura muestra gráficamente la ventana que se utiliza para seleccionar el proyecto y especificar el nombre de archivo xsd.
    • El archivo LEVariablesFolderStructure.xsd se abre en un nuevo separador donde puede utilizar el editor de esquemas XML para definir las variables y sus tipos.

      En nuestro ejemplo, definimos el esquema siguiente:

      <?xml version="1.0" encoding="UTF-8"?>
      <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
             <xsd:element name="Country"  type="xsd:string"/>
             <xsd:element name="CountryCode"  type="xsd:integer"/>
      </xsd:schema>
      Nota: En nuestro ejemplo, los nodos que leen estos elementos requieren que estos no tengan espacio de nombres. Por este motivo, el esquema también se define sin una declaración de espacio de nombres.
  3. Utilice la función Convertir para definir las variables de entorno local en la correlación de mensajes de forma que se visualicen en la carpeta Variables de la correlación. Realice los pasos siguientes para convertir el elemento any en una variable y su tipo en el árbol de entorno local de salida:
    • Pulse con el botón derecho del ratón en el elemento any y a continuación seleccione Convertir.
      Esta figura muestra gráficamente las opciones de menú que elige para convertir un elemento. Pulse con el botón derecho del ratón en el elemento any y a continuación seleccione Convertir.
    • En la ventana Selección de tipo, seleccione Country y a continuación pulse Aceptar.
      Esta figura muestra la ventana Selección de tipo con los elementos Country y CountryCode dentro de un recuadro rojo.

Resultados

Ahora ha definido una variable de entorno local que pueden utilizar otros nodos del flujo de mensajes para el direccionamiento o el filtrado.

Puede ver el elemento Country en la carpeta Variables del entorno local en la correlación de mensajes.

Esta figura muestra gráficamente el elemento Country bajo el elemento any de la carpeta Variables del entorno local.

Qué hacer a continuación

Configure la correlación de mensajes para que incluya el mensaje SOAP. Para obtener más información, consulte Configuración de la correlación de mensajes para incluir el mensaje SOAP.