API BAM à partir d'une expression d'orchestration (exemple BizTalk Server)
Cet exemple montre comment :
Utilisez l’API BAM à partir d’une expression d’orchestration BizTalk Server.
suivre des éléments répétés à l'intérieur d'un message comme des instances d'activité distinctes ;
créer une relation entre les données BAM suivies à l'aide d'un modèle de suivi et les données BAM suivies à l'aide de l'API BAM.
Accès à l'exemple
Vous trouverez cet exemple dans <Samples Path>\BAM\BamFromExpression.
Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.
| Fichier | Description |
|---|---|
| BamDefinition.xls | Feuille de style définition BAM. |
| BamDefinition.xml | Définition BAM. |
| BamFromExpression.btproj | Projet de fichier de suivi Visual Studio. |
| BamFromExpression.sln | Solution Visual Studio. |
| Cleanup.bat | Fichiers de commandes pour annuler le déploiement de l'exemple. |
| InputMessage.xml | Message d'entrée. |
| Orchestration1.odx | Orchestration : |
| PoSchema.xsd | Schéma de bon de commande. |
| PropertySchema.xsd | Schéma de propriété. |
| Setup.bat | Fichier de commandes pour compiler et déployer l'exemple. |
| QueryBam.sql | Script SQL. |
Créer le profil de suivi
Ouvrez une invite de commandes en tant qu’administrateur, puis exécutez <Samples Path>\BAM\BAMFromExpression\Setup.bat. Setup.bat initialise l'infrastructure BAM pour cet exemple et déploie l'activité BAM.
À partir de vos programmes>Microsoft BizTalk Server, cliquez avec le bouton droit sur Éditeur de profil de suivi, puis Exécutez en tant qu’administrateur.
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.
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 FromExpressionPo, puis cliquez sur OK.
Dans le volet droit de la fenêtre Éditeur de profil de suivi , cliquez sur Cliquer ici pour sélectionner une source d’événement.
Dans la section Nom de l’assembly de la boîte de dialogue Sélectionner l’assembly parent de la source de l’événement, sélectionnez Microsoft.Samples.BizTalk.BamFromExpression, puis cliquez sur Suivant.
Dans la section Nom de l’orchestration de la boîte de dialogue Sélectionner l’orchestration , sélectionnez BamFromExpression.Orchestration1, puis cliquez sur OK.
Cliquez avec le bouton droit sur la forme Receive_1 , puis cliquez sur Schéma de charge utile du message.
Développez <Schéma>, PurchaseOrder, From, puis faites glisser PoID dans le volet droit vers ActivityID dans le volet gauche.
Faites glisser les éléments suivants à partir du volet droit et déposez-les sur les nœuds nommés dans le volet gauche :
Du À Nom Du State State City City Téléphone Téléphone Total PoTotal Cliquez sur l’icône de dossier avec la flèche (
) pour afficher l’orchestration.Faites glisser la forme Receive_1 dans le volet droit vers Reçu dans le volet gauche.
Faites glisser la forme Send_1 dans le volet droit vers Envoyer dans le volet gauche.
Enregistrez le profil de suivi dans <Samples Path>\BAM\BamFromExpression\ BamFromExpression.btt.
Dans le menu Outils , cliquez sur Appliquer le profil de suivi.
Générer et initialiser cet exemple
Déployez le modèle de suivi BamFromExpression.btt. Consultez Guide pratique pour déployer des profils de suivi avec l’utilitaire de gestion des profils de suivi.
Exécuter cet exemple
Copiez le fichier< Samples Path>\BamFromExpression\InputMessage.xml dans <Samples Path>\BamFromExpression\Input.
Dans environ 10 secondes, le message de sortie s’affiche dans <Samples Path>\BamFromExpression\Output.
Afficher les données BAM
Ouvrez SQL Server Management Studio.
Dans SQL Server Management Studio, développez le serveur, bases de données, BAMPrimaryImport, puis Tables.
Cliquez avec le bouton droit sur dbo.bam_FromExpressionPo_Completed, puis cliquez sur Ouvrir la table. Si vous utilisez SQL Server, cliquez sur Sélectionner les 1 000 premières lignes.
Le contenu de la table bam_FromExpressionPo_Completed s'affiche dans le volet droit. La ligne dont l'ID d'activité est 123 représente le bon de commande d'une valeur de 345 $ que contenait le message entrant.
Cliquez avec le bouton droit sur dbo.bam_FromExpressionPoItem_Completed, puis cliquez sur Ouvrir la table. Si vous utilisez SQL Server, cliquez sur Sélectionner les 1 000 premières lignes.
Le contenu de la table bam_FromExpressionPoItem_Completed s'affiche dans le volet droit. Les deux lignes, qui ont les ID d’activité 123_0 et 123_1, représentent les éléments de la commande : Flash MC et Décodeur infrarouge.
Cliquez avec le bouton droit sur dbo.bam_FromExpressionPoItem_CompletedRelationships, puis cliquez sur Ouvrir la table. Si vous utilisez SQL Server, cliquez sur Sélectionner les 1 000 premières lignes.
Le contenu de la table bam_FromExpressionPoItem_CompletedRelationships s'affiche dans le volet droit. Chaque ligne de la table représente une relation entre une activité FromExpressionPoItem et une activité FromExpressionPo. La valeur dans la colonne ActivityID fait référence à l’ID d’activité de l’activité FromExpressionPoItem. La valeur dans la colonne ReferenceData fait référence à l’ID d’activité de l’activité FromExpressionPo. Dans ce cas, les deux enregistrements indiquent que les articles Flash MC et décodeur infrarouge sont associés au bon de commande d'une valeur de 345 $.
Réexécuter l’exemple
Ouvrez une invite de commandes en tant qu’administrateur, puis exécutez <samples Path>\BAM\BamFromExpression\Cleanup.bat pour supprimer le profil de suivi et toute autre infrastructure BAM.
Exécutez <le chemin d’accès> d’exemples\BAM\BamFromExpression\Setup.bat pour compiler l’exemple et le déployer.
Voir aussi
Analyse BAM (dossier d’exemples BizTalk Server)
Relations d’activité