Partager via

Guide pratique pour publier un service sur le Registre UDDI 3.0

  • Article

Objectif

Cette section montre comment utiliser le site du service UDDI pour publier un point de terminaison de service Web qui peut être résolu à partir d’un itinéraire dans le but de router un message ESB. Vous allez dupliquer le service PurchaseOrderSubmitOrderService existant actuellement publié dans le Registre.

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

  • Publiez un service dans le registre UDDI (Universal Description, Discovery, and Integration) 3 à l’aide de l’outil UDDI Publisher.

  • Testez la publication du service à l’aide d’un bordereau de routage d’itinéraire qui résout le point de terminaison de service à l’aide d’un programme de résolution UDDI3.

Prérequis

Les procédures de cette rubrique pratique nécessitent l’achèvement des prérequis pour les activités de développement et l’exécution de l’outil de publication UDDI (vous pouvez l’installer dans %ESB Install Folder%\Bin\Microsoft.Practices.ESB.UDDIPublisher.exe).

Étapes

Pour créer newPOService dans le registre UDDI

  1. Dans Internet Explorer, accédez au site du service UDDI (par défaut, l’URL esthttp://localhost/uddi).

  2. Dans la page uddi Services , cliquez sur Publier.

  3. Dans le volet Publier, cliquez avec le bouton droit sur Microsoft.Practices.ESB, puis cliquez sur Ajouter un service.

  4. Dans la page suivante, sélectionnez Spécifier une clé à utiliser, puis cliquez sur Continuer.

  5. Dans la page suivante, cliquez sur la partition de clé esb . Dans la zone Suffixe de clé, tapez newposervice, puis cliquez sur Continuer.

  6. Dans la page suivante, en regard de (Nouveau nom du service), cliquez sur Modifier. Nommez le service NewPOService, puis cliquez sur Mettre à jour.

  7. Cliquez sur Ajouter une description, tapez une description pour le service (par exemple, Exemple de service), puis cliquez sur Mettre à jour.

Pour ajouter une liaison pour newPOService

  1. Cliquez sur l’onglet Liaisons , puis sur Ajouter une liaison.

  2. Sélectionnez Spécifier une clé à utiliser, puis cliquez sur Continuer.

  3. Dans la page suivante, cliquez sur la partition de clé esb . Dans la zone Suffixe de clé, tapez newposervicebinding, puis cliquez sur Continuer.

  4. Sous Point d’accès, cliquez sur Modifier, puis effectuez les opérations suivantes :

    1. Dans la zone Point d’accès , tapez http://localhost/ESB.CanadianServices/SubmitPOService.asmx.

    2. Dans la liste déroulante Utiliser le type , cliquez sur point de terminaison, puis sur Mettre à jour.

Pour configurer les informations de instance de liaison

  1. Cliquez sur l’onglet Informations sur l’instance, puis sur Ajouter des informations sur l’instance.

  2. Dans la zone Rechercher des noms tModel contenant , tapez %esb%, puis cliquez sur Rechercher.

  3. Recherchez et cliquez sur le tModel pour le type de transport.

    Notes

    Pour effectuer les étapes restantes de cette procédure, vous devrez peut-être passer de la page 1 à la page 2.

  4. Dans la section Descriptions , cliquez sur Ajouter une description.

  5. Dans la zone Description , tapez Type de transport pour l’utilisation de l’itinéraire ESB, puis cliquez sur Mettre à jour.

  6. Cliquez sur l’onglet Détails de l’instance, puis sur Modifier.

  7. Dans la zone Paramètres d’instance , tapez WCF-BasicHttp, puis cliquez sur Mettre à jour.

  8. Dans la section Descriptions , cliquez sur Ajouter une description.

  9. Dans la zone Description , tapez Transport HTTP de base WCF, puis cliquez sur Mettre à jour.

  10. Dans le volet Publier, sous NewPOService, cliquez sur http://localhost/esb.canadianservices/submitposervice.asmx.

  11. Sous l’onglet Informations sur l’instance , cliquez sur Ajouter des informations sur l’instance.

  12. En suivant les étapes décrites précédemment, ajoutez les informations instance suivantes, en fonction des valeurs indiquées dans le tableau suivant.

    élément tModel Description Paramètre Description des paramètres
    microsoft-com :esb :runtimeresolution :messageexchangepattern Modèle d’échange de messages Bidirectionnel Opération bidirectionnelle
    microsoft-com :esb :runtimeresolution :cachetimeout Délai d’expiration du cache -1 Actuellement désactivé
    microsoft-com :esb :runtimeresolution :jaxrpcresponse JaxRpcResponse false
    microsoft-com :esb :runtimeresolution :action Action de service submitOrder Spécifie la méthode de service à appeler
    microsoft-com :esb :runtimeresolution :targetnamespace Espace de noms de service http://globalbank.esb.dynamicresolution.com/canadianservices Espace de noms cible

Pour configurer la catégorisation de liaison

  1. Dans le volet Publier, sous NewPOService, cliquez sur http://localhost/esb.canadianservices/submitposervice.asmx.

  2. Sous l’onglet Catégories , cliquez sur Ajouter une catégorie personnalisée.

  3. Dans la zone De recherche , tapez %esb%, puis cliquez sur Rechercher.

  4. Recherchez et cliquez sur le tModel microsoft-com :esb :runtimeresolution :biztalkapplication .

  5. Dans la zone Nom de la clé , tapez Application BizTalk.

  6. Dans la zone Valeur de clé , tapez Microsoft.Practices.ESB, puis cliquez sur Ajouter une catégorie.

  7. En suivant les étapes décrites précédemment, ajoutez les catégories personnalisées suivantes, en fonction des valeurs indiquées dans le tableau suivant.

    élément tModel Nom de clé Valeur de la clé
    microsoft-com :esb :runtimeresolution :portname Nom du port NewPOService
    microsoft-com :esb :runtimeresolution :transporttype Type de transport WCF-BasicHttp

Pour localiser le service dans le registre UDDI

  1. Dans Internet Explorer, dans la page uddi Services, cliquez sur Rechercher.

  2. Cliquez sur l’onglet Services.

  3. Dans la zone Nom du service , tapez %PO%, puis cliquez sur Rechercher.

  4. Dans le volet Recherche , sous l’onglet Résultats , cliquez sur NouveauSERVICEPO.

    Notes

    Cela confirme que le service a été correctement publié dans le Registre.

Pour créer un modèle d’itinéraire pour tester la publication du service UDDI

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

  2. Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet ItineraryLibrary, 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 NewBindingKeySearch, 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 NewBindingKeySearch.itinerary. Dans le Fenêtre Propriétés NewBindingKeySearch, configurez les propriétés suivantes :

    1. Dans la liste déroulante Réponse à la demande , cliquez sur True.

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

    3. Dans la section Paramètres de l’extenseur , en regard de la propriété fichier XML D’itinéraire , cliquez sur le bouton de sélection (...).

    4. Dans la boîte de dialogue Sélectionner un fichier XML , tapez C :\HowTos\Itineraries\NewBindingKeySearch 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. En exportant 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 de client de test ESB. Vous effectuerez ce processus plus loin dans cette rubrique pratique.

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 Extender , 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.Response.

  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 le Fenêtre Propriétés ItineraryService1, configurez les propriétés suivantes :

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

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

    3. Dans la liste déroulante Conteneur , développez ReceiveNAOrder, puis cliquez sur Gestionnaires de réception.

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

  3. Cliquez avec le bouton droit sur la collection Resolver de l’élément de modèle TransformNAOrder , 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 NAOrder_to_CNOrder.

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

    3. Dans la liste déroulante Type de transformation, cliquez sur GlobalBank.ESB.DynamicResolution.Transforms.SubmitOrderRequestNA_To_SubmitOrderRequestCN.

  4. 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 TransformNAOrder .

  5. À partir de la boîte à outils, faites glisser un élément de modèle service d’itinéraire vers l’aire de conception. Dans le 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 Extension de service d’itinéraire , cliquez sur Extension de messagerie.

    3. Dans la liste déroulante Conteneur , développez ReceiveNAOrder, puis cliquez sur Gestionnaires de réception.

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

  6. 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 :newposervicebinding. Pour rechercher la valeur de la clé, cliquez sur le http://localhost/ESB.CanadianServices/SubmitPOService.asmx service dans UDDI, puis cliquez sur Plus de détails.

  7. 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.

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

  9. À 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 SendCNOrder.

    2. Dans la liste déroulante Extender , cliquez sur Extension ESB hors rampe.

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

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

  10. À 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 SendCNOrder . Dans le 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 Extender de service d’itinéraire , cliquez sur Extender hors rampe.

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

  11. 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 .

  12. 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 NewBindingKeySearch , 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 code XML d’itinéraire (NewBindingKeySearch.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, dans le groupe Options du service web, désactivez la zone Utiliser le service WCF, puis sélectionnez la zone Case activée service bidirectionnel.

  3. Cliquez sur le bouton Charger l’itinéraire .

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

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

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

  7. 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.

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

  9. Vérifiez que le message de réponse correct s’affiche dans la zone de texte Résultat du client de test Itineray.

Ressources supplémentaires

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