Partager via

Guide pratique pour activer le suivi BAM sur un service d’itinéraire ESB

  • Article

Objectif

Cette section montre comment activer le suivi bam (Business Activity Monitor) pour un itinéraire existant.

Dans cette rubrique de procédure, vous allez effectuer les étapes suivantes :

  • Activez la propriété utilisée pour le suivi des services d’itinéraire à l’aide de Business Activity Monitor.

  • Testez le suivi BAM à l’aide de l’exemple d’application Itinerary Test Client.

  • Vérifiez les résultats BAM à l’aide d’une requête SQL.

Prérequis

Les procédures de cette rubrique pratique nécessitent l’achèvement des conditions préalables pour les activités de développement.

Avant de commencer

Effectuez les tâches suivantes avant d’effectuer les étapes plus loin dans cette rubrique pratique :

  • Créez un modèle de langage spécifique au domaine (DSL) d’itinéraire ESB.

  • Configurez les propriétés de l’itinéraire.

  • Définissez la structure de l’itinéraire.

    Les procédures suivantes décrivent comment effectuer chacune de ces opérations.

Pour créer un modèle DSL d’itinéraire ESB

  1. Dans Visual Studio, ouvrez C :\HowTos\Patterns\Patterns.sln.

  2. Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet ItineraryLibrary, pointez sur Ajouter, puis cliquez sur Nouvel itinéraire.

  3. Dans la boîte de dialogue Ajouter un nouvel élément , cliquez sur ItinéraireDsl dans le volet Modèles.

  4. Dans la zone Nom , tapez BamTracking, puis cliquez sur Ajouter.

Pour configurer les propriétés de l’itinéraire

  1. Dans Visual Studio, cliquez sur l’aire de conception de BamTracking.itinerary. Dans le Fenêtre Propriétés BamTracking, configurez les propriétés suivantes :

    1. Dans la liste déroulante Exporter de modèle , cliquez sur Exportateur d’itinéraire XML.

    2. Dans la section Paramètres de l’extenseur , en regard de la propriété fichier XML D’itinéraire , cliquez sur le bouton de sélection (...).

    3. Dans la boîte de dialogue Sélectionner un fichier XML , dans la zone Nom de fichier , tapez C :\HowTos\Itinéraires\BamTracking , puis cliquez sur Enregistrer.

      Notes

      Cette étape vous permet d’exporter l’itinéraire au format XML vers un emplacement de fichier local. En exportant un itinéraire vers un emplacement de fichier local, plutôt que vers la base de données d’itinéraire, permet de tester l’itinéraire à l’aide de l’application de client de test ESB. Vous effectuerez ce processus plus loin dans cette rubrique pratique.

Pour définir la structure de l’itinéraire

  1. À partir de la boîte à outils, faites glisser un élément de modèle On-Ramp vers l’aire de conception. Dans le Fenêtre Propriétés OnRamp1, configurez les propriétés suivantes :

    1. Cliquez sur la propriété Name , puis tapez ReceiveNAOrder.

    2. Dans la liste déroulante Extender , cliquez sur Extension de service ESB rampée.

    3. Dans la liste déroulante Application BizTalk , cliquez sur Microsoft.Practices.ESB.

    4. Dans la liste déroulante Port de réception , cliquez sur OnRamp.Itinerary.

  2. À partir de la boîte à outils, faites glisser un élément de modèle de service d’itinéraire vers l’aire de conception, puis placez-le à droite de l’élément de modèle On-Ramp . Dans le Fenêtre Propriétés ItineraryService1, configurez les propriétés suivantes :

    1. Cliquez sur la propriété Name , puis tapez MapNAOrderToCNOrder.

    2. Dans la liste déroulante Extension de service d’itinéraire , cliquez sur Extension de service d’itinéraire de messagerie.

      Notes

      Cette propriété définit que le processus aura lieu dans un pipeline (messagerie). Si le processus a lieu dans une orchestration, définissez la propriété Itinerary Service Extender sur Orchestration Itinerary Itinerary Service Extension.

    3. Dans la liste déroulante Conteneur , développez ReceiveNAOrder, puis cliquez sur Gestionnaires de réception.

    4. Dans la liste déroulante Nom du service , cliquez sur Microsoft.Practices.ESB.Services.Transform.

  3. Cliquez avec le bouton droit sur la collection Resolver de l’élément de modèle MapNAOrderToCNOrder , puis cliquez sur Ajouter un nouveau programme de résolution. Dans le Fenêtre Propriétés Resolver1, configurez les propriétés suivantes :

    1. Cliquez sur la propriété Name , puis tapez StaticallySpecifyTheMap.

    2. Dans la liste déroulante Implémentation du programme de résolution, cliquez sur Extension du programme de résolution statique.

    3. Dans la liste déroulante Type de transformation, cliquez sur GlobalBank.ESB.DynamicResolution.Transforms.SubmitOrderRequestNA_To_SubmitOrderRequestCN.

    4. Dans la liste déroulante TransportName , cliquez sur FICHIER.

  4. Dans la boîte à outils, cliquez sur Connecteur. Faites glisser une connexion de l’élément de modèle ReceiveNAOrder vers l’élément de modèle MapNAOrderToCNOrder .

  5. À partir de la boîte à outils, faites glisser un élément de modèle Off-Ramp vers l’aire de conception, puis placez-le à droite de l’élément de modèle MapNAOrderToCNOrder . Dans le Fenêtre Propriétés OffRamp1, configurez les propriétés suivantes :

    1. Cliquez sur la propriété Name , puis tapez SendCNOrder.

    2. Dans la liste déroulante Extender , cliquez sur Extension de service ESB hors rampe.

    3. Dans la liste déroulante Application BizTalk , cliquez sur GlobalBank.ESB.

    4. Dans la liste déroulante Port d’envoi , cliquez sur DynamicResolutionOneWay.

  6. À partir de la boîte à outils, faites glisser un élément de modèle service D’itinéraire vers l’aire de conception, puis placez-le entre l’élément de modèle MapNAOrderToCNOrder et l’élément de modèle SendCNOrder . Dans le Fenêtre Propriétés ItineraryService1, configurez les propriétés suivantes :

    1. Cliquez sur la propriété Name , puis tapez SendPortFilter.

    2. Dans la liste déroulante Extension de service d’itinéraire , cliquez sur Extension de service d’itinéraire hors rampe.

    3. Dans la liste déroulante Hors rampe , développez SendCNOrder, puis cliquez sur Envoyer des gestionnaires.

  7. Cliquez avec le bouton droit sur la collection Resolver de l’élément de modèle SendPortFilter , puis cliquez sur Ajouter un nouveau programme de résolution. Dans le Fenêtre Propriétés Resolver1, configurez les propriétés suivantes :

    1. Cliquez sur la propriété Name , puis tapez ConfigureFolderSettings.

    2. Dans la liste déroulante Implémentation du programme de résolution, cliquez sur Extension du programme de résolution statique.

    3. Dans la liste déroulante Nom du transport , cliquez sur FICHIER.

    4. Cliquez sur la propriété Emplacement de transport , puis tapez C :\HowTos\Out\BAM%MessageID%.xml

      Notes

      Un service d’itinéraire est associé à chaque bretelle d’arrêt ; la combinaison des propriétés du service d’itinéraire et des propriétés de la rampe d’arrêt définissent l’abonnement du port d’envoi dynamique.

  8. Dans la boîte à outils, cliquez sur Connecteur. Faites glisser une connexion de l’élément de modèle MapNAOrderToCNOrder vers l’élément de modèle SendPortFilter .

  9. Dans la boîte à outils, cliquez sur Connecteur. Faites glisser une connexion de l’élément de modèle SendPortFilter vers l’élément de modèle SendCNOrder .

  10. Enregistrez tous les artefacts de projet.

Étapes

Pour modifier l’itinéraire

  1. Dans Visual Studio, ouvrez C :\HowTos\Patterns\Patterns.sln.

  2. Dans Explorateur de solutions, double-cliquez sur BamTracking.itinerary.

  3. Cliquez sur l’élément de service d’itinéraire MapNAOrderToCNOrder .

  4. Dans le Fenêtre Propriétés MapNAOrderToCNOrder, cliquez sur True dans la liste déroulante Suivi activé.

  5. Cliquez sur l’élément de service d’itinéraire SendPortFilter .

  6. Dans le Fenêtre Propriétés SendPortFilter, cliquez sur True dans la liste déroulante Suivi activé.

Pour exporter le modèle à utiliser avec le client de test d’itinéraire

  1. Dans Visual Studio, cliquez avec le bouton droit sur l’aire de conception de l’itinéraire BamTracking , puis cliquez sur Exporter le modèle.

    Notes

    La version XML de l’itinéraire s’ouvre dans Visual Studio.

  2. Enregistrez tous les artefacts de projet.

  3. Dans Windows Explorer, accédez à C :\HowTos\Itinéraires et notez la création de votre code XML d’itinéraire (BamTracking.xml).

Pour tester l’itinéraire

  1. Ouvrez l’exemple d’application Itinerary Test Client à l’aide du raccourci créé pendant les prérequis pour les activités de développement (C:\HowTos\ESB.Itinerary.Test.exe - Raccourci).

  2. Dans le client de test d’itinéraire, désactivez la zone Utiliser le service WCF case activée, puis cliquez sur Charger l’itinéraire.

  3. Dans la boîte de dialogue Ouvrir le fichier d’itinéraire , accédez à C :\HowTos\Itinéraires. Sélectionnez BamTracking.xml, puis cliquez sur Ouvrir pour charger l’itinéraire.

  4. Cliquez sur OK pour effacer le message Itinéraire chargé avec succès .

  5. Dans le client de test d’itinéraire, cliquez sur le bouton de sélection (...) en regard de la zone Charger le message .

  6. Dans la boîte de dialogue Sélectionner un document XML à charger , accédez à C :\HowTos. Sélectionnez NAOrderDoc.xml, puis cliquez sur Ouvrir pour charger le message de test.

  7. Cliquez sur le bouton Envoyer la demande . Une fois le test terminé, cliquez sur OK pour ignorer la confirmation qui s’affiche.

  8. Dans Windows Explorer, accédez à C :\HowTos\Out. Vérifiez que le message BAM%MessageID%.xml a été écrit dans le répertoire.

Pour vérifier le suivi des messages

  1. Cliquez sur Démarrer dans la barre des tâches, pointez sur Tous les programmes, sur SQL Server 2014 ou SQL Server 2012 SP1, puis cliquez sur SQL Server Management Studio.

  2. Cliquez sur Nouvelle requête.

  3. Dans le volet de requête, tapez ce qui suit :

    SELECT *  
FROM [BAMPrimaryImport].[dbo].[bam_ItineraryServiceActivity_Completed]  
GO

  4. Cliquez sur Exécuter.

  5. Dans le volet Résultats, utilisez la colonne TimeStamp pour rechercher l’entrée la plus récente.

Ressources supplémentaires

Pour plus d'informations, consultez les rubriques connexes suivantes :