Partager via

OrderedSample (exemple BizTalk Server)

  • Article

L'exemple OrderedSample illustre l'utilisation d'une orchestration pour recevoir et envoyer une série classée de messages de manière cyclique.

Fonctions de l'exemple

Cet exemple part du principe qu'il existe des messages dans la file d'attente MQSeries à partir de laquelle il reçoit les messages. Lorsque l’adaptateur lit les messages de la file d’attente MQSeries, il les lit dans l’ordre et les envoie à BizTalk Server.

Le port de réception dans l’orchestration, mqreceive, a sa propriété Livraison ordonnée définie sur True.

Au niveau de l'envoi, l'orchestration envoie un message puis attend un accusé de réception avant d'expédier le suivant. La propriété Notification de remise du port d’envoi mqsend est définie sur Transmis. Pour simplifier l'exemple, l'orchestration utilise une boucle infinie.

L'orchestration peut recevoir des lots de messages et des messages individuels.

Accès à l'exemple

<Chemin d’exemples>\AdaptersUsage\MQSeriesAdapter\OrderedSample

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

Fichier Description
OrderedReceiveSend.btproj,

OrderedReceiveSend.sln		 Fichiers de projet et de solution de l'application.
OrderedReceiveSendOrchestration.odx Orchestration de l'application.
OrderedSample.snk Fichier de clé de nom fort.
Setup.bat Crée et initialise l'exemple.

Génération et exécution de l’exemple

Pour créer et déployer l'exemple

  1. Dans une fenêtre de commande, accédez au dossier suivant :

    <Samples Path>\AdaptersUsage\MQSeriesAdapter\OrderedSample

  2. Exécutez le fichier Setup.bat, qui effectue les actions suivantes :

    1. création d'une clé de nom fort pour le projet ;

    2. compilation et déploiement du projet d'orchestration.

    Si vous disposez des autorisations nécessaires à l'installation du serveur MQSeries pour Windows, vous pouvez créer les files d'attente MQSeries à l'aide des boîtes de dialogue de l'adaptateur et ignorer la procédure suivante. Sinon, vous pouvez créer les files d'attente à l'aide d'IBM WebSphere MQ Explorer. Pour créer les files d’attente via le Explorer WebSphere MQ, effectuez les étapes suivantes.

Création des files d'attente MQSeries à l'aide de WebSphere MQ Explorer

Pour créer les files d'attente MQSeries à l'aide de WebSphere MQ Explorer

  1. Cliquez sur Démarrer, pointez sur Tous les programmes, sur IBM WebSphere MQ, puis cliquez sur WebSphere MQ Explorer.

  2. Double-cliquez sur Gestionnaires de files d’attente, puis double-cliquez sur le gestionnaire de files d’attente par défaut. Le gestionnaire de files d’attente par défaut est généralement nommé QM_<machine_name> où machine_name est le nom de votre ordinateur.

  3. Cliquez avec le bouton droit sur Files d’attente, pointez sur Nouveau, puis cliquez sur File d’attente locale.

  4. Dans la boîte de dialogue Créer une file d’attente locale , dans Nom de la filed’attente, tapez « queue1 », puis cliquez sur OK.

  5. Cliquez avec le bouton droit sur Files d’attente, cliquez sur Nouveau, puis sur File d’attente locale.

  6. Dans la boîte de dialogue Créer une file d’attente locale , dans Nom de la filed’attente, tapez « queue2 », puis cliquez sur OK.

Création de l'emplacement de réception et de la file d'attente MQSeries

Cette procédure permet de créer le port d'envoi et l'emplacement de réception pour envoyer le message à MQSeries et recevoir le message de corrélation de MQSeries. Le cas échéant, la file d'attente MQSeries est également créée lorsque vous créez l'emplacement de réception.

