Procédure pas à pas : création d'une application BizTalk qui utilise l'adaptateur MQSeries

  • Article

Cette section vous guide tout au long de la création d’une application Microsoft BizTalk Server simple qui utilise l’adaptateur MQSeries.

Notes

Cette application part du principe que vous avez installé le composant serveur IBM WebSphere MQ pour les plateformes Windows sur le même ordinateur que BizTalk Server. Elle suppose également que vous n'avez encore créé aucun port d'envoi ni emplacement de réception. Si vous avez des ports d'envoi ou emplacements de réception existants, remplacez par les noms appropriés lorsque vous avancez dans la procédure.

Il s'agit d'une application de routage simple basé sur le contenu utilisant uniquement un emplacement de réception et un port d'envoi. L'emplacement de réception lit à partir d'une file d'attente IBM WebSphere MQ. Le port d'envoi prend le message à l'emplacement de réception et l'envoie à une file d'attente IBM WebSphere MQ différente.

Pour créer l'application, vous devez créer les files d'attente IBM WebSphere MQ, configurer l'emplacement de réception et le port d'envoi de BizTalk Server, démarrer le port d'envoi et activer l'emplacement de réception, puis placer un message de test dans la file d'attente.

Si vous disposez des autorisations nécessaires pour installer IBM WebSphere MQ, vous pouvez créer les files d'attente IBM WebSphere MQ à 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 des composants client IBM WebSphere MQ Explorer pour les plateformes Windows. Pour créer les files d'attente à l'aide du composant logiciel enfichable IBM WebSphere MQ Explorer, procédez comme suit :

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

Procédez comme suit pour créer les files d'attente IBM WebSphere MQ à l'aide d'IBM WebSphere MQ Explorer :

  1. Cliquez sur Démarrer, pointez sur Programmes, pointez 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 file d’attente, tapez BTStoMQS, puis cliquez sur OK.

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

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

    Les étapes suivantes permettent de créer l'emplacement de réception et le port d'envoi, de démarrer le port d'envoi et d'activer l'emplacement de réception. Elles permettent également de créer les files d'attente IBM WebSphere MQ.

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

Procédez comme suit pour créer l'emplacement de réception et la file d'attente MQSeries :

  1. Dans la console Administration BizTalk Server, développez BizTalk Server Administration, Groupe BizTalk, Applications, puis développez l’application par défaut (Application BizTalk 1 par défaut).

  2. Cliquez avec le bouton droit sur le nœud Ports de réception , cliquez sur Nouveau, puis sélectionnez Port unidirectionnel.

  3. Dans la boîte de dialogue Propriétés du port de réception, dans la zone Nom , tapez MQStoBTS.

  4. Dans le volet gauche, cliquez sur Emplacements de réception, puis dans le volet droit, cliquez sur Nouveau.

  5. Dans la boîte de dialogue Propriétés de l’emplacement de réception, dans la zone Nom , tapez MQStoBTS.

  6. Sélectionnez MQSeries dans la liste déroulante en regard de l’option Type .

  7. Dans la section Transport , cliquez sur Configurer.

  8. Dans la boîte de dialogue Propriétés du transport MQSeries , dans la zone Intervalle d’interrogation , tapez 1.

  9. Dans la zone Définition de la file d’attente , cliquez sur le bouton de sélection (...).

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

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

  12. Dans la zone File d’attente , tapez MQStoBTS, puis cliquez sur Exporter.

  13. Dans la boîte de dialogue Exporter, cliquez sur Créer une file d’attente, puis sur OK et à nouveau sur OK pour revenir à la boîte de dialogue Propriétés de l’emplacement de réception.

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

  15. Dans la zone Pipeline de réception , sélectionnez PassThruReceive.

  16. Cliquez sur OK pour appliquer les Modifications.

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

Procédez comme suit pour créer le port d'envoi et la file d'attente MQSeries :

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

  2. Dans la boîte de dialogue Propriétés du port d’envoi, dans la zone Nom , tapez BTStoMQS.

  3. Sélectionnez MQSeries dans la liste déroulante en regard de l’option Type .

  4. Dans la section Transport , cliquez sur Configurer.

  5. 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 (...).

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

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

  8. Dans la zone File d’attente , tapez BTStoMQS, puis cliquez sur Exporter.

  9. Dans la boîte de dialogue Exporter , cliquez sur Créer une file d’attente, puis sur OK et sur OK à nouveau pour revenir à la boîte de dialogue Propriétés du port d’envoi.

  10. Dans la zone Envoyer le pipeline , sélectionnez PassThruTransmit.

  11. Cliquez pour sélectionner Filtres dans le volet gauche, puis configurez les options de filtre dans le volet droit.

  12. Dans la liste déroulante Propriété , sélectionnez BTS. ReceivePortName.

  13. Dans la zone Valeur , tapez MQStoBTS.

  14. Cliquez sur OK pour appliquer les Modifications.

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

Procédez comme suit pour activer l'emplacement de réception et démarrer le port d'envoi :

  1. Cliquez avec le bouton droit sur l’emplacement de réception MQStoBTS , puis cliquez sur Activer.

  2. Cliquez avec le bouton droit sur le port d’envoi BTStoMQS , puis cliquez sur Démarrer.

    L'étape suivante permet de tester l'application en envoyant un message de test à la file d'attente de réception.

Pour tester l'application

Procédez comme suit pour tester l'application :

  1. Cliquez sur Démarrer, pointez sur Programmes, pointez sur IBM WebSphere MQ, puis cliquez sur WebSphere MQ Explorer.

  2. Cliquez avec le bouton droit sur MQStoBTS, puis cliquez sur Placer un message de test.

  3. Dans la zone Données du message, tapez un message de test. Cliquez sur OK.

    Après avoir entré les données, la profondeur actuelle de la file d’attente MQStoBTS est une (1). Lorsque l’application traite le message, le nombre revient à zéro (0) et la profondeur actuelle pour BTStoMQS devient un (1). Vous pouvez également afficher le contenu du message.

Pour afficher le message

Procédez comme suit pour afficher le message :

  1. Double-cliquez sur la file d’attente BTStoMQS .

  2. Double-cliquez sur le message, puis sélectionnez la feuille de données . Vous pouvez afficher le texte du message dans la zone Données du message .

  3. Cliquez sur OK.

Voir aussi

Présentation de l’adaptateur MQSeries
Architecture de l’adaptateur MQSeries