Partager via

Guide pratique pour transformer un message et router le message résultant vers un emplacement de fichier à l’aide d’un bordereau de routage d’itinéraire

  • Article

Objectif

Cette section montre comment utiliser esb Designer langage spécifique au domaine (DSL) pour créer un itinéraire qui implémente la transformation de message en appelant une carte BizTalk, puis il achemine les messages à l’aide de l’adaptateur Microsoft BizTalk ESB Toolkit FILE.

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

  • Créez un bordereau de routage d’itinéraire avec un service de transformation d’itinéraire qui implémente une carte BizTalk.

  • Configurez l’itinéraire pour acheminer le message transformé vers un emplacement de fichier.

  • 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 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 , cliquez sur ItinéraireDsl dans le volet Modèles.

  4. Dans la zone Nom , tapez DataModelTransformation, 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 DataModelTransformation.itinerary. Dans la Fenêtre Propriétés DataModelTransformation, 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\DataModelTransformation, 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 Extension de service ESB sur ramp.

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

    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 ReceiveNAOrder, puis cliquez sur Recevoir des gestionnaires.

    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 MapNAOrderToCNOrder , 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 StaticallySpecifyTheMap.

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

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

  5. À 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 MapNAOrderToCNOrder . 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 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.

  6. À 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 MapNAOrderToCNOrder et l’élément de modèle SendCNOrder . 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 Off-Ramp , développez SendCNOrder, puis cliquez sur Envoyer des gestionnaires.

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

    2. Dans la liste déroulante Nom du transport , cliquez sur FICHIER.

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

      Notes

      Un service d’itinéraire est associé à chaque piste hors piste ; La combinaison des propriétés du service D’itinéraire et des propriétés de la rampe d’arrêt définit l’abonnement du port d’envoi dynamique.

  8. Dans la boîte à outils, cliquez sur Connecteur. Faites glisser une connexion de l’élément de modèle MapNAOrderToCNOrder 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 SendCNOrder .

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 DataModelTransformation , 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 (DataModelTransformation.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 DataModelTransformation.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 :\HowTos\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 :

  1. Guide pratique pour fractionner un échange et router les messages résultants vers plusieurs emplacements de fichier à l’aide d’itinéraires distincts

  2. Activités de développement

  3. Modèles de transformation des messages