Pour créer l’emplacement de réception et la file d’attente MQSeries

  1. Ouvrez la console Administration BizTalk Server.

  2. Développez BizTalk Server Administration, BizTalk Group, Applications, puis l’application requise.

  3. Cliquez avec le bouton droit sur Ports de réception, pointez sur Nouveau, puis cliquez sur Port de réception unidirectionnel.

  4. Dans la boîte de dialogue Propriétés du port de réception unidirectionnel , dans la zone Nom , tapez OrderedSampleReceive , puis cliquez sur OK.

  5. Dans le volet gauche, cliquez sur l’onglet Emplacements de réception , puis sur Nouveau.

  6. Dans la boîte de dialogue Propriétés de l’emplacement de réception, dans la zone Nom , tapez « OrderedSampleReceiveLocation ».

  7. Dans la zone Type de transport , sélectionnez MQSeries.

  8. Dans la zone Gestionnaire de réception , sélectionnez BizTalkServerApplication.

  9. Dans la zone Pipeline de réception , sélectionnez Microsoft.BizTalk.DefaultPipelines.PassThruReceive.

  10. Cliquez sur Configurer.

  11. Dans la boîte de dialogue Propriétés du transport MQSeries, dans la zone Intervalle d’interrogation, tapez « 10 ».

  12. Dans la zone Définition de la file d’attente , cliquez sur le bouton points de suspension (...) .

  13. Dans la boîte de dialogue Définition de la file d’attente , dans la zone Nom du serveur , tapez le nom de votre ordinateur.

  14. Dans la zone Gestionnaire de files d’attente , sélectionnez le gestionnaire de files d’attente par défaut.

  15. Dans la zone File d’attente , tapez « queue1 », puis cliquez sur Exporter.

  16. Dans la boîte de dialogue Exporter , cliquez sur Créer une file d’attente, puis sur OK ou Terminé jusqu’à ce que vous ayez quitté toutes les boîtes de dialogue.

Création du port d'envoi et de la file d'attente MQSeries

Pour créer le port d'envoi et la file d'attente MQSeries

  1. Cliquez avec le bouton droit sur Ports d’envoi, pointez sur Nouveau, puis cliquez sur Port d’envoi unidirectionnel statique.

  2. Dans la boîte de dialogue Propriétés du port statique , dans la zone Nom , tapez « OrderedSampleSend ».

  3. Dans la zone Type de transport , sélectionnez MQSeries.

  4. Dans la zone Envoyer le pipeline , sélectionnez Microsoft.BizTalk.DefaultPipelines.PassThruTransmit.

  5. Cliquez sur Configurer.

  6. Dans la boîte de dialogue Propriétés du transport MQSeries , dans la zone Définition de file d’attente , cliquez sur le bouton de sélection (...) .

  7. Dans la boîte de dialogue Définition de la file d’attente , dans la zone Nom du serveur , tapez le nom de votre ordinateur.

  8. Dans la zone Gestionnaire de files d’attente , sélectionnez le gestionnaire de files d’attente par défaut.

  9. Dans la zone File d’attente , tapez « queue2 », puis cliquez sur Exporter.

  10. Dans la boîte de dialogue Exporter , cliquez sur Créer une file d’attente, puis sur OK ou Terminé jusqu’à ce que vous ayez quitté toutes les boîtes de dialogue.

Activation de l'emplacement de réception et démarrage du port d'envoi

  1. Dans la console Administration BizTalk Server, cliquez sur Ports de réception.

  2. Dans le volet d’informations, cliquez avec le bouton droit sur l’emplacement de réception MQIn , puis cliquez sur Activer.

  3. Dans le volet d’informations, cliquez avec le bouton droit sur le port d’envoi MQOut , puis cliquez sur Démarrer.

Pour lier et démarrer l’orchestration

  1. Dans la console Administration BizTalk Server, développez le dossier Orchestrations.

  2. Double-cliquez sur l’orchestration OrderedSampleOrchestration , puis cliquez sur Liaisons.

  3. Liez les ports d'orchestration aux ports d'envoi et aux emplacements de réception suivants :

    Port d'orchestration Port de messagerie/Emplacement de réception
    mqreceive OrderedSampleReceive
    mqsend OrderedSampleSend

  4. Cliquez sur Hôte.

  5. Dans la zone Hôte , sélectionnez BizTalkServerApplication, puis cliquez sur OK.

  6. Cliquez avec le bouton droit sur l’orchestration , puis cliquez sur Démarrer.

Exécution de l'exemple

  1. Démarrez l'orchestration.

  2. Placez les messages dans la file d'attente MQSeries dans laquelle a été configurée la lecture des messages par l'emplacement de réception.

  3. À l'aide de WebSphere MQ Explorer, affichez les messages de la file d'envoi à partir de laquelle vous avez configuré l'envoi de messages via le port d'envoi.

Voir aussi

Exemples d’adaptateurs MQSeries