Objectif(s)

Dans le cadre où un nouveau transport est ajouté au SI, il est important de le configurer dans EFR afin de permettre un suivi des traces de transport.

Ici, nous partirons du principe que les systèmes et les applications ont déjà été correctement cartographiés.

Dans ce tutoriel, nous souhaitons configurer un transfert de Bon de commande entre un MES et un WMS.

Principe

Il y aura 3 choses à configurer, dans cet ordre :

Une médiation,
Un flux,
Un échange.

Configuration de la médiation

La médiation représente le programme qui envoie “physiquement” la trace à EFR. La trace contient le champs $.route.id, identifiant la source de cette trace. Nous allons nous baser sur cet identifiant de route pour configurer la médiation.

Dans notre exemple, le transfert est physiquement effectué par une route Camel. L’identifiant de la route est bcom-to-wms ; il s’agit d’un ESB.

Dans EFR, rendez-vous dans la vue Cartographie/Vue des interactions/Médiations, puis cliquez sur “+ Créer une médiation“.

Dialogue de création de médiation rempli

La “Famille” sélectionnée en haut à gauche du tableau sera utilisée pour la création de la médiation.

Une fois la médiation créée, se rendre sur sa page donnera le résultat suivant.

Configuration du flux

Maintenant, nous allons configurer le flux. Ici, dans cet exemple simple, la médiation (code exécutable) n’est représentée que par un demi-flux. Plus précisément, la médiation consomme une file AMQ et pousse directement dans WMS un résultat.

Rendez-vous dans la liste des flux, et configurez celui qui correspond à votre besoin.

Dialogue de création d’un flux, rempli selon les besoins de l’exemple.

Une fois le flux créé et sélectionné, vous pourrez indiquer les informations cartographiques qu’il embarque.

Flux créé, avec quelques informations essentielles supplémentaires.

Ensuite, dans la chorégraphie des médiations, ajoutez la médiation précédemment créée. Cela permet de relier les deux, et permet de retrouver quel flux est concerné par une trace représentant une certaine médiation.

Chorégraphie basique, reliant la médiation au flux.

Votre flux est désormais créé. Vous pourrez dès à présent le retrouver dans la liste des flux du runtime si vous exécutez votre route et envoyez une trace valide.

Cependant, il faut à présent configurer l'échange afin que le métier puisse identifier les problèmes quand il y en aura.

Configuration de l'échange

Dans la liste des échanges, créez un nouvel objet comme suit :

Dialogue de création d’un échange, rempli selon les besoins de l’exemple.

Une fois l'échange créé, vous pourrez alors indiquer à ses systèmes sources et cible, ainsi que l’information transportée. Pour rappel, les systèmes sont une abstraction métier des applications, et les informations sont celles des données.

Voici ce que l’on obtient dans le cadre de notre exemple :

Échange configuré avec le flux précédemment créé.

À présent, lorsque que la route s’exécutera, une trace sera envoyée. Cette trace sera identifiée à une médiation, participant à la chorégraphie d’un flux. Finalement, ce dernier caractérisant un échange, le métier saura exactement à quoi correspond votre trace et donc votre exécution.

Résumé

Résumé de la situation