Module de cet article: iFlow Inspector
Checklist de revue d'iFlow SAP CPI, et comment l'automatiser
Checklist pratique de revue d'iFlow SAP CPI : gestion des erreurs, niveaux de journalisation, secrets, protocoles, scripts et structure, et comment l'exécuter automatiquement, avec score et rapport.
La revue d'un iFlow se fait généralement dans l'urgence, juste avant un transport, et vérifie ce dont le relecteur se souvient. Les mêmes problèmes arrivent alors en production encore et encore : aucune gestion des erreurs, un mot de passe dans un Content Modifier, un Router sans route par défaut.
Cet article propose une checklist de douze contrôles pour les iFlows SAP Cloud Integration (SAP CPI), explique pourquoi chacun compte, et montre comment les exécuter automatiquement, avec un score et un rapport à joindre au transport.
Quand relire un iFlow
- Avant le premier transport vers un tenant de test ou de production.
- Quand un iFlow est confié à un autre développeur ou aux opérations.
- Après une modification importante, comme un nouveau récepteur ou un nouveau script.
- De temps en temps, pour les iFlows qui ont grossi au fil des années.
La checklist
| Contrôle | Pourquoi il compte | Catégorie |
|---|---|---|
| Pas d'Exception Subprocess | Une erreur termine le message avec la gestion par défaut de SAP : pas d'alerte, pas de réponse propre à l'émetteur. | Fiabilité |
| Niveau de journalisation détaillé | Journaliser chaque étape ralentit chaque message et remplit le stockage des journaux du tenant. | Performance |
| Aucune description | Les autres ne peuvent savoir ce que fait l'iFlow ni qui en est responsable sans l'ouvrir. | Maintenabilité |
| Secret en clair | Toute personne qui peut ouvrir ou télécharger l'iFlow peut lire un mot de passe ou un jeton qui y est écrit. | Sécurité |
| Étape de script sans script | Une étape de script sans fichier de script échoue à l'exécution. | Exactitude |
| Processus volumineux | Un processus comportant beaucoup d'étapes est difficile à lire, à tester et à modifier. | Maintenabilité |
| Protocole non sécurisé | HTTP ou FTP en clair envoient les données, et les identifiants Basic, sans chiffrement. | Sécurité |
| Appel sans Receiver | Une étape Request Reply ou Send sans canal n'a nulle part où envoyer le message. | Exactitude |
| Risque dans le script | println, la lecture d'un gros body en une seule String, des scripts très longs, des parseurs XML exposés à XXE. | Performance |
| Local Integration Process inutilisé | Aucun Process Call ne l'atteint, il ne s'exécute donc jamais. | Maintenabilité |
| Étape non connectée | Aucun chemin partant d'un événement de début ne l'atteint, elle ne s'exécute donc jamais. | Exactitude |
| Router sans route par défaut | Quand aucune condition n'est remplie, le message échoue au lieu de suivre un chemin connu. | Fiabilité |
Ce sont les catégories qu'utilise Kitegra. Dans une revue manuelle, l'essentiel est que chaque contrôle ait une raison et une correction sur lesquelles l'équipe s'accorde.
Ce qu'une checklist ne voit pas
Les contrôles lisent la conception de l'iFlow. Ils ne savent pas si le mapping est juste pour le métier, si le récepteur supporte la charge, ni si la gestion des erreurs envoie l'alerte à quelqu'un qui la lit. Une revue a toujours besoin d'une personne pour ces questions, et d'un test avec des données réalistes.
Les noms sont une partie distincte de la revue : un jeu de règles de nommage les rend vérifiables eux aussi.
Exécuter les contrôles automatiquement
Dans Kitegra, ouvrez l'iFlow, cliquez sur le bouton « Outils Kitegra » et choisissez « Inspecteur ». Son onglet « Conception » exécute les douze contrôles ci-dessus sur l'iFlow ouvert et ses scripts :
- Chaque constat indique pourquoi il compte et une ligne « Correction : ».
- Le « Score (0–100) et note » résume l'iFlow, de A à E.
- « Réglages des contrôles » désactive un contrôle ou modifie son poids dans le score ; ces réglages se synchronisent avec votre compte Kitegra.
- « Définir la référence » marque les constats du jour comme connus, pour que la prochaine revue ne montre que les nouveautés.
- « Masquer » cache un constat et demande pourquoi ; « Afficher les connus et les masqués » les fait réapparaître.
L'un des contrôles porte sur le niveau de journalisation ; pourquoi TRACE ne doit pas rester actif l'explique.
Partager le résultat sous forme de rapport
« Rapport » ouvre le rapport de l'iFlow dans un nouvel onglet : les caractéristiques de l'iFlow (étapes, scripts, adaptateurs, processus), son score, les constats de conception filtrés par catégorie ou par gravité, et les constats de nommage. Exportez-le en HTML, PDF ou Excel, ou choisissez « Imprimer ». Sous « En-tête du rapport », vous pouvez ajouter un nom d'entreprise et un logo de 20 KB maximum.
Le rapport est lu à partir du modèle de l'iFlow et ne contient aucun contenu de message. Les libellés du PDF sont en anglais.
Comment Kitegra vous aide
Les contrôles de conception font partie de l'iFlow Inspector de Kitegra. Ils s'exécutent dans votre navigateur sur l'iFlow ouvert ; les réglages des contrôles et les références se synchronisent avec votre compte Kitegra quand vous êtes connecté, et les scripts et mappings ne sont jamais envoyés.
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 ; Startup Team donne 300 à chaque membre, Growth Team et Scale Team sont sans limite. La Toolbox et les extras de l'espace de travail ne comptent aucun iFlow. Pendant le lancement d'Kitegra, tous les outils sont ouverts à toute personne connectée, y compris avec le forfait Free. 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
Que doit vérifier la revue d'un iFlow SAP CPI ?
La gestion des erreurs, le niveau de journalisation, la description, les secrets en clair, les scripts, la sécurité des protocoles, les parties non connectées ou inutilisées et les routes par défaut des Router, ainsi que le nommage et la logique métier.
Pourquoi un Router sans route par défaut pose-t-il problème ?
Quand aucune condition n'est remplie, le message échoue au lieu de suivre un chemin connu.
Comment le score est-il calculé ?
Chaque constat retire au score, à partir de 100, un poids qui dépend de sa gravité, et le score correspond à une note de A à E. Vous pouvez modifier le poids de chaque contrôle.
À quoi sert « Définir la référence » ?
Il marque les constats du jour comme connus, pour qu'une revue ultérieure ne montre que les nouveaux.
Puis-je exporter la revue ?
Oui. Le rapport de l'iFlow s'exporte en HTML, PDF ou Excel, avec le nom et le logo de votre entreprise.
Le rapport contient-il du contenu de message ?
Non. Il est lu à partir du modèle de l'iFlow et ne contient aucun contenu de message.