Partager via

Guide pratique pour router un même message vers plusieurs destinataires à l’aide d’un bordereau de routage d’itinéraire

  • Article

Objectif

Cette section montre comment utiliser le langage Designer spécifique au domaine (DSL) pour créer un itinéraire qui achemine un message vers trois destinataires distincts à l’aide d’un programme de résolution statique et de l’adaptateur file BizTalk Server.

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

  • Créez un itinéraire avec trois résolveurs statiques pour acheminer les messages vers plusieurs destinataires.

  • 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 DSL d’itinéraire ESB

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

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

  3. Dans la boîte de dialogue Ajouter un nouvel élément , cliquez sur ItinéraireDsl dans le volet Modèles.

  4. Dans la zone Nom , tapez RecipientList, 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 RecipientList.itinerary. Dans le Fenêtre Propriétés RecipientList, 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 Paramètres de l’extendeur , en regard de la propriété fichier XML D’itinéraire , cliquez sur le bouton de sélection (...).

    3. Dans la boîte de dialogue Sélectionner un fichier XML , dans la zone Nom de fichier , tapez C :\HowTos\Itineraries\RecipientList, 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 Extendeur à rampe.

    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, puis placez-le à droite de l’élément de modèle On-Ramp . Dans la Fenêtre Propriétés ItineraryService1, configurez les propriétés suivantes :

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

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

      Notes

      Cette propriété définit que le processus aura lieu dans un pipeline (messagerie). Sinon, si le processus a lieu dans une orchestration, définissez la propriété Itinerary Service Extender sur Orchestration Extender.

    3. Dans la liste déroulante Conteneur , développez ReceiveNaOrderDoc, 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 RouteToThreeRecipients , 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 FirstResolver.

    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 Nom du transport , cliquez sur FICHIER.

    4. Cliquez sur la propriété Emplacement de transport , puis tapez C :\HowTos\Out\First%MessageID%.xml.

      Notes

      Vous avez ajouté le premier des trois résolveurs pour ce service d’itinéraire. Vous allez maintenant ajouter deux autres résolveurs pour acheminer le message vers d’autres destinataires.

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

    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 Nom du transport , cliquez sur FICHIER.

    4. Cliquez sur la propriété Emplacement de transport , puis tapez C :\HowTos\Out\Second%MessageID%.xml.

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

    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 Nom du transport , cliquez sur FICHIER.

    4. Cliquez sur la propriété Emplacement de transport , puis tapez C :\HowTos\Out\Third%MessageID%.xml.

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

  7. À 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 RouteToThreeRecipients . Dans le Fenêtre Propriétés OffRamp1, configurez les propriétés suivantes :

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

    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.

  8. À 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 RouteToThreeRecipients et l’élément de modèle SendThreeMessages . 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 SendThreeMessages, puis cliquez sur Envoyer des gestionnaires.

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

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

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 RecipientList , 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\Tineraryes, puis notez la création de votre fichier XML d’itinéraire (RecipientList.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 RecipientList.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 :\Patterns. 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 :\HowTos\Out\. Vérifiez que les messages suivants ont été écrits dans le répertoire :

    • First%MessageID%.xml

    • Second%MessageID%.xml

    • Third%MessageID%.xml

Ressources supplémentaires

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