Undeploy, Unlock, Data Store : les tâches d'administration SAP CPI au même endroit

Trois petites tâches d'administration reviennent chaque semaine dans SAP Cloud Integration (SAP CPI) : arrêter un iFlow, reprendre un iFlow qu'un collègue a laissé verrouillé, et retirer une entrée de Data Store bloquée. Chacune se trouve sur un écran différent du moniteur, et chacune peut faire des dégâts si elle touche le mauvais iFlow.

Cet article explique ce que fait réellement chaque tâche, où SAP la place, et comment faire les trois depuis l'iFlow que vous regardez, avec une confirmation qui indique ce qui va changer.

Faire un undeploy d'un iFlow

L'undeploy retire l'iFlow du runtime : il cesse de traiter des messages, ses endpoints ne répondent plus et ses pollers s'arrêtent, jusqu'à ce qu'il soit redéployé. L'iFlow de conception dans son package ne change pas.

Dans le moniteur de SAP, cela se trouve sous Manage Integration Content : sélectionnez l'iFlow déployé et choisissez Undeploy. Vérifiez le nom deux fois ; les noms similaires sont fréquents.

Retirer un verrou de conception

Quand quelqu'un ouvre un iFlow en mode édition, le designer le verrouille pour tous les autres. Un verrou laissé par un navigateur fermé ou par un collègue en congé bloque l'équipe. Le retirer vous permet de modifier l'iFlow, mais les modifications que son détenteur n'a pas enregistrées dans le designer sont perdues : demandez-lui d'abord quand c'est possible.

Dans le moniteur de SAP, les verrous de conception se trouvent sous Manage Locks.

Supprimer une entrée de Data Store

Les Data Stores conservent des messages qu'un iFlow écrit pour plus tard : pour une nouvelle tentative, pour une étape ultérieure, pour un autre iFlow. Une entrée jamais récupérée, une entrée de test ou un doublon peut bloquer un flux ou le perturber. La suppression d'une entrée est irréversible.

Dans le moniteur de SAP, les Data Stores et les variables se trouvent sous Manage Stores.

Les trois depuis l'iFlow que vous regardez

Dans Kitegra, ouvrez l'iFlow, cliquez sur le bouton « Outils Kitegra » et choisissez « Infos sur l'iFlow ». Le panneau affiche :

• « Déploiement » : « Version », « État », « Déployé par », « Déployé le », et si Trace est activé.
• Les « Points de terminaison », chacun avec un bouton de copie.
• « Verrou d'édition » : « Verrouillé pour édition par … depuis … », ou « Personne ne détient de verrou d'édition sur cet iFlow. »
• Les « Entrées du Data Store » de cet iFlow, chacune à afficher ou à télécharger, et ses « Variables ».

Ses actions demandent d'abord une confirmation et nomment ce qu'elles modifient. Undeploy vous demande de taper le nom de l'iFlow. Unlock nomme le détenteur et avertit que ses modifications non enregistrées seront perdues. « Supprimer » nomme le store et l'entrée et précise que l'opération est irréversible. Sur un tenant marqué PROD dans l'extension, les boîtes de dialogue indiquent aussi « Ce tenant est marqué PROD. » Ensuite, le panneau affiche la réponse de SAP : « Terminé. » ou « SAP a refusé : … ».

Ce qui s'exécute derrière les boutons

Les trois actions utilisent l'API Cloud Integration documentée de SAP, les mêmes appels que vous pouvez scripter vous-même :

# Undeploy an iFlow from Cloud Integration
DELETE https://<tenant>/api/v1/IntegrationRuntimeArtifacts('<iFlow ID>')

# Remove a design-time lock
DELETE https://<tenant>/api/v1/IntegrationDesigntimeLocks(ResourceId='<resource ID>')

# Delete one Data Store entry
DELETE https://<tenant>/api/v1/DataStoreEntries(Id='<entry ID>',DataStoreName='<store>',IntegrationFlow='<iFlow ID>',Type='<type>')

# Each call needs a token from GET with the header "X-CSRF-Token: Fetch",
# sent back as X-CSRF-Token, and a user with the matching role.

Undeploy n'agit que sur Cloud Integration ; les artefacts d'une Edge Integration Cell ne sont pas retirés d'ici. Votre utilisateur SAP a toujours besoin des rôles de chaque action : l'extension ne fait rien que votre utilisateur ne pourrait faire dans le moniteur de SAP.

Les désactiver quand votre politique l'exige

Si votre entreprise n'autorise pas les modifications depuis une extension de navigateur, désactivez « Autoriser les actions qui modifient le tenant » dans la page des options. Undeploy, Unlock, Supprimer et Trace disparaissent alors, et l'extension les refuse. Le panneau continue d'afficher tout ce qu'il lit.

Elles font partie de l'iFlow Inspector de Kitegra, à côté des contrôles de conception de la checklist de revue. Trace, la quatrième action, a ses propres règles.

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