Tracer un message SAP CPI étape par étape sans quitter le designer d'iFlows

Quand un iFlow renvoie un mauvais résultat, la question est presque toujours la même : à quoi ressemblait le message juste avant l'étape qui a mal tourné ? SAP Cloud Integration (SAP CPI) sait y répondre, mais seulement pour les messages traités avec le niveau de journalisation TRACE, et la réponse se trouve dans le moniteur, à plusieurs écrans du diagramme que vous modifiez.

Cet article explique ce qu'enregistre une trace, comment la lire dans le moniteur de SAP, et comment suivre cette même trace sur le diagramme, étape par étape, avec Kitegra.

Ce qu'enregistre une trace

Chaque message laisse un journal de traitement des messages (MPL) : son statut, son début et sa fin, et les étapes qu'il a exécutées. Le niveau de journalisation de l'iFlow détermine la quantité de détails qui y figure.

Le contenu d'une trace sert à enquêter, pas à archiver. SAP le conserve environ une heure, et le niveau TRACE lui-même retombe au bout d'environ 10 minutes : le message que vous voulez lire doit donc s'exécuter peu après l'activation de TRACE. Comme elle stocke de vrais payloads dans le tenant, utilisez-la si possible sur des données de test, et suivez les règles de votre entreprise en production. Pourquoi TRACE se désactive tout seul en explique les limites.

Lire une trace dans le moniteur de SAP

1. Dans le moniteur, ouvrez Manage Integration Content, sélectionnez l'iFlow déployé et passez son niveau de journalisation à Trace.
2. Renvoyez le message dans les minutes qui suivent.
3. Ouvrez le message dans Monitor Message Processing et suivez son lien de trace jusqu'à l'exécution du traitement.
4. Sélectionnez une étape sur le diagramme de l'exécution et ouvrez le contenu de son message : headers, propriétés et payload.

Cela fonctionne, mais chaque consultation d'une étape demande quelques clics, le diagramme de l'exécution n'est pas celui que vous modifiez, et au bout de 10 minutes il faut redéfinir le niveau de journalisation.

Activer TRACE depuis le designer

Avec Kitegra, ouvrez l'iFlow dans le designer, cliquez sur le bouton « Outils Kitegra » de la barre d'outils du diagramme et choisissez « Messages » (ou appuyez sur Alt+Shift+M). Le panneau liste les derniers messages de l'iFlow sur le runtime de votre choix, regroupés par jour, avec statut, heure de début et durée. Les messages tracés portent une marque TRACE, et les nouveaux clignotent à leur arrivée.

L'interrupteur du panneau indique « Trace : désactivé ». Un clic passe le niveau de journalisation de l'iFlow à TRACE, et l'interrupteur affiche « Trace : activé » avec un décompte en minutes. Tant qu'il est activé et que vous travaillez dans l'iFlow, l'extension redéfinit TRACE avant que SAP ne le retire ; elle cesse de le renouveler 20 minutes après votre dernière activité. La désactivation rétablit le niveau de journalisation que l'iFlow avait auparavant.

Trace est l'une des quatre actions qui modifient votre tenant et, comme les autres, elle ne s'exécute que lorsque vous cliquez dessus.

Suivre le message sur le diagramme

1. Envoyez le message, ou attendez le suivant. Il apparaît en haut du panneau « Messages ».
2. Sur un message tracé, choisissez « Sur le diagramme ». Les étapes qu'il a parcourues sont colorées, une étape en échec est signalée et les étapes qu'il n'a pas atteintes sont grisées.
3. Cliquez sur une étape colorée. Le panneau « Contenu avant l'étape » affiche le Body, les « En-têtes » et les « Propriétés d'échange » tels qu'ils étaient avant cette étape, le « Journal » de l'étape et l'« Erreur » quand l'étape a échoué.
4. Utilisez « Précédent » et « Suivant » pour parcourir les étapes dans l'ordre de leur exécution. Une étape exécutée plusieurs fois, dans un Splitter ou une boucle, affiche chaque exécution, par exemple « Exécution 2 sur 3 de cette étape ».
5. Quand vous avez terminé, choisissez « Effacer les marques du diagramme ».

Si le message s'est exécuté sans TRACE, le panneau le signale : SAP ne conserve le body et les headers d'un message que lorsqu'il s'exécute avec TRACE, et seulement pendant environ une heure.

Exploiter ce que vous trouvez

• La visionneuse de payload affiche un body « Formaté » ou sur « Une ligne », propose « Retour à la ligne » et « Rechercher », et permet de « Copier » ou de « Télécharger ».
• « Comparer avec l'étape suivante » ouvre deux bodies côte à côte dans « Comparaison de payloads », pour voir exactement ce qu'une étape a changé.
• « Durées » colore les étapes selon leur durée, de la plus rapide (vert) à la plus lente (rouge) ; survolez une étape pour voir son temps.
• Sur une longue exécution, « Étapes lues » fixe le nombre d'étapes lues pour cet iFlow, ou « Toutes ».
• Pour un message en échec, l'onglet « Résumé » indique où il a échoué et, pour les erreurs connues, « Ce que cela signifie en général : ».

Pour ouvrir un message dont vous connaissez l'ID, de cet iFlow ou de tout autre iFlow du tenant, voir retrouver un message SAP CPI par Message ID ou Correlation ID.

Comment Kitegra vous aide

Le Message Monitor est l'un des cinq domaines de Kitegra. Le contenu d'une trace, ce sont des données client : l'extension l'affiche dans la page et vous laisse télécharger un body, mais ne le stocke, ne le synchronise et ne l'envoie jamais à Kitegra.

Le Helper, le Message Monitor, l'iFlow Inspector et iFlow Docs comptent chacun les iFlows sur lesquels vous les utilisez : 5 par module sans compte Kitegra, 50 avec le forfait Free, 100 avec Starter et 300 avec Pro ; Business n'a pas de limite. La Toolbox et les extras de l'espace de travail sont gratuits. Comparez les forfaits.

Essayez-le dans votre prochain iFlow

Découvrez ce que Kitegra ajoute autour du designer de SAP Integration Suite, ou voyez-le aux côtés des autres extensions Chrome de Kitegra.

Questions fréquentes