Conversion d'une mappe de messages existante qui inclut des fonctions de mappage ESQL

Lorsque vous convertissez une mappe de messages existante qui inclut des fonctions de mappage ESQL, le processus de conversion convertit certaines fonctions ESQL en fonctions XPath 2.0 équivalentes (fn:functionName) ou en fonctions de type de transtypage (xs:type). Une transformation Tâche est ajoutée à votre mappe convertie lorsqu'il n'y a pas de conversion automatique pour une fonction ESQL.

Vérifiez le comportement du processus de conversion lorsque vous convertissez une mappe de messages existante en une mappe de messages qui inclut des fonctions de mappage ESQL:

1. Lorsqu'une mappe de messages existante inclut des appels à des fonctions de mappage ESQL prédéfinies, chaque appel de fonction ESQL est converti en expression XPath, en fonction de type de transtypage ou en transformation XPath personnalisée dans la mappe convertie. Pour chaque transformation d'expression, de fonction xs:type ou de XPath personnalisé dans la mappe convertie, procédez comme suit:
   1. Vérifiez que l'expression, la fonction xs:type ou la transformation XPath personnalisée crée à nouveau le comportement requis.

      Si votre fonction de mappage ESQL comporte des paramètres d'entrée facultatifs, vous devez implémenter des conditions pour gérer cette situation. Par défaut, le processus de conversion suppose que tous les paramètres d'entrée sont obligatoires.

   2. Pour chaque expression, fonction xs:type ou transformation, vérifiez que le nombre correct d'entrées est connecté.

      Dans les éditions précédentes de WebSphere® Message Broker version 8, le nombre d'entrées connectées à une transformation et requises pour implémenter une transformation dans une mappe de messages existante n'était pas appliqué. Lorsque l' éditeur de mappage de données graphiques convertit une transformation qui inclut une fonction de mappage ESQL, il crée une fonction XPath conforme à la spécification XPath 2.0 et connecte les éléments d'entrée à la transformation comme défini dans la mappe de messages existante. Par conséquent, une mappe convertie peut avoir plus d'entrées que celles requises par l'expression XPath, ou moins d'entrées que celles requises pour effectuer le calcul. Par conséquent, l'exécution de la mappe convertie échouera lorsque vous la déploierez.

2. S'il n'existe pas d'équivalent XPath d'une fonction de mappage ESQL, la fonction est remplacée par une transformation Tâche dans votre mappe convertie. Vous devez remplacer chacune de ces transformations Tâche par une transformation XPath personnalisée , une transformation Java personnalisée ou une transformation ESQL personnalisée qui recrée le comportement requis.
   1. Consultez les propriétés Documentation de la transformation dans la mappe convertie pour plus d'informations sur la manière dont la fonction ESQL a été implémentée dans votre mappe de messages existante.

   Les fonctions de mappage ESQL suivantes que vous pouvez utiliser dans une mappe de messages existante n'ont pas d'équivalent XPath dans les mappes de messages:

   • Certaines fonctions mathématiques:
     • ACOS
     • ASIN
     • ATAN
     • ATAN2
     • BitAnd
     • bitNot
     • BitOr
     • BitXOr
     • COS
     • COSH
     • COT
     • DEGRES
     • EXP
     • LN
     • JOURNAL
     • LOG10
     • descripteur de message de sortie
     • PUISSANCE
     • RADIANS
     • ALEA
     • SIGNE
     • SIN
     • SINH
     • RACINE
     • TAN
     • TANH
   • Fonction décimale:
     • TRUNCATE
   • Certaines fonctions de chaîne:
     • ltrim
     • rtrim
     • suppr-début
     • suppr-fin
     • REPLIQUER
     • SPACE
     • TRIM-BOTH (singleton de la source)

       La forme simple TRIM-BOTH (Source) est converti.

   • Certaines fonctions de zone:
     • ABITSTREAM
     • Flot de bits
     • CHAMP SAMEE
   • Certaines fonctions de date et d'heure:
     • HORODATAGE
     • EN COURS-GMTDATE
     • EN COURS-GMTTIME
     • HORODATAGE ACTUEL
   • Toutes les fonctions INTERVAL
   • Fonction ESQL LIKE
   • Forme ESQL SUIVANTE de la fonction ESQL POSITION
   • Toutes les fonctions SQL
   • Les fonctions UUIDASCHAR et UUIDASBLOB