Partager via

Guide pratique pour résoudre un point de terminaison de service à l’aide d’une recherche de clé de liaison UDDI

  • Article

Objectif

Cette section montre comment utiliser esb Designer langage spécifique au domaine (DSL) pour créer un bordereau de routage basé sur un itinéraire qui utilise le programme de résolution UDDI (Universal Description, Discovery, and Integration) 3 pour localiser un point de terminaison de service à l’aide d’une recherche par clé de liaison. Dans ce scénario, le point de terminaison de service est un point de terminaison de fichier publié dans UDDI.

Dans cette rubrique de procédure, vous allez effectuer les étapes suivantes :

  • Créez un bordereau de routage d’itinéraire pour résoudre un point de terminaison de service.

  • Configurez l’itinéraire pour acheminer le message vers un point de terminaison de service à l’aide d’un programme de résolution UDDI 3.

  • Testez l’itinéraire à l’aide de l’exemple d’application Itinerary Test Client.

Prérequis

Les procédures décrites dans cette rubrique de procédure nécessitent l’achèvement des conditions préalables pour les activités de développement.

Étapes

Pour créer un modèle d’itinéraire

  1. Dans Visual Studio, ouvrez C :\HowTos\Patterns\Patterns.sln.

  2. Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet ItinéraireLibrary, pointez sur Ajouter, puis cliquez sur Nouvel itinéraire.

  3. Dans la boîte de dialogue Ajouter un nouvel élément , dans la zone Nom , tapez UDDI3BindingKeySearch, puis cliquez sur Ajouter.

Pour configurer les propriétés de l’itinéraire

  1. Dans Visual Studio, cliquez sur l’aire de conception de UDDI3BindingKeySearch.itinerary. Dans le Fenêtre Propriétés UDDI3BindingKeySearch, configurez les propriétés suivantes :

    1. Dans la liste déroulante Exporter de modèle , cliquez sur Exportateur d’itinéraire XML.

    2. Dans la section Extender Settings (Paramètres de l’extendeur ), en regard de la propriété Itinerary XML file (Fichier XML d’itinéraire ), cliquez sur le bouton de sélection (...).

    3. Dans la boîte de dialogue Sélectionner un fichier XML , tapez C :\HowTos\Itineraries\UDDI3BindingKeySearch dans la zone Nom de fichier , puis cliquez sur Enregistrer.

      Notes

      Cette étape vous permet d’exporter l’itinéraire au format XML vers un emplacement de fichier local. L’exportation d’un itinéraire vers un emplacement de fichier local, plutôt que vers la base de données d’itinéraire, permet de tester l’itinéraire à l’aide de l’application cliente de test ESB. Vous terminerez ce processus plus loin dans cette rubrique de procédures.

