Analyse BAM de bout en bout (exemple BizTalk Server)

L'exemple de bout en bout décrit la corrélation des événements issus de plusieurs composants (dans ce cas, trois orchestrations et un pipeline) à l'aide de l'analyse BAM.

L'analyse BAM reconstitue l'activité d'entreprise qui couvre le composant de pipeline et les orchestrations. Au niveau le plus bas, cela fonctionne en appelant EventStream.EnableContinuation à partir de chaque composant d’implémentation qui attend plus d’événements pour l’activité. L’appel à EnableContinuation est explicite, tandis que les appels dans Orchestration1 et Orchestration2 sont effectués en ajoutant un dossier Continuation au profil de suivi dans une planification et un dossier ContinuationID à la planification qui le suit.

Le schéma ci-dessous illustre le flux de travail utilisé dans l'exemple.

Fonctions de l'exemple

L'exemple de bout en bout présente l'utilisation de l'analyse BAM pour rassembler des informations à partir d'un pipeline et de plusieurs orchestrations, et mettre à jour une activité spécifique.

Conception et finalité de cet exemple

L'exemple d'analyse BAM de bout en bout a été conçu pour illustrer les activités suivantes :

• utilisation de l'analyse BAM au sein d'un pipeline ;

• utilisation de l'Éditeur de modèle de suivi pour mapper les éléments d'activité vers des formes dans une orchestration et les éléments d'un message ;

• utilisation des continuations pour conserver une activité active lorsque plusieurs éléments d'une solution contribuent à l'activité.

L'exemple fonctionne comme suit :

1. Un message d’entrée est récupéré à partir du <dossier Samples Path>\BamEndToEnd\Input.

2. Le composant de pipeline affecte un DocumentID unique au message, et utilise l'API BAM pour commencer une nouvelle activité BAM. Le DocumentID est joint en tant qu'élément distinct du message d'entrée afin qu'il devienne accessible aux orchestrations.

3. Le service Orchestration1 est activé à la réception du message d'entrée.

4. Orchestration1 modifie le message d'entrée et le transfère en tant que paramètre à Orchestration2.

5. Orchestration2 modifie le message d'entrée et l'envoie vers la base de données MessageBox, qui active Orchestration3.

6. Orchestration3 modifie le message et l’écrit dans le dossier <Samples Path>\BamEndToEnd\Output.

7. Chaque orchestration met à jour les éléments d'activité dans l'activité BAM.

Accès à l'exemple

Vous trouverez cet exemple dans <Samples Path>\BAM\BamEndToEnd.

Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.

Guide pratique pour utiliser cet exemple

Les procédures suivantes permettent de créer et d'exécuter l'exemple d'analyse BAM de bout en bout :

• Pour créer et initialiser l'exemple

• Pour exécuter l'exemple

• Pour afficher les données BAM

Générer et initialiser cet exemple

1. Ouvrez une invite de commandes en tant qu’administrateur, puis exécutez <Samples Path>\BAM\BAMEndToEnd\Setup.bat. Setup.bat crée et initialise l'infrastructure BAM pour cet exemple. Maintenez l'invite de commandes ouverte.

2. Créez un modèle de suivi pour mapper Orchestration1, Orchestration2 et Orchestration3 vers l'activité BAM. (Étant donné que la création du profil de suivi est un processus complexe, les instructions détaillées se trouvent dans une procédure distincte appelée Pour créer un profil de suivi. Cette procédure apparaît plus loin dans ce document.)

3. Déployez le modèle de suivi BamEndToEnd.btt que vous venez de créer au cours de l'étape précédente. Dans l’invite de commandes, accédez au< répertoire Samples Path>\BAM\BamEndToEnd. Pour déployer le profil de suivi, tapez la ligne suivante, puis appuyez sur Entrée :

   “<BizTalkInstallationPath>\Tracking\bttdeploy” BamEndToEnd.btt

   Guide pratique pour déployer des profils de suivi avec l’utilitaire de gestion des profils de suivi fournit plus d’informations.

   Important

   Vous pouvez ignorer le message indiquant que ContinuationID Orch1_ ne possède pas de continuation correspondante. Ce message est attendu, car la continuation nommée Orch1_ est définie dans le composant de pipeline, mais pas dans le modèle de suivi.

Exécuter cet exemple

Copiez le fichier <Samples Path>\BamEndToEnd\InputMessage.xml dans le dossier <Samples Path>\BamEndToEnd\Input. Après quelques secondes, le message disparaît du dossier Input et un message de sortie s’affiche dans le <dossier Samples Path>\BamEndToEnd\Output.

Afficher les données BAM

1. Ouvrez SQL Server Management Studio.

2. Dans SQL Server Management Studio, développez le serveur, bases de données, BAMPrimaryImport, puis Tables.

