Al convertir una correlación de mensajes de una versión anterior de
WebSphere Message Broker en una
correlación
de datos gráfica, es posible que tenga realizar
tareas adicionales antes de poder utilizar la
correlación
de datos gráfica en una solución de mensajería.
Al prepararse para convertir una correlación de mensajes en una
correlación
de datos gráfica, se deben tener en cuenta los
siguientes puntos:
- La correlación
de datos gráfica se ejecuta en la máquina
virtual Java™ del intermediario. Asegúrese de que el
intermediario esté configurado correctamente; consulte Establecimiento del tamaño de almacenamiento dinámico de JVM.
- Las transformaciones de base de datos en una correlación
de datos gráfica
utilizan soporte para conexiones JDBC que están incorporadas en WebSphere Message Broker.
La conversión de operaciones de base de datos relacional de correlación de mensajes en
transformaciones de correlación de datos requiere acciones adicionales en el
Editor de correlaciones de datos gráficas. Para obtener más
información, consulte Correlacionar contenido de base de datos.
- Las correlaciones de datos gráficas se pueden desplegar sólo como código fuente. Para
desplegar una correlación
de datos gráfica:
- Proporcione un esquema de modelo de mensaje para los mensaje de entrada y salida.
Para los mensajes XML, se debe proporcionar una archivo de esquema XML. Para los mensajes
de texto y binarios, el modelo se puede proporcionar utilizando un archivo de esquema
DFDL o un conjunto de mensajes.
- Si el mensaje se modela en un conjunto de mensajes, la
correlación
de datos gráfica requiere que se despliegue el
esquema de conjunto de mensajes (archivo .xsdzip) para ejecutar la
correlación
de datos gráfica. Si el conjunto de mensajes
existente se utiliza sólo para formatos de texto y binario, puede desplegar la
correlación
de datos gráfica con sólo un archivo
.dictionary en el archivador de intermediario (BAR). En este caso,
debe modificar el conjunto de mensajes para establecer adicionalmente la opción
de soporte de dominio XMLNSC, para que se añada a un archivo BAR con un
archivo .dictionary y un archivo .xsdzip.
Si no se establece está opción, se muestra un aviso en la vista Problemas,
junto con una acción de arreglo rápido.
- Cuando una correlación de mensajes convertida incluye llamadas a procedimientos ESQL
proporcionados por el usuario, estos se convierten en transformaciones ESQL
personalizadas. Para que las correlaciones de datos gráficas llamen a procedimientos
ESQL, se deben cumplir ciertos requisitos.
Para obtener más información, consulte
ESQL personalizado. Se deben tener en cuenta los siguientes aspectos:
- Los módulos ESQL se despliegan como código fuente. Consulte Añadir archivos a un archivador de intermediario.
- Si no utiliza recursos de aplicación y biblioteca de
WebSphere Message Broker, los procedimientos ESQL deben tener nombres
exclusivos, ya que se despliegan en el grupo de ejecución.
- Las llamadas a procedimientos ESQL que utilizan el tipo de datos REFERENCE de ESQL
se sustituyen por transformaciones de Tarea en la
correlación
de datos gráfica convertida. Debe sustituir
cada una de estas transformaciones de Tarea por una transformación XPath personalizado,
Java personalizado o ESQL personalizado que
proporcione una función equivalente.
- Cuando una correlación de mensajes convertida incluye llamadas a funciones de correlación
de mensajes (msgmap:) predefinidas, cada una de estas transformaciones se convierte en
una transformación XPath o XPath personalizado. Estas transformaciones de sustitución
se deben revisar para asegurar que vuelven a crear el comportamiento necesario. Si no hay
ningún equivalente XPath de una función de correlación de mensajes, ésta se sustituye por
una transformación de Tarea en la correlación
de datos gráfica. Debe
sustituir cada una de estas transformaciones de Tarea por una transformación XPath
personalizado, Java personalizado o ESQL
personalizado que vuelva a crear el comportamiento necesario. Las siguientes funciones de
correlación de mensajes no tienen ningún equivalente XPath:
- msgmap:element-from-bitstream
- msgmap:cdata-element
- msgmap:db-path
- Puede utilizar una transformación Conversión de tipo de datos y funciones de Esquema
XML en transformaciones XPath personalizado para realizar conversiones de tipo de valor. Para
obtener más información, consulte Conversión de tipo de datos y Tipos ESQL y tipos de esquema.
- Cuando convierta una correlación de mensajes para una transformación que incluya
manejo para elementos que faltan, están vacíos o tienen nulos, consulte
Manejo de valores nulos. Se
proporcionan las siguientes funciones XPath para que pueda implementar estas
transformaciones:
- fn:empty comprueba si un elemento tiene un valor vacío.
- fn:nilled comprueba si un elemento XML tiene establecido el atributo xsi:nil.
- fn:exists comprueba si un elemento está presente. Un elemento XML que tiene
establecido el atributo xsi:nil se considera como presente.
- Cuando una correlación de mensajes convertida incluye llamadas a funciones de
correlación ESQL (esql:) predefinidas, cada una de estas llamadas se convierte en una
transformación XPath o XPath personalizado. Estas transformaciones de sustitución se
deben revisar para asegurar que vuelven a crear el comportamiento necesario. Si no hay
ningún equivalente XPath de una función de correlación ESQL, ésta se sustituye por una
transformación de Tarea en la correlación
de datos gráfica.
Debe sustituir cada una de estas transformaciones de Tarea por una transformación XPath
personalizado, Java personalizado o ESQL
personalizado que vuelva a crear el comportamiento necesario. Las siguientes funciones de
correlación ESQL no tienen ningún equivalente XPath:
- Ciertas funciones matemáticas:
- ACOS
- ASIN
- ATAN
- ATAN2
- BITAND
- BITNOT
- BITOR
- BITXOR
- COS
- COSH
- COT
- DEGREES
- EXP
- LN
- LOG
- LOG10
- MOD
- POWER
- RADIANS
- RAND
- SIGN
- SIN
- SINH
- SQRT
- TAN
- TANH
- Función decimal:
- Ciertas funciones de Serie:
- LTRIM
- RTRIM
- TRIM-LEADING
- TRIM-TRAILING
- REPLICATE
- SPACE
- Ciertas funciones de campo:
- ABITSTREAM
- BITSTREAM
- SAMEFIELD
- Ciertas funciones de fecha y hora:
- TIMESTAMP
- CURRENT-GMTDATE
- CURRENT-GMTTIME
- CURRENT-GMTTIMESTAMP
- Todas las funciones INTERVAL-
- La función LIKE de ESQL
- La forma FOLLOWING de la función POSITION de ESQL
- Todas las funciones SQL
- Las funciones UUIDASCHAR y UUIDASBLOB