Pour définir la structure de l’itinéraire

  1. À partir de la boîte à outils, faites glisser un élément de modèle On-Ramp vers l’aire de conception. Dans le Fenêtre Propriétés OnRamp1, configurez les propriétés suivantes :

    1. Cliquez sur la propriété Name , puis tapez ReceiveNAOrder.

    2. Dans la liste déroulante Extendeur , cliquez sur On-Ramp ESB Extender.

    3. Dans la liste déroulante Application BizTalk , cliquez sur Microsoft.Practices.ESB.

    4. Dans la liste déroulante Port de réception, cliquez sur OnRamp.Itinerary.

  2. À partir de la Boîte à outils, faites glisser un élément de modèle service D’itinéraire vers l’aire de conception. Dans la Fenêtre Propriétés ItineraryService1, configurez les propriétés suivantes :

    1. Cliquez sur la propriété Name , puis tapez BindingKeyRoute.

    2. Dans la liste déroulante Extendeur de service d’itinéraire , cliquez sur Extendeur de messagerie.

    3. Dans la liste déroulante Conteneur , développez ReceiveNAOrder, puis cliquez sur Recevoir des gestionnaires.

    4. Dans la liste déroulante Nom du service , cliquez sur Microsoft.Practices.ESB.Services.Routing.

  3. Cliquez avec le bouton droit sur la collection Resolver de l’élément de modèle BindingKeyRoute , puis cliquez sur Ajouter un nouveau programme de résolution. Dans le Fenêtre Propriétés Resolver1, configurez les propriétés suivantes :

    1. Cliquez sur la propriété Name , puis tapez BindingKeySearch.

    2. Dans la liste déroulante Implémentation du programme de résolution, cliquez sur Extension Uddi3 Resolver.

    3. Dans la liste déroulante Moniker de résolution , cliquez sur UDDI3.

    4. Cliquez sur la propriété Clé de liaison, puis tapez uddi :esb :orderfileservicev3.1.

  4. Cliquez avec le bouton droit sur le programme de résolution BindingKeySearch , puis cliquez sur Configuration du programme de résolution de test.

    Notes

    Vérifiez la sortie affichée dans la fenêtre Sortie.

  5. Dans la boîte à outils, cliquez sur Connecteur. Faites glisser une connexion de l’élément de modèle ReceiveNAOrder vers l’élément de modèle BindingKeyRoute .

  6. À partir de la boîte à outils, faites glisser un élément de modèle Off-Ramp vers l’aire de conception, puis placez-le à droite de l’élément de modèle BindingKeyRoute . Dans le Fenêtre Propriétés OffRamp1, configurez les propriétés suivantes :

    1. Cliquez sur la propriété Name , puis tapez SendNAOrder.

    2. Dans la liste déroulante Extendeur , cliquez sur Off-Ramp ESB Extender.

    3. Dans la liste déroulante Application BizTalk , cliquez sur GlobalBank.ESB.

    4. Dans la liste déroulante Port d’envoi , cliquez sur DynamicResolutionOneWay.

  7. À partir de la boîte à outils, faites glisser un élément de modèle service D’itinéraire vers l’aire de conception, puis placez-le entre l’élément de modèle BindingKeyRoute et l’élément de modèle SendNAOrder . Dans la Fenêtre Propriétés ItineraryService1, configurez les propriétés suivantes :

    1. Cliquez sur la propriété Name , puis tapez SendPortFilter.

    2. Dans la liste déroulante Extendeur de service d’itinéraire , cliquez sur Extendeur hors rampe.

    3. Dans la liste déroulante Hors rampe , développez SendNAOrder, puis cliquez sur Envoyer des gestionnaires.

  8. Dans la boîte à outils, cliquez sur Connecteur. Faites glisser une connexion de l’élément de modèle BindingKeyRoute vers l’élément de modèle SendPortFilter .

  9. Dans la boîte à outils, cliquez sur Connecteur. Faites glisser une connexion de l’élément de modèle SendPortFilter vers l’élément de modèle SendNAOrder .

Pour exporter le modèle à utiliser avec le client de test d’itinéraire

  1. Dans Visual Studio, cliquez avec le bouton droit sur l’aire de conception de l’itinéraire UDDI3BindingKeySearch , puis cliquez sur Exporter le modèle.

    Notes

    La version XML de l’itinéraire s’ouvre dans Visual Studio.

  2. Enregistrez tous les artefacts de projet.

  3. Dans Windows Explorer, accédez à C :\HowTos\Itinéraires et notez la création de votre xml d’itinéraire (UDDI3BindingKeySearch.xml).

Pour tester l’itinéraire

  1. Ouvrez l’exemple d’application Itinerary Test Client à l’aide du raccourci créé pendant les prérequis pour les activités de développement (C:\HowTos\ESB.Itinerary.Test.exe - Raccourci).

  2. Dans le client de test d’itinéraire, désactivez la zone Utiliser le service WCF case activée, puis cliquez sur Itinéraire de chargement.

  3. Dans la boîte de dialogue Ouvrir le fichier d’itinéraire, accédez à C :\HowTos\Tineraryes. Sélectionnez UDDI3BindingKeySearch.xml, puis cliquez sur Ouvrir pour charger l’itinéraire.

  4. Cliquez sur OK pour effacer le message Itinéraire chargé avec succès .

  5. Dans le client de test d’itinéraire, cliquez sur le bouton de sélection (...) en regard de la zone Charger le message .

  6. Dans la boîte de dialogue Sélectionner un document XML à charger , accédez à C :\HowTos. Sélectionnez NAOrderDoc.xml, puis cliquez sur Ouvrir pour charger le message de test.

  7. Cliquez sur le bouton Envoyer la demande . Une fois le test terminé, cliquez sur OK pour ignorer la confirmation qui s’affiche.

  8. Dans Windows Explorer, accédez à C :\Projects\Microsoft.Practices.ESB\Source\Samples\DynamicResolution\Test\Filedrop\Out. Vérifiez que le message %MessageID%.xml a été écrit dans le répertoire.

Ressources supplémentaires

Pour plus d'informations, consultez les rubriques connexes suivantes :