Kitegra 2.0 : autocomplétion, trace des messages, iFlow Inspector et documentation pour SAP CPI

Construire un iFlow dans le designer de SAP Integration Suite oblige à en sortir sans cesse : vers le moniteur pour voir ce qu'a fait un message, vers un tableur pour la spécification du mapping, vers un autre outil pour appeler l'endpoint, vers un collègue pour savoir quelle règle de nommage s'applique. Kitegra est une extension Chrome et Edge qui ramène ce travail à côté du diagramme que vous modifiez.

La version 2.0 passe d'un module à cinq domaines. Cet article explique ce que fait chacun, ce que l'extension modifie dans votre tenant et quand, ce qu'elle conserve et synchronise, et combien d'iFlows chaque forfait couvre. C'est l'une des extensions Chrome de Kitegra.

Cinq domaines autour du designer d'iFlows

Ouvrez un iFlow : un bloc Kitegra apparaît dans la barre d'outils du diagramme, en mode lecture comme en mode édition. « Messages », « Logs » et « Infos sur l'iFlow » y ont chacun leur bouton ; tous les autres outils sont dans le menu derrière le dernier bouton, et Alt+Shift+P ouvre ce menu au clavier. Chaque outil ouvre un panneau que vous pouvez déplacer sur la page. Les outils appartiennent à cinq domaines :

• Helper (Integration Flow Helper) : écrivez vos iFlows plus vite, avec des suggestions et des contrôles dans les champs mêmes du designer.
• Message Monitor : les messages, la trace et les journaux de l'iFlow ouvert, dans le designer.
• iFlow Inspector : les détails de l'iFlow déployé, les contrôles de nommage et de conception, et la recherche.
• iFlow Docs : des documents générés à partir d'un iFlow ou d'un Message Mapping.
• Toolbox : des outils gratuits pour comparer, convertir et générer des payloads, des extraits, des notes et des requêtes HTTP.

Chaque domaine peut être désactivé dans la page des options, sous « Modules ». Autour d'eux, quelques extras de l'espace de travail rendent le tenant plus agréable au quotidien : une barre d'environnement, la personnalisation de l'onglet, des liens de monitoring et des raccourcis clavier.

Helper : écrivez vos iFlows plus vite

