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

Creación de una correlación de mensajes para transformar mensajes SOAP

Cree una correlación de mensajes con un mensaje SOAP como entrada y un mensaje SOAP como salida.

Acerca de esta tarea

Este escenario muestra cómo crear una correlación de mensajes en una sola operación de un servicio.

Si desea utilizar su propia aplicación, puede seguir los mismos pasos. La diferencia es que crea la correlación en un flujo de mensajes o subflujo de la aplicación o biblioteca a la que hace referencia la aplicación.

Procedimiento

Realice los pasos siguientes para crear una correlación en el WebSphere Message Broker Toolkit:

  1. Inicie el asistente Nueva correlación de mensajes.
    1. Identifique la operación SaveAddress.
      Operación SaveAddress en la interfaz de usuario
    2. Efectúe una doble pulsación en la operación SaveAddress y arrastre y suelte un nodo Mapping.
    3. En las propiedades del nodo Mapping, seleccione el separador Descripción y especifique Normalize_AddressBook_Transform como Nombre de nodo.
    4. Conecte el nodo Mapping Normalize_AddressBook_Transform entre los dos nodos donde se requiere la transformación de mensaje.
      Esta figura muestra el flujo después de crear un nodo Mapping.
    5. Efectúe una doble pulsación en el nodo Mapping Normalize_AddressBook_Transform para iniciar el asistente Nueva correlación de mensajes.
  2. Opcional: Edite el campo Nombre de correlación y especifique el nombre de correlación.

    Puede mantener el nombre predeterminado que proporciona WebSphere Message Broker.

    En el escenario, el nombre de correlación que utiliza es el nombre predeterminado SaveAddress_Request_Response_Mapping.map.

  3. Especifique el nombre de esquema de intermediario AddressBook en el campo Esquema para crear un nuevo esquema de intermediario.

    Para organizar los recursos y definir el ámbito de los nombres de recurso a fin de garantizar su exclusividad, puede crear esquemas de intermediario. Para obtener más información sobre cómo crear un esquema de intermediario en WebSphere Message Broker Toolkit, consulte Crear un esquema de intermediario.

    Después de especificar AddressBook como el nombre del esquema de intermediario, la ventana tendrá el aspecto siguiente:

    Esta figura muestra la ventana Nueva correlación de mensajes completada con las opciones e información especificada hasta este punto del proceso. El recuadro donde se especifica el esquema esquema de intermediario AddressBook aparece resaltado.
  4. Pulse Siguiente.
  5. Seleccione las entradas y salidas de correlación.
    1. Seleccione la entrada de correlación SOAP_Domain_MSG{}.
    2. Seleccione la salida de correlación SOAP_Domain_MSG{}.

    En el escenario, tiene un nodo SOAPInput que genera un SOAP_Domain_MSG. Un nodo Mapping está conectado al nodo SOAPInput y recibe como entrada un mensaje SOAP_Domain_MSG.

    Nota: En WebSphere Message Broker, puede elegir entre varias entradas y salidas de una correlación de mensajes. Sin embargo, únicamente puede seleccionar una sola entrada y salida para una correlación de mensajes.
    • Si utiliza un nodo SOAPInput, debe correlacionar SOAP_Domain_Msg en el dominio SOAP.
    • Si utiliza un nodo SOAPInput seguido por un nodo SOAPExtract, debe correlacionar el esquema asociado con la operación en el dominio XMLNSC. El nodo SOAPExtract se utiliza para eliminar sobres SOAP, permitiendo que se procese solo el cuerpo de un mensaje SOAP.
    • Si utiliza nodos HTTP o nodos MQ, debe correlacionar el esquema SOAP 1.1 o SOAP 1.2 como el modelo raíz de la correlación en el dominio XMLNSC.

    La figura siguiente le muestra las opciones que tiene como posibles entradas y salidas de correlación en el escenario:

    Esta figura muestra las distintas opciones que tiene como entradas y salidas de correlación.

    La figura siguiente muestra el aspecto de la ventana Seleccionar entradas y salidas de correlación después de haber seleccionado la salida y entrada de correlación para una transformación de mensaje SOAP:

    Esta figura muestra el aspecto de la ventana Seleccionar entradas y salidas de correlación después de seleccionar la entrada y salida de correlación para una transformación de mensaje SOAP
  6. Pulse Siguiente.
  7. Seleccione el dominio de salida SOAP.
    Nota: La única opción de dominio disponible es el dominio SOAP.

    La figura siguiente muestra el aspecto de la ventana Nueva correlación de mensajes - Seleccionar el dominio para crear la salida después de haber seleccionado el dominio.

    Esta figura muestra la ventana Seleccionar el dominio para crear la salida después de haber seleccionado el dominio.
  8. Pulse Finalizar.

Resultados

Se crea la correlación de mensajes SaveAddress_Request_Response_Mapping.map en vista Desarrollo de aplicaciones, en la carpeta Correlaciones que se encuentra en el proyecto servicio AddressBookProvider. Se crea la correlación en el esquema AddressBook.

Esta figura muestra el nuevo recurso de correlación creado en la carpeta Correlaciones del proyecto AddressBookProvider.

Se abre la correlación en el editor de correlaciones de datos gráficas. En la figura siguiente se muestra el aspecto que presenta cuando se abre por primera vez.

Esta figura muestra el aspecto que presenta la correlación cuando se abre por primera vez. Hay una parte de propiedades definida y transformada con una transformación Move. La parte SOAP_DOMAIN_Msg{} está disponible como entrada y salida, pero no hay ninguna transformación definida entre ninguno de sus elementos.

Qué hacer a continuación

Configure la carpeta Propiedades. Para obtener más información, consulte Transformación de elementos de la carpeta Propiedades mediante la función Alterar temporalmente.