Cuando migre un flujo de mensajes que contenga nodos XMLTransformation, compruebe cómo utiliza la WebSphere Message Broker versión
7.0 las propiedades del nodo y las prioridades de búsqueda.
Debe completar esta tarea si está migrando desde versión 6.0; no es necesario efectuar ninguna migración desde versión 6.1.
El nodo XMLTransformation en versión 6.0 se sustituirá por el nodo XSLTransform en versión
7.0. Cuando se migra un flujo que contenga uno o más nodos XMLTransformation, hay que tener en cuenta las siguientes mejoras:
- Ya no se pueden establecer las prioridades de búsqueda de hoja de estilo ni de
información del juego de caracteres en las propiedades del nodo en el WebSphere
Message Broker Toolkit. Se han adoptado las siguientes prioridades fijas de búsqueda. No obstante, se siguen
respetando las prioridades de búsqueda establecidas en flujos
ya existentes.
- El nodo busca el nombre de la hoja de estilo que se ha de utilizar preguntando,
en ese orden, a cada uno de los elementos siguientes:
- El mensaje de entrada. El nodo busca en los datos XML del mensaje información
sobre la ubicación de la hoja de estilo. Por ejemplo, si los datos
XML contienen esta entrada:
<?xml-stylesheet type="text/xsl" href="aaa.xsl"?>
el nodo utiliza "aaa.xsl" como nombre de la hoja de estilo.
- El entorno local. Si no se encuentra ningún nombre de hoja de estilo en el mensaje de entrada, el nodo busca en el entorno local asociado al mensaje actual la información de la hoja de estilo que se ha almacenado en un elemento denominado XSL.StyleSheetName.
En versión 6.0,
se utilizaba el elemento ComIbmXslXmltStylesheetname para el nombre de la hoja de estilo y, por lo tanto, el nodo actual comprueba ambos elementos. Si ambos elementos están presentes, el valor XSL.StyleSheetName tiene prioridad.
- La propiedad del nodo. Si no se encuentra ningún nombre de hoja de estilo en el mensaje de entrada o en el entorno local, el nodo utiliza las propiedades Nombre de hoja de estilo y Directorio de hojas de estilo para determinar los valores correctos.
- El nodo busca el juego de caracteres que se ha de utilizar para el
mensaje de salida preguntando, en este orden, a cada uno de los elementos siguientes:
- El entorno local. El nodo busca en el entorno local asociado al mensaje actual la información de juego de caracteres que está almacenada en un elemento denominado XSL.OutputCharSet; por ejemplo, para codificar la salida de la transformación como
UTF-16, escriba el valor 1200 como una serie de ese elemento.
En versión 6.0, se utilizaba el elemento ComIbmXslXmltOutputcharset para el juego de caracteres de salida, de forma que el nodo actual comprueba ambos elementos. Si ambos elementos están presentes, el valor de XSL.OutputCharSet tiene prioridad.
- La propiedad del nodo. Si no se encuentra ninguna información en el entorno local,
el nodo utiliza la propiedad Juego de caracteres de
salida para determinar el valor correcto.
Si el nodo no puede
determinar el juego de caracteres de salida en ninguna de estas dos fuentes porque no se
ha establecido ningún valor o porque las prioridades de selección se han establecido en
cero, se utiliza el valor predeterminado
1208 (UTF-8).
- Puede establecer propiedades de nodo adicionales o utilizar
alteraciones temporales de entorno local adicionales para especificar el dominio de
mensajes, el conjunto de
mensajes, el tipo de mensaje y el formato del mensaje de salida. Si ha incluido un nodo ResetContentDescriptor para establecer esos valores antes de pasar el mensaje al nodo XSLTransform, puede optimizar el flujo de mensajes eliminando el nodo ResetContentDescriptor.