MQSSendPipelineComponent (exemple BizTalk Server)
Cet exemple montre comment écrire un composant de pipeline capable de lire un ensemble de valeurs de propriétés MQSeries à partir d'un fichier XML et de les appliquer à un message.
Fonctions de l'exemple
Cet exemple est composé de deux projets Visual Studio, un projet de composant de pipeline et un projet de pipeline qui utilise le composant de pipeline.
Accès à l'exemple
<SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent\SetMQSeriesHeaderPropertyComponent
<SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent\SetMQSeriesHeaderPropertyPipeline
Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.
| File | Description |
|---|---|
| SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent.sln, SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent.csproj |
Fichiers projet et solution du composant de pipeline. |
| SetMQSeriesHeaderPropertyComponent\CSetMQSeriesHeaderPropertyComponent.cs | Fichier source Visual C#® du composant de pipeline. |
| SetMQSeriesHeaderPropertyComponent\SetMQSMQMDHdrProps.xml | Propriétés MQSeries lues et utilisées par le composant de pipeline. |
| SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.btproj, SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.sln |
Fichiers projet et solution du pipeline BizTalk. |
| SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.snk | Fichier de clé de nom fort du projet de pipeline BizTalk. |
| SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.btp | Pipeline BizTalk Server. |
Comment utiliser cet exemple
Pour créer l'application, procédez comme suit :
Créez les dossiers pour l'application.
Modifiez et compilez le projet Visual Studio pour le composant de pipeline.
Copiez l'assembly compilé et le fichier d'en-tête dans les dossiers appropriés.
Modifiez le projet Visual Studio pour le pipeline BizTalk Server.
Compilez et déployez le projet de pipeline BizTalk Server.
Configurez un emplacement de réception BizTalk Server.
Créez une file d'attente MQSeries.
Configurez un port d'envoi.
Activez l'emplacement de réception et démarrez le port d'envoi.
Création des dossiers pour l'application
Cette procédure permet de créer les dossiers appropriés pour l'application.
Pour créer les dossiers pour l'application
Créez un dossier nommé temp sur votre lecteur C :\ s’il n’existe pas déjà.
Créez un dossier sous le répertoire C :\temp nommé Pickup3.
Modification et compilation du projet pour le composant de pipeline
Cette procédure modifie et compile le projet Visual Studio pour le composant de pipeline.
Pour modifier et compiler le projet pour le composant de pipeline
Double-cliquez sur le fichier solution SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent.sln pour ouvrir la solution dans Visual Studio.
Double-cliquez sur le fichier de classe CSetMQSeriesHeaderPropertyComponent.cs pour ouvrir le fichier de classe dans Visual Studio.
Recherchez la variable samplesDir, vérifiez que cette variable est définie sur l’emplacement C :\temp.
Cliquez avec le bouton droit sur la solution dans le Explorateur de solutions, puis cliquez sur Générer. Le projet est compilé dans une dll située dans le répertoire SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent\bin\Debug\ .
Copie de l'assembly et du fichier d'en-tête dans les dossiers appropriés
Cette procédure permet de copier l'assembly compilé et le fichier d'en-tête dans les dossiers appropriés.
Pour copier l'assembly compilé et le fichier d'en-tête dans les dossiers appropriés
Copiez le SetMQSeriesHeaderPropertyComponent.dll d’assembly compilé dans le dossier des composants de pipeline BizTalk. L’emplacement par défaut du dossier des composants de pipeline BizTalk est \Program Files (x86)\Microsoft BizTalk Server <VERSION>Pipeline Components.
Copiez le fichier de propriétés MQHeader SetMQSMQMDHdrProps.xml dans le répertoire C :\temp .
Modification du projet pour le pipeline BizTalk Server
Cette procédure modifie le projet Visual Studio pour le pipeline BizTalk Server.
Pour modifier le projet pour le pipeline BizTalk Server
Dans Visual Studio, ouvrez la solution en double-cliquant sur le fichier solution SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.sln.
Créez un fichier de clé de nom fort pour le projet. Pour cela, procédez comme suit :
Ouvrez une invite de commandes Visual Studio.
Remplacez les répertoires <par SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent.
Tapez la commande suivante :
sn -k MQSSendPipelineComponent.snkAppuyez sur Entrée. Le fichier de clé sera ainsi créé.
Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet, puis cliquez sur Propriétés pour lancer project Designer pour le projet (dans la fenêtre centrale).
Dans le Designer projet, cliquez sur l’onglet Signature.
Dans le volet droit, sélectionnez l’option Signer l’assembly ..
Cliquez sur la liste déroulante pour l’option Choisir un fichier de clé de nom fort , puis cliquez sur Parcourir.
Accédez à <SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent\MQSSendPipelineComponent.snk, cliquez sur Ouvrir.
Le composant de pipeline que vous avez créé précédemment est déjà ajouté à la phase Préassemb de ce projet de pipeline. Si ce composant n'était pas déjà ajouté, vous devriez procéder comme suit :
Dans l’IDE Visual Studio, cliquez sur l’onglet Boîte à outils sur le côté gauche.
Cliquez avec le bouton droit sur la boîte à outils, puis cliquez sur Choisir des éléments.
Dans la boîte de dialogue Choisir des éléments de boîte à outils , cliquez sur l’onglet Composants de pipeline BizTalk , sélectionnez le composant Composant personnalisé pour définir les propriétés d’en-tête MQseries, puis cliquez sur OK.
Faites glisser le composant personnalisé pour définir le composant Propriétés d’en-tête MQseriesvers l’étape Préassembage de ce pipeline.
Compilation et déploiement du projet de pipeline
Cette procédure compile et déploie le projet de pipeline BizTalk Server.
Pour compiler et déployer le projet de pipeline
Dans la fenêtre Explorateur de solutions, cliquez avec le bouton droit sur la solution, puis cliquez sur Déployer la solution. La solution est alors générée et l'assembly est déployé dans la base de données de gestion BizTalk.
Vérifiez que l'assembly a été déployé dans la base de données de gestion BizTalk :
Ouvrez la console Administration de BizTalk.
Cliquez pour développer BizTalk Group [<servername> :<management database>], puis cliquez pour développer le dossier Assemblys .
L’assembly de pipeline déployé doit être visible sous le dossier Assemblys .
Création de l'emplacement de réception
Cette procédure crée un emplacement de réception BizTalk Server.
Pour créer l'emplacement de réception
Dans la console d’administration BizTalk Server, cliquez avec le bouton droit sur Ports de réception, pointez sur Nouveau, puis cliquez sur Port de réception unidirectionnel.
Dans la boîte de dialogue Propriétés du port de réception unidirectionnel , dans la zone Nom , tapez « MQReply », puis cliquez sur OK.
Dans le volet gauche, cliquez sur l’onglet Emplacements de réception , puis sur Nouveau.
Dans la boîte de dialogue Propriétés de l’emplacement de réception, dans le champ Nom , tapez « ReceiveFile ».
Dans la zone Type de transport , sélectionnez FICHIER.
Dans le champ Gestionnaire de réception , sélectionnez BizTalkServerApplication.
Dans le champ Pipeline de réception , sélectionnez Microsoft.BizTalk.DefaultPipelines.PassThruReceive.
Dans le champ Dossier de réception , tapez « C :\temp\Pickup3 ».
Dans le champ Masque de fichier, tapez « *.* ».
Cliquez sur OK, puis sur OK à nouveau pour quitter la boîte de dialogue Propriétés de l’emplacement de réception.
Création d'une file d'attente MQSeries à l'aide de MQSeries Explorer
Si vous disposez des autorisations requises pour l’installation de MQSeries Server pour Windows, vous pouvez créer la file d’attente MQSeries via les boîtes de dialogue de l’adaptateur et ignorer cette procédure suivante.
Sinon, vous pouvez utiliser la procédure suivante pour créer les files d'attente à l'aide d'IBM WebSphere MQ Explorer.
Pour créer une file d'attente MQSeries à l'aide de MQSeries Explorer
Cliquez sur Démarrer, pointez sur Programmes, pointez sur IBM WebSphere MQ, puis cliquez sur WebSphere MQ Explorer.
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.
Cliquez avec le bouton droit sur Files d’attente, pointez sur Nouveau, puis cliquez sur File d’attente locale.
Dans la boîte de dialogue Créer une file d’attente locale , dans Nom de la file d’attente, tapez SETHEADER, puis cliquez sur OK.
Création du port d'envoi et de la file d'attente MQSeries
Cette procédure permet de créer le port d'envoi pour le message sortant. Le cas échéant, la file d'attente MQSeries est également créée lorsque vous créez le port d'envoi.
Pour créer le port d'envoi et la file d'attente MQSeries
Cliquez avec le bouton droit sur Ports d’envoi, pointez sur Nouveau, puis cliquez sur Port d’envoi unidirectionnel statique.
Dans la boîte de dialogue Propriétés du port d’envoi, dans la zone Nom , tapez « MQSolicitResponse ».
Dans la zone Type de transport , sélectionnez MQSeries.
Dans la zone Envoyer le pipeline , sélectionnez SetMQSeriesHeaderPropertyPipeline.SetMQSeriesHeadersSendPipeline.
Dans Filtres, ajoutez une nouvelle entrée avec les paires nom/valeur suivantes :
Définissez Propriété sur « BTS. ReceivePortName ».
Définissez Operator sur « == ».
Définissez Value sur « ReceiveFile ».
Notes
Le port d'envoi sera ainsi configuré pour s'abonner aux messages qui arrivent sur le port de réception ReceiveFile.
Cliquez sur Transport.
Dans le champ Adresse (URI), cliquez sur le bouton de sélection (...) .
Dans la boîte de dialogue Propriétés du transport MQSeries , dans le champ Définition de file d’attente , cliquez sur le bouton de sélection (...)
Dans la boîte de dialogue Définition de file d’attente , dans le champ Nom du serveur , tapez le nom de votre ordinateur.
Dans le champ Gestionnaire de files d’attente , sélectionnez le gestionnaire de files d’attente par défaut.
Dans le champ File d’attente, tapez « SETHEADER », puis cliquez sur Exporter.
Dans la boîte de dialogue Exporter , cliquez sur Créer une file d’attente, puis sur OK ou Sur 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
Cette procédure permet d'activer l'emplacement de réception et de démarrer le port d'envoi.
Activation de l'emplacement de réception et démarrage du port d'envoi
Dans la console Administration BizTalk Server, cliquez sur Ports de réception.
Dans le volet d’informations, cliquez avec le bouton droit sur l’emplacement de réception MQIn , puis cliquez sur Activer.
Dans le volet d’informations, cliquez avec le bouton droit sur le port d’envoi SetMQHeader , puis cliquez sur Démarrer.
Test de l’application
Cette procédure permet de tester l'application.
Pour tester l'application
Placez un fichier dans le dossier C :\Temp\Pickup3 .
Lancez WebSphere MQ Explorer et double-cliquez sur la file d'attente SETHEADER pour examiner le ou les messages dans la file d'attente SETHEADER.
Pour afficher toutes les propriétés de contexte des messages dans la file d'attente SETHEADER, procédez comme suit :
Double-cliquez sur la file d’attente SETHEADER pour afficher la boîte de dialogue Explorateur de messages.
Dans la boîte de dialogue Explorateur de messages, cliquez sur Colonnes pour afficher la boîte de dialogue Afficher/Masquer les colonnes pour les messages .
Sous Colonnes disponibles, double-cliquez sur chaque entrée pour la rendre visible dans la boîte de dialogue Explorateur de messages, puis cliquez sur OK.
Les propriétés de contexte de message pour chaque message doivent être visibles dans la boîte de dialogue Explorateur de messages.