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

Transformación de elementos de la carpeta Propiedades mediante la función Alterar temporalmente

Puede utilizar la función Alterar temporalmente para copiar un tipo complejo del mensaje de entrada en el mensaje de salida, al mismo tiempo que se actualizan algunos de los elementos hijo en el tipo complejo. Un componente de conjunto de mensajes se describe mediante una estructura de datos compleja.

Antes de empezar

Cree una correlación de mensajes. Para obtener más información, consulte Creación de una correlación de mensajes para transformar mensajes SOAP.

Acerca de esta tarea

Al crear una correlación de mensajes se define automáticamente una transformación Move en la carpeta Propiedades, de forma que todos los elementos de la carpeta Propiedades se copian en la estructura de la carpeta Propiedades de salida. La figura siguiente muestra la correlación de mensajes que ha creado anteriormente:

Esta figura muestra gráficamente el resultado de añadir una transformación Move entre la carpeta Propiedades de entrada y la carpeta Propiedades de salida.
Nota: Solo puede utilizar la función Alterar temporalmente para incluir transformaciones Move y transformaciones Assign.

En el escenario, define una transformación Assign para cambiar el valor del elemento CodedCharSetId en la carpeta Propiedades de UTF-16 a UTF-8. WS-I Basic Profile 1.0 requiere soporte de la codificación Universal Transformation Format (UTF)-16. UTF-16 es un esquema de codificación de Unicode que utiliza valores de 16 bits para almacenar caracteres Universal Character Set (UCS). UTF-8 es la codificación más habitual utilizada en Internet y la codificación UTF-16 normalmente se utiliza para aplicaciones de productos Java y Windows. Para obtener más información sobre los valores que puede establecer para el elemento CodedCharSetId, consulte Páginas de códigos soportadas.

Procedimiento

Realice los pasos siguientes para modificar el elemento CodedCharSetId de la carpeta de propiedades:

  1. Pulse con el botón derecho en el elemento CodedCharSetId y a continuación seleccione la opción de menú Crear asignar.

    La figura siguiente muestra la correlación de mensajes con las opciones que puede elegir al pulsar con el botón derecho del ratón en el elemento CodedCharSetId.

    Esta figura muestra las opciones de menú que obtiene al pulsar con el botón derecho del ratón en un elemento. La opción Crear asignar está seleccionada.

    Se define la transformación Assign y se conecta al elemento CodedCharSetId de la carpeta Propiedades de salida.

    Esta figura muestra gráficamente la transformación Assign conectada al elemento CodedCharSetId de salida.
    Obtendrá los iconos siguientes en la parte superior izquierda de la transformación:
    • Un icono Error representado mediante un signo de exclamación rojo. Puede ignorar este error y continuar. Obtiene este error porque ha definido dos transformaciones en un elemento y esto no está permitido. Con la función Alterar temporalmente corregirá el problema.
      Esta figura muestra el mensaje de error: CodedCharSetId se correlaciona mediante una correlación Move en el elemento padre Propiedades así como mediante una correlación Assign directamente en el elemento CodedCharSetId.
    • Un icono de sugerencia representado mediante una bombilla amarilla.

      Al pasar el puntero sobre el icono, obtiene la siguiente ventana desplegable:

      Esta figura muestra la ventana emergente que se abre al pasar el puntero por el icono de bombilla.
  2. Establezca el valor de CodedCharSetId en 1208. Este es el valor para UTF-8.

    En el separador de propiedades de la transformación Assign puede establecer el valor en el separador General. Establezca el elemento Valor en 1208.

    Esta figura muestra el separador de propiedades de la transformación Assign. En el separador general, establezca el valor en 1208.
  3. Cuando pase el puntero sobre la bombilla amarilla, elija Agrupar las transformaciones en conflicto en un grupo de alteración temporal. Esta opción es el valor recomendado y le permite mantener la visibilidad de las transformaciones que ha definido en la correlación de transformación principal.
    Esta figura muestra la transformación Alterar temporalmente que contiene la transformación Move del componente padre y la transformación Assign del elemento CodedCharSetid.

Resultados

Ha transformado elementos de la carpeta Propiedades mediante la función Alterar temporalmente.

Si elige Anidar transformaciones en la correlación padre, se define una transformación Local mpa entre la carpeta Propiedades de entrada y la carpeta Propiedades de salida.

Esta figura muestra la transformación Local mpa que se define al elegir Anidar transformaciones en la correlación padre.

La correlación local que se crea contiene una transformación Move para cada elemento, con la excepción del elemento CodedCharSetId que tiene una transformación Assign.

Esta imagen muestra gráficamente transformaciones Move para cada elemento, con la excepción de CodedCharSetId, que tiene una transformación Assign.

Qué hacer a continuación

Configure 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.