Tapez ${ ou $ dans un champ du designer et une liste des noms pertinents à cet endroit de l'iFlow s'ouvre. Le reste du Helper s'appuie sur le même modèle de votre iFlow :

• Suggestions : les headers et exchange properties définis par votre iFlow, les headers standard de SAP et de Camel, les paramètres {{…}}, les variables, les Data Stores, et les noms de Security Material et de Keystore dans les champs d'identifiants.
• Contrôle des expressions : expressions non fermées, espaces en trop, headers que rien ne définit avant l'étape courante, et noms OData absents de l'EDMX.
• Sources : des chemins XPath à partir d'un payload d'exemple, des URL et des bodies à partir d'un fichier OpenAPI, Swagger ou Postman, et les headers transmis via ProcessDirect et JMS.
• Organiser le diagramme : range le diagramme en un clic en mode édition ; Save le conserve, et le bouton Annuler à côté le remet comme avant.

Les six articles précédents approfondissent ces points, à commencer par les expressions Camel Simple dans SAP CPI.

Message Monitor : voir ce qui s'est passé

• Messages : les derniers messages de l'iFlow ouvert dans un panneau à côté du diagramme, avec statut, heure et durée, et l'erreur SAP expliquée sous « Ce que cela signifie en général : ».
• Trace : un seul interrupteur passe le niveau de journalisation de l'iFlow à TRACE et le maintient tant que vous travaillez.
• Sur le diagramme : les étapes parcourues par un message tracé sont colorées sur le diagramme, et un clic sur une étape affiche le body, les headers et les exchange properties juste avant elle.
• Journaux des messages : une visionneuse de journaux avec recherche par Message ID ou Correlation ID, une chronologie des messages liés et la durée de chaque étape sur le diagramme.

Tracer un message étape par étape montre le parcours complet.

iFlow Inspector et iFlow Docs : relire et documenter

• Nommage : les règles dont votre équipe convient, vérifiées sur chaque étape, avec un nom proposé et un bouton « Renommer ».
• Contrôles de conception : gestion des erreurs, secrets en clair, protocoles non sécurisés, risques dans les scripts et plus encore, avec un score de 0 à 100, une référence et un rapport en HTML, PDF ou Excel. La checklist de revue d'iFlow les recense.
• Infos sur l'iFlow : déploiement, endpoints, entrées du Data Store, variables et verrou d'édition, avec Undeploy, Unlock et Supprimer quand vous en avez besoin.
• Recherche dans l'iFlow, ou dans tout son package.
• Un document de conception généré à partir de l'iFlow, en Word, PDF ou HTML, avec son diagramme et un récit de chaque processus, ou rempli dans votre propre modèle Word. Voir générer un document de conception technique.
• Un tableau de mapping Excel pour les Message Mappings, et des scripts expliqués.

Toolbox et espace de travail

• Comparaison de payloads, un convertisseur de formats, un générateur de payloads de test avec erreurs, des extraits Groovy et un aide-mémoire, et des notes par iFlow, par tenant ou globales.
• Un HTTP Runner pour les endpoints de vos iFlows, avec OAuth à partir d'une service key Process Integration Runtime.
• Une barre d'environnement (PROD, TEST, DEV) et la personnalisation de l'onglet par tenant, des liens de monitoring, des raccourcis clavier et la taille du volet des propriétés.

L'interface est disponible en 15 langues, en mode clair et sombre.

Pour commencer, étape par étape

1. Ajoutez Kitegra à Chrome ou à Microsoft Edge.
2. Ouvrez un iFlow dans le designer de SAP Integration Suite de votre tenant (une adresse *.hana.ondemand.com).
3. Cliquez dans un champ, par exemple une valeur de Content Modifier, et tapez ${ ou $ ; choisissez un nom dans la liste.
4. Dans le bloc Kitegra de la barre d'outils du diagramme, cliquez sur « Messages », « Logs » ou « Infos sur l'iFlow », ou ouvrez son menu pour l'« Inspecteur » et les autres outils.
5. Ouvrez la fenêtre contextuelle de l'extension pour vos tenants, packages et iFlows, et pour la vue « Outils » avec les pages de la Toolbox.

Sans compte, vous pouvez utiliser chaque module sur 5 iFlows. Pour aller au-delà, choisissez Se connecter avec Kitegra dans l'extension.

Essayez-le dans votre prochain iFlow

Voyez Kitegra aux côtés des autres extensions Chrome de Kitegra, et comparez ce que chaque forfait comprend.

Ce qu'elle modifie dans votre tenant, et quand

L'extension lit l'iFlow ouvert, ses messages et ses journaux avec votre propre session SAP. Elle n'enregistre, ne déploie et ne modifie jamais le contenu d'un iFlow : « Renommer » et les extraits ne font que saisir du texte dans les champs du designer, et c'est vous qui enregistrez. Elle ne modifie votre tenant que lorsque vous cliquez sur l'une de quatre actions nommées :

Un seul interrupteur de la page des options, « Autoriser les actions qui modifient le tenant », désactive les quatre : leurs boutons disparaissent et l'extension les refuse. Le HTTP Runner n'envoie que les requêtes que vous écrivez et envoyez vous-même.

Ce qu'elle conserve, et ce qui se synchronise

• Le contenu des messages (bodies, headers, propriétés, pièces jointes et journaux) s'affiche dans la page, sans jamais être stocké ni envoyé nulle part.
• Sans compte Kitegra, rien ne quitte votre navigateur.
• Une fois connecté, Kitegra conserve, pour chaque iFlow que vous ouvrez, son nom et son id, son package, le lien vers le designer, les modules utilisés, les dates et une empreinte à sens unique (hash) de votre compte SAP, afin de compter les iFlows de votre forfait.
• Une fois connecté, ce que vous avez écrit vous suit sur chaque ordinateur : réglages et raccourcis, notes, règles de nommage, réglages et références des contrôles de conception, personnalisation des tenants, extraits, et les collections du HTTP Runner, dont toute valeur d'authentification et toute variable secrète sont retirées. Avec l'interrupteur « Tableau de bord Kitegra » activé dans la page des options (activé par défaut), les noms et les id de vos packages et iFlows sont aussi envoyés, et avec un forfait d'équipe, le propriétaire de l'équipe peut les voir, ainsi que vos notes.
• Jamais envoyés : le contenu des messages, les scripts, les mappings, les payloads d'exemple, les spécifications d'API, les identifiants et les secrets. Sous Options › Synchronisation, « Supprimer les données synchronisées » efface de Kitegra ce qui a été synchronisé.

Combien d'iFlows chaque forfait couvre

La limite compte des iFlows distincts, par module et à vie : rouvrir un iFlow déjà utilisé ne compte pas une nouvelle fois, et un iFlow utilisé par un module n'est compté par un autre que lorsque vous utilisez cet autre module dessus.

Le Helper, le Message Monitor, l'iFlow Inspector et iFlow Docs comptent les iFlows ; la Toolbox et les extras de l'espace de travail n'en comptent aucun. Un iFlow au-delà de la limite de votre forfait affiche un cadenas dans le designer et dans la fenêtre contextuelle. Pendant le lancement d'Kitegra, tous les outils sont ouverts à toute personne connectée, y compris avec le forfait Free. Quand vous vous connectez avec Kitegra, les iFlows utilisés sans compte passent sur votre compte. Comparez les forfaits.

Questions fréquentes