Module de cet article: iFlow Docs
Après Deploy dans SAP CPI : suivi du déploiement, documents de package, paysage des systèmes et Value Mapping dans Excel
Voyez quand un iFlow est Started ou pourquoi il a échoué, choisissez le runtime Cloud ou Edge, lancez de nouveaux contrôles de conception, documentez tout un package avec son paysage, exportez les Value Mappings vers Excel et désactivez n'importe quel outil.
Cliquer sur Deploy dans SAP Cloud Integration (SAP CPI) lance une attente : passer au Monitor, retrouver l'iFlow, actualiser jusqu'à voir Started ou Error, puis comprendre ce que signifie l'erreur. Et une fois l'interface terminée, quelqu'un demande encore le document, le schéma du paysage et la Value Mapping dans un tableur.
Kitegra prend désormais en charge cette partie du travail, à côté du designer de SAP Integration Suite : un suivi du déploiement avec appel de test, un sélecteur de runtime pour les tenants dotés d'Edge Integration Cell, de nouveaux contrôles de conception, un document de package avec un schéma du paysage des systèmes et l'état de la documentation, une feuille Excel pour les Value Mappings, et des explications des scripts Groovy en langage clair. Chaque outil peut être désactivé individuellement. Cet article les passe en revue.
Suivi du déploiement : Started ou Error, sans quitter l'iFlow
Cliquez sur Deploy dans le designer comme d'habitude et confirmez la boîte de dialogue de SAP. Un avis Déploiement apparaît avec "Déploiement…" et le temps écoulé, et vous continuez à travailler. Kitegra demande l'état à SAP au bout de trois secondes, puis de moins en moins souvent, au plus toutes les 20 secondes. Quand SAP répond, l'avis devient :
- Started, avec la version déployée. Si l'iFlow a un endpoint HTTP, Envoyer un appel de test ouvre le HTTP Runner avec la requête prête, et Afficher le dernier message ouvre le panneau Messages actualisé.
- Erreur, avec le texte d'erreur de SAP et, s'il s'agit d'un cas connu, ce qu'il signifie généralement : un autre iFlow déployé utilise déjà l'adresse d'émetteur, un script ne compile pas, un paramètre externalisé n'a pas de valeur, ou SAP n'a pas pu construire l'iFlow. Ouvrir le contenu déployé dans SAP vous mène aux détails.
- Toujours en cours au bout de dix minutes, avec un lien vers le contenu déployé dans SAP.
Si vous annulez la boîte de dialogue Deploy de SAP, rien n'est suivi. Le suivi ne fait que lire l'état du déploiement ; le déploiement lui-même est celui de SAP, lancé par votre propre clic. Suivre ensuite un message à travers l'iFlow est décrit dans tracer un message étape par étape, et l'appel lui-même dans tester un iFlow HTTPS avec une clé de service.
Sélecteur de runtime : Cloud ou Edge
Un tenant doté d'Edge Integration Cell exécute les iFlows sur plusieurs runtimes. Sur un tel tenant uniquement, le bloc Kitegra affiche Runtime : Cloud (ou le nom du runtime Edge). Choisissez-y le runtime, et le Message Monitor lit les messages de cet iFlow et règle son niveau de journalisation sur ce runtime. Le sélecteur indique aussi si l'iFlow est déployé sur chacun, et dans quelle version. Les tenants avec un seul runtime ne le voient jamais.
Nouveaux contrôles de conception dans l'iFlow Inspector
La checklist de revue d'iFlow gagne cinq contrôles, avec une nouvelle catégorie Documentation :
| Contrôle | Pourquoi c'est important |
|---|---|
| Récepteur sans adresse (erreur) | L'iFlow se déploie, mais chaque appel à ce récepteur échoue à l'exécution. |
| Émetteur HTTPS avec une adresse par défaut (avertissement) | Une adresse vide, / ou provisoire comme /test ne dit rien aux appelants, et deux iFlows peuvent entrer en conflit sur elle. |
| Émetteur HTTPS qui attend un jeton CSRF (info) | Chaque appelant doit d'abord récupérer un X-CSRF-Token, sinon son POST reçoit un 403. |
| Adresse de récepteur écrite dans l'iFlow (info) | Passer de DEV à QA puis à PROD oblige à modifier l'iFlow ; Externalize Parameters règle cela en une seule étape. |
| Participant qui garde son nom par défaut (info, Documentation) | "Sender" et "Receiver" apparaissent aussi dans le monitoring, si bien que personne ne sait de quel système il s'agit. |
Comme les autres contrôles, ils comptent dans le score et peuvent être désactivés un par un. Les consulter est gratuit ; l'export du rapport fait partie de Pro. Externalize Parameters et les autres nouveaux outils du Helper sont décrits dans Externalize Parameters, copie d'étape et import depuis le Hub.
Un document pour tout le package
À côté de Documenter cet iFlow, le menu Kitegra propose désormais Document du package. Il lit un par un chaque iFlow du package de l'iFlow ouvert ("Lecture de l’iFlow 2 sur 5…"), et vous pouvez l'arrêter pour ouvrir ce qui a déjà été lu. Les iFlows qui n'ont pas pu être lus sont listés. Le document s'ouvre dans un nouvel onglet, en Word, PDF ou HTML, ou rempli dans votre propre modèle Word, comme le document de conception technique d'un iFlow. Il contient la version, l'éditeur, les tags et le nombre d'iFlows du package, puis chaque iFlow, ainsi que deux nouvelles parties :
- Paysage des systèmes : un schéma avec les émetteurs à gauche, les iFlows du package au centre et les récepteurs à droite. Les participants portant le même nom deviennent une seule case, et chaque ligne indique ses types d'adaptateur.
- État de la documentation : ce dont un lecteur a besoin, vérifié point par point : la description et les tags du package, une description pour chaque iFlow, des participants renommés au lieu de Sender et Receiver, et des adresses de récepteur externalisées. Il indique combien de contrôles sont réussis et ce qui manque, pour que vous puissiez combler les lacunes avant la remise.
Value Mapping dans Excel
Dans la page iFlow Docs, sous Value Mappings, chargez le ZIP d'une Value Mapping (téléchargez-le depuis son package dans SAP) ou son fichier value_mapping.xml. Kitegra liste les valeurs et produit un classeur Excel avec une feuille par paire agence et identifiant : agence, identifiant et valeur source, puis agence, identifiant et valeur cible. Le fichier est lu dans votre navigateur ; rien n'est lu dans SAP et rien n'est envoyé nulle part. La feuille de Message Mapping fonctionne de la même manière pour les mappings.
Des scripts expliqués en langage clair
Expliquer les scripts, dans le menu Kitegra, liste chaque étape de script Groovy de l'iFlow. Pour chacune, il affiche le commentaire de synthèse de l'auteur, les fonctions qu'elle définit, ce qu'elle lit (body, headers, exchange properties, pièces jointes), ce qu'elle définit et modifie, sa logique principale (analyse ou construction de XML ou de JSON, boucles, décisions, appels HTTP, dates), les API SAP qu'elle utilise, comme Security Material, Value Mapping ou Partner Directory, ainsi que des remarques et des risques. Cliquez sur le nom d'une étape pour la sélectionner sur le diagramme. L'explication est déduite du texte du script dans votre navigateur ; le script n'est jamais envoyé nulle part.
Désactivez les outils que vous n'utilisez pas
La page des options comporte désormais une section Outils avec un interrupteur pour chaque outil, regroupé sous son module : de la vérification XPath, Organiser, Security Material, Externalize, la copie d'étape et l'import depuis le Hub dans le Helper, en passant par Messages, le sélecteur de runtime, la visionneuse de logs et le suivi du déploiement, les infos de l'iFlow, l'Inspector et la Recherche, les Documents et les Scripts expliqués, jusqu'aux Notes, Extraits, Comparer, Convertir, Générer et au HTTP Runner dans la Toolbox. Un outil désactivé disparaît aussitôt du designer et de la fenêtre contextuelle ; vos données restent, et Tout activer remet tout en place. Pour désactiver un module entier, utilisez Modules sur la même page ; voir la page des options.
Le suivi du déploiement, le sélecteur de runtime, les Scripts expliqués et la consultation des contrôles de conception sont gratuits. Le document de package, le paysage des systèmes et la feuille de Value Mapping appartiennent à iFlow Docs, avec quelques utilisations en Free et Starter. Pendant le lancement d'Kitegra, tous les outils sont ouverts à toute personne connectée. Comparez les forfaits.
Essayez-le dans votre prochain iFlow
Découvrez ce qu'Kitegra ajoute autour du designer de SAP Integration Suite, ou les nouveaux outils pour écrire des iFlows.
Questions fréquentes
Kitegra déploie-t-il mon iFlow ?
Non. C'est vous qui cliquez sur Deploy dans SAP ; le suivi du déploiement ne fait que lire l'état du déploiement et vous indique quand il est Started ou en échec.
Comment documenter tout un package SAP CPI ?
Ouvrez n'importe quel iFlow du package et choisissez Document du package dans le menu Kitegra. Il lit chaque iFlow et ouvre un seul document avec le schéma du paysage des systèmes et l'état de la documentation, en Word, PDF ou HTML.
Puis-je exporter une Value Mapping vers Excel ?
Oui. Téléchargez le ZIP de la Value Mapping depuis son package dans SAP et chargez-le dans la page iFlow Docs. Vous obtenez une feuille par paire agence et identifiant ; le fichier ne quitte jamais votre navigateur.
Pourquoi ne vois-je pas le sélecteur de runtime ?
Il n'apparaît que sur les tenants qui ont plusieurs runtimes, comme Cloud plus Edge Integration Cell.
Si je désactive un outil, mes données sont-elles supprimées ?
Non. L'outil disparaît du designer et de la fenêtre contextuelle, et ses données restent. Réactivez-le dans la section Outils de la page des options.