3. Cliquez avec le bouton droit sur dbo.bam_EndToEndActivity_Completed, puis cliquez sur Ouvrir la table. Si vous utilisez SQL Server, cliquez sur Sélectionner les 1000 premières lignes.

   Le contenu de la table bam_EndToEndActivity_Completed s'affiche dans le volet droit. Chaque ligne de la table représente une activité EndToEndActivity terminée.

Réexécutez cet exemple

1. Ouvrez une invite de commandes en tant qu’administrateur, puis accédez au< répertoire Samples Path>\BAM\BamEndToEnd. Tapez la ligne suivante :

   “C:\Program Files\Microsoft BizTalk Server <version>\Tracking\bttdeploy” BamEndToEnd.btt /remove

   Notes

   Si vous n’avez pas installé BizTalk Server sur le lecteur C, remplacez « C » par la lettre de lecteur dans laquelle vous avez installé BizTalk Server.

2. Exécuter <le chemin d’accès> des exemples\BAM\BAMEndToEnd\Cleanup.bat. Cleanup.bat supprime l'infrastructure BAM pour cet exemple.

3. Effectuez les étapes décrites dans Pour générer et initialiser cet exemple de section de cette rubrique.

Créer un profil de suivi

1. Cliquez sur Démarrer, pointez sur Tous les programmes, puis sur Microsoft BizTalk Server 20xx. Cliquez avec le bouton droit sur Éditeur de profil de suivi, puis Exécutez en tant qu’administrateur.

2. Dans le volet gauche de la fenêtre Éditeur de profil de suivi , cliquez sur Cliquez ici pour importer une définition d’activité BAM.

3. Dans la section Nom de la définition d’activité BAM de la boîte de dialogue Importer une définition d’activité BAM , sélectionnez EndToEndActivity, puis cliquez sur OK.

4. Dans le volet droit de la fenêtre Éditeur de profil de suivi , cliquez sur Cliquez ici pour sélectionner une source d’événement.

5. Dans la section Nom de l’assembly de la boîte de dialogue Sélectionner un assembly parent de source d’événement, sélectionnez Microsoft.Samples.BizTalk.BamEndToEnd.Services, puis cliquez sur Suivant.

6. Dans la section Nom de l’orchestration de la boîte de dialogue Sélectionner une orchestration , sélectionnez BamEndToEnd.Services.Orchestration1, puis cliquez sur OK.

7. Dans le volet gauche de la fenêtre Éditeur de profil de suivi , cliquez avec le bouton droit sur EndToEndActivity, puis cliquez sur Nouvel ID de continuation. Nommez le nouvel ID de continuation Orch1_. Répétez cette étape pour créer deux ID de continuation supplémentaires nommés Orch2_ et Orch3_.

8. Cliquez avec le bouton droit sur EndToEndActivity, puis cliquez sur Nouvelle continuation. Nommez la nouvelle Orch2_ de continuation. Répétez cette étape pour créer une autre continuation nommée Orch3_.

9. Cliquez avec le bouton droit sur la forme Receive1 , puis cliquez sur Schémas de propriété de contexte.

10. Faites défiler jusqu’à la fin de la liste Nom de la propriété de contexte , puis double-cliquez sur BAMEndToEnd.Services.PropertySchema.DocumentID.

11. Développez <Schéma>, puis faites glisser DocumentID dans le volet droit pour Orch1_ dans le volet gauche.

12. Cliquez deux fois sur l’icône de dossier avec la flèche () pour afficher l’orchestration.

13. Faites glisser la forme Receive1 dans le volet droit vers SBegin1 dans le volet gauche.

14. Faites glisser la forme StartOrchestration_1 dans le volet droit vers SEnd1 dans le volet gauche.

15. Cliquez avec le bouton droit sur la forme StartOrchestration_1 , puis cliquez sur Schémas de charge utile du message.

16. Double-cliquez sur la ligne qui contient la valeur « Message_2 » dans la colonne Message et la valeur « MessageBody » dans la colonne Part .

    

17. Développez Schéma2, puis faites glisser Données2 dans le volet droit vers Data1 dans le volet gauche.

18. Cliquez sur Sélectionner une source d’événement, puis sur Sélectionner une propriété de contexte.

19. Faites défiler jusqu’à la fin de la liste Nom de la propriété de contexte , puis double-cliquez sur BAMEndToEnd.Services.PropertySchema.DocumentID.

20. Développez <Schéma>, puis faites glisser DocumentID vers le Orch2_ continuation dans le volet gauche.

    Notes

    Ne confondez pas la continuation Orch2_ et le continuationID Orch2_. L’icône qui représente un ID de continuation contient une clé (), tandis que l’icône qui représente une continuation ne contient pas de clé ( de continuation).

21. Cliquez sur Sélectionner une source d’événement, puis sur Sélectionner une planification d’orchestration.

22. Dans la section Nom de l’assembly de la boîte de dialogue Sélectionner un assembly parent de source d’événement, sélectionnez Microsoft.Samples.BizTalk.BamEndToEnd.Services, puis cliquez sur Suivant.

23. Dans la section Nom de l’orchestration de la boîte de dialogue Sélectionner une orchestration , sélectionnez BamEndToEnd.Services.Orchestration2, puis cliquez sur OK.

24. Cliquez avec le bouton droit sur la forme ConstructMessage_1 , puis cliquez sur Schémas de charge utile du message.

25. Double-cliquez sur la ligne qui contient la valeur « Message_3 » dans la colonne Message et la valeur « BAMPart » dans la colonne Part .

26. Développez BAMPart, puis faites glisser DocumentID dans le volet droit vers l’ID de continuation Orch2_ dans le volet gauche.

    Notes

    Ne confondez pas la continuation Orch2_ et le continuationID Orch2_. L’icône qui représente un ID de continuation contient une clé (), tandis que l’icône qui représente une continuation ne contient pas de clé ( de continuation).

27. Cliquez deux fois sur l’icône de dossier avec la flèche () deux fois pour afficher l’orchestration.

28. Faites glisser la forme ConstructMessage_1 dans le volet droit vers SBegin2 dans le volet gauche.

29. Faites glisser la forme Send_1 dans le volet droit vers SEnd2 dans le volet gauche.

30. Cliquez avec le bouton droit sur la forme Send_1 , puis cliquez sur Schémas de charge utile du message.

31. Double-cliquez sur la ligne qui contient la valeur « Message_3 » dans la colonne Message et la valeur « MessageBody » dans la colonne Part .

32. Développez Schéma3, puis faites glisser Données3 dans le volet droit vers Data2 dans le volet gauche.

33. Dans la liste déroulante située au-dessus du volet droit, sélectionnez Schémas de charge utile du message.

34. Double-cliquez sur la ligne qui contient la valeur « Message_3 » dans la colonne Message et la valeur « BAMPart » dans la colonne Part .

35. Développez BAMPart, puis faites glisser DocumentID dans le volet droit vers le Orch3_ continuation dans le volet gauche.

    Notes

    Ne confondez pas la continuation Orch3_ et le continuationID Orch3_. L’icône qui représente un ID de continuation contient une clé (), tandis que l’icône qui représente une continuation ne contient pas de clé ( de continuation).

36. Cliquez sur Sélectionner une source d’événement, puis sur Sélectionner une planification d’orchestration.

37. Dans la section Nom de l’assembly de la boîte de dialogue Sélectionner un assembly parent de source d’événement, sélectionnez Microsoft.Samples.BizTalk.BamEndToEnd.Services, puis cliquez sur Suivant.

38. Dans la section Nom de l’orchestration de la boîte de dialogue Sélectionner une orchestration , sélectionnez BamEndToEnd.Services.Orchestration3, puis cliquez sur OK.

39. Cliquez avec le bouton droit sur la forme Receive1 , puis cliquez sur Schémas de charge utile du message.

40. Double-cliquez sur la ligne qui contient la valeur « Message_3 » dans la colonne Message et la valeur « BAMPart » dans la colonne Part .

41. Développez BAMPart, puis faites glisser DocumentID dans le volet droit vers l’ID de continuation Orch3_ dans le volet gauche.

    Notes

    Ne confondez pas la continuation Orch3_ et le continuationID Orch3_. L’icône qui représente un ID de continuation contient une clé (), tandis que l’icône qui représente une continuation ne contient pas de clé ( de continuation).

42. Cliquez deux fois sur l’icône de dossier avec la flèche () pour afficher l’orchestration.

43. Faites glisser la forme Receive1 dans le volet droit vers SBegin3 dans le volet gauche.

44. Faites glisser la forme Send_1 dans le volet droit vers SEnd3 dans le volet gauche.

45. Cliquez avec le bouton droit sur la forme Send_1 , puis cliquez sur Schéma de charge utile du message.

46. Développez Schéma3, puis faites glisser Data3 dans le volet droit vers Data3 dans le volet gauche.

47. Cliquez avec le bouton droit sur DocumentID sous le Orch2_ continuation, puis cliquez sur Définir les mappages de ports.

    Notes

    Ne confondez pas la continuation Orch2_ et le continuationID Orch2_. L’icône qui représente un ID de continuation contient une clé (), tandis que l’icône qui représente une continuation ne contient pas de clé ( de continuation).

48. Dans la section Sélectionner des ports de la boîte de dialogue Sélectionner des ports , cliquez sur BamEndToEnd_ReceivePort, sur le signe supérieur à (>), puis sur OK.

49. Enregistrez le profil de suivi dans< Samples Path>\BAM\BamEndToEnd\BamEndToEnd.btt.

Détails importants

Les modèles de suivi ne sont pas pris en charge pour les pipelines. Toutefois, l’appel à BeginActivity dans le composant de pipeline est identique à l’utilisation d’ActivityID dans une orchestration. L’appel à EnableContinuation est identique à l’utilisation d’une continuation dans une orchestration.

Voir aussi

Analyse BAM (dossier d’exemples BizTalk Server)