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

Conversión de la correlación de mensajes

Una vez que se han importado los recursos de correlación, puede convertir la correlación en una correlación de datos gráfica.

Antes de empezar

Si utiliza su propia correlación de mensajes para este escenario, revise Antes: comportamiento de la correlación de mensajes inicial o el tema Cambios de comportamiento en correlaciones de datos gráficas convertidas desde correlaciones de mensajes.

Acerca de esta tarea

Los pasos para convertir la correlación de mensajes para este escenario se extraen de los pasos que se describen en Conversión de una correlación de mensajes de un archivo .msgmap en un archivo .map. Los pasos se han adaptado al escenario y, por ello, no incluyen todas las opciones posibles y métodos disponibles. Consulte el tema del Information Center para obtener información sobre los pasos de conversión genéricos.

Si importa las soluciones de mensajería de WebSphere Message Broker Versión 6.1 o WebSphere Message Broker Versión 7.0, aún puede compilar y desplegar flujos de mensajes que utilicen archivos de correlación de mensajes (.msgmap), siempre y cuando el flujo de mensajes se cree en un archivo BAR que tenga establecida la opción Compilar e incorporar recursos. Sin embargo, en WebSphere Message Broker Versión 8.0 y posteriores, los archivos de correlación de mensajes son accesibles en modalidad de sólo lectura y no se pueden modificar mediante el Kit de herramientas.

En WebSphere Message Broker Versión 8.0 y posteriores, si desea modificar las operaciones de correlación definidas en una correlación de mensajes, debe convertir primero la correlación de mensajes en un archivo de correlación de datos gráfica (.map).

Al convertir una correlación de mensajes, los flujos de mensajes que hacen referencia a la correlación de mensajes no convertidas no se pueden modificar hasta que se modifica cada flujo de mensajes para que haga referencia en su lugar a la nueva correlación de datos gráfica.

Para convertir la correlación de mensajes del escenario en una correlación de datos gráfica desplegable mediante el Kit de herramientas, realice los pasos siguientes:

Procedimiento

  1. En la vista Desarrollo de aplicaciones pulse con el botón derecho del ratón en MembersMFPFlow_Mapping.msgmap (o un .msgmap que desee convertir) y pulse Convertir correlación de mensajes de .msgmap a .map.

    Se crea la nueva correlación de datos gráfica, que se muestra en la vista Desarrollo de aplicaciones. La correlación de mensaje se renombra como MembersMFPFlow_Mapping.msgmap_backup y se muestra tras la nueva correlación de datos gráfica en la vista Desarrollo de aplicaciones.

En la vista Desarrollo de aplicaciones puede ver que el flujo de mensajes del escenario tiene un problema que se indica mediante un cuadrado rojo con una cruz:

MembersMFPFlow.msgflow con un cuadrado rojo con una cruz que indica que hay un problema en el flujo de mensajes.

Ahora debe modificar el flujo de mensajes que hacía referencia a la correlación de mensajes anterior a fin que en su lugar el flujo de mensajes haga referencia a la nueva correlación de datos gráfica. En este escenario, MembersMFPFlow.msgflow utiliza MembersMFPFlow_Mapping.map.

  1. En la vista Desarrollo de aplicaciones efectúe una doble pulsación en MembersMFPFlow.msgflow. El flujo de mensajes se abre en el editor de flujos de mensajes.
    El flujo de mensajes tal como se muestra en el editor de correlaciones de datos gráficas.
  2. En el editor de flujos de mensajes, identifique el nodo Mapping de una versión anterior de WebSphere Message Broker. Si pulsa un nodo Mapping anterior obtendrá un recuadro de mensaje de aviso, que le informará que el nodo no puede encontrar la correlación de mensajes anterior.
    Ejemplo de mensaje de información del paso.

    También puede identificar una versión anterior de un nodo Mapping pulsándolo. En la vista Propiedades, el título de nodo incluye el tipo como Mapping (en desuso).

    Ventana Propiedades del nodo Mapping que muestra el texto "Mapping (en desuso)".
    Se debe sustituir el nodo Mapping de forma que pueda aceptar la nueva correlación de datos gráfica.

Seleccione el separador Básicas de la vista Propiedades del nodo Mapping en desuso. El campo Rutina de correlación contiene el valor MembersMFPFlow_Mapping. Este valor es el nombre de la rutina para la correlación, que es necesaria para el nuevo nodo Mapping.

  1. En la Paleta, expanda la sección Transformación y a continuación arrastre un nuevo nodo Mapping de la Paleta al lienzo del editor de flujos de mensajes. Se añade un nuevo nodo Mapping al flujo de mensajes y se le asigna un nombre predeterminado. Si renombra el nodo, el nombre que elija será exclusivo en el flujo de mensajes.
    Nota: Si no cambia ahora el nombre predeterminado, podrá cambiarlo posteriormente mediante el campo de nombre del separador Descripción.
  2. Seleccione el nuevo nodo Mapping. Las propiedades del nodo se muestran en la vista Propiedades.
  3. En la vista Propiedades, la propiedad Rutina de correlación contiene un valor predeterminado, que se debe sustituir. Pulse Examinar... para localizarlo, o bien especifique el archivo .map con el formato {NombreEsquemaIntermediario}:NombreCorrelación.

    {default} indica que la correlación de datos gráfica no utiliza ningún esquema de intermediario. No hay ningún esquema en el escenario y por lo tanto se muestra {valor predeterminado}.

    En el escenario, sustituya el valor de NombreCorrelación por MembersMFPFlow_Mapping.
    Propiedades del nodo Mapping con el valor de los pasos anteriores añadido al campo Rutina de correlación.
  4. Mueva las conexiones existentes del nodo Mapping anterior al nuevo nodo Mapping. Arrastre los conectores mediante el ratón. También puede utilizar el recuadro de diálogo Selección de terminal para mover las conexiones, pero esto no se trata en este escenario; para obtener más información, consulte Crear conexiones de nodo con el recuadro de diálogo Selección de terminal.
  5. Seleccione el nodo Mapping anterior y pulse la tecla para suprimir (Supr) para eliminarlo del flujo de mensajes.
  6. Ha sustituido el nodo Mapping y ha actualizado el flujo de mensajes para que haga referencia a la nueva correlación de datos gráfica. Guarde los cambios.

Resultados

La correlación de mensajes se ha convertido en una correlación de datos gráfica que se puede modificar mediante el editor de correlaciones de datos gráficas y MembersMFPFlow.msgflow acepta la nueva correlación, como se muestra en la imagen siguiente:
MembersMFPFlow.msgflow ya no se visualiza con un cuadro rojo con una cruz.

Qué hacer a continuación

Cuando haya convertido una correlación de mensajes, abra y compruebe la correlación para ver si hay avisos o errores en las transformaciones. En este escenario debe configurar las transformaciones para resolver errores y avisos. A continuación, siga las tareas de Configuración de las transformaciones convertidas