Guide pratique pour convertir un document texte en XML et router vers un emplacement de fichier à l’aide d’un bordereau de routage d’itinéraire
Objectif
La section montre comment créer un pipeline qui convertira un document texte en XML, puis sélectionnera l’itinéraire approprié et acheminera le message vers un emplacement FILE.
Dans cette rubrique de procédure, vous allez effectuer les étapes suivantes :
Utilisez un pipeline pour recevoir un document de fichier plat et le convertir en XML.
Configurez le composant pipeline du sélecteur d’itinéraire pour résoudre le bordereau de routage approprié.
Créez une rampe d’accès qui utilise le pipeline personnalisé.
Testez le routage basé sur l’itinéraire d’un message de fichier plat.
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.
Avant de commencer
Effectuez les tâches suivantes avant d’effectuer les étapes décrites plus loin dans cette rubrique pratique :
Déployer l’itinéraire DataFormatTransformation .
Créez le message de test.
Les procédures suivantes décrivent comment effectuer chacune de ces opérations.
Pour déployer l’itinéraire DataFormatTransformation
Dans Visual Studio, ouvrez C :\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation\DataFormatTransformation.sln.
Dans Explorateur de solutions, dans le projet Itinerary.Library, double-cliquez sur DataFormatTransformation.itinerary pour l’ouvrir dans l’itinéraire Designer.
Dans Visual Studio, cliquez sur l’aire de conception de DataFormatTransformation.itinerary. Dans la Fenêtre Propriétés DataFormatTransformation.itinerary, configurez les propriétés suivantes :
Dans la liste déroulante État de l’itinéraire , cliquez sur Déployé.
Dans la liste déroulante Exporter de modèle , cliquez sur Exportateur d’itinéraire de base de données.
Cliquez sur le bouton de sélection (...) en regard de la propriété Itinerary Database .
Dans la boîte de dialogue Propriétés de connexion, choisissez le SQL Server qui héberge la base de données du référentiel d’itinéraires, puis spécifiez le nom de la base de données (le nom par défaut est EsbItineraryDb).
Enregistrez tous les artefacts de projet.
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.
Pour créer le pipeline de réception
Dans Visual Studio, cliquez avec le bouton droit sur DataFormatTransformation.Schemas, puis cliquez sur Propriétés. Cliquez sur Application, puis tapez GlobalBank.ESB.DataFormatTransformation.Schemas dans la zone Nom de l’assembly .
Cliquez avec le bouton droit sur DataFormatTransformation.Schemas, puis cliquez sur Propriétés. Cliquez sur Signature, puis vérifiez que la zone Signer l’assembly case activée est cochée et que l’emplacement de l’assembly pointe vers .\.. \.. \.. \.. \.. \keys\Microsoft.Practices.ESB.snk.
Cliquez avec le bouton droit sur DataFormatTransformation.Pipelines, puis cliquez sur Supprimer.
Cliquez avec le bouton droit sur DataFormatTransformation, pointez sur Ajouter, puis cliquez sur Nouveau projet. Cliquez sur Projets Biztalk, puis sur Projet Biztalk Server vide. Dans la zone Nom , tapez DataFormatTransformationReceive.Pipeline.
Cliquez avec le bouton droit sur DataFormatTransformationReceive.Pipeline, puis cliquez sur Propriétés. Cliquez sur Signature, puis vérifiez que la zone Signer l’assembly case activée est cochée et que l’emplacement de l’assembly pointe vers C :\projects\Microsoft.Practices.ESB\keys\Microsoft.Practices.ESB.snk.
Cliquez avec le bouton droit sur DataFormatTransformationReceive.Pipeline, pointez sur Ajouter, puis cliquez sur Nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément , cliquez sur Pipeline de réception dans le volet Modèles. Dans la zone Nom , tapez ItinerarySelectReceiveFF, puis cliquez sur Ajouter.
Cliquez avec le bouton droit sur Références pour le projet DataFormatTransformationReceive.Pipeline, puis cliquez sur Ajouter une référence. Cliquez sur l’onglet Projets , puis sur DataFormatTransformation.Schemas. Cliquez sur OK pour ajouter la référence.
À partir de la Boîte à outils, faites glisser un composant de pipeline désassembleur de fichiers plats vers l’étape Désassembler du pipeline.
Dans la Fenêtre Propriétés pour le désassemblement du fichier plat, cliquez sur DataModelTransformation.Schemas.NAOrderDocFF dans la liste déroulante Schéma de document.
À partir de la Boîte à outils, faites glisser un composant de pipeline sélecteur d’itinéraire ESB vers l’étape Resolve Party du pipeline.
À partir de la boîte à outils, faites glisser un composant de pipeline ESB Dispatcher vers l’étape Partie de résolution du pipeline, puis placez-le sous le composant de pipeline sélecteur d’itinéraire ESB .
Enregistrez tous les artefacts de projet.
Pour créer le message de test
Cliquez une fois dans le fichier de schéma NAOrderDocFF.xsd du projet DataFormatTransformation.Schemas. Dans le volet Propriétés de Visual Studio, modifiez les deux propriétés suivantes :
Générer le type de sortie d’instance. Cliquez sur la liste déroulante de cette propriété pour la remplacer par Native.
Nom de fichier de l’instance de sortie. Cliquez sur le bouton de sélection (...) pour cette propriété et acceptez le chemin d’accès par défaut de C :\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation. Dans la zone Nom de fichier , tapez NAOrderDocFF, puis cliquez sur Enregistrer.
Cliquez avec le bouton droit sur NAOrderDocFF.xsd sous DataFormatTransformation.Schemas, puis cliquez sur Générer une instance. À ce stade, vous devez avoir un nouveau fichier généré dans le répertoire C :\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation.
Copiez (ne déplacez pas) le fichier NAOrderDocFF.txt de C :\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation vers C :\HowTos.
Notes
Il s’agit du message que vous recevrez et convertirez au format XML. Ce document représente une version de fichier plat du document North American Order.
Étapes
Pour déployer le pipeline de réception et le schéma
Cliquez avec le bouton droit sur DataFormatTransformationReceive.Pipeline, puis cliquez sur Propriétés. Cliquez sur Déploiement, puis tapez Microsoft.Practices.ESB dans la zone Nom de l’application .
Cliquez avec le bouton droit sur le projet DataFormatTransformation.Schemas , puis cliquez sur Propriétés. Cliquez sur Déploiement, puis tapez Microsoft.Practices.ESB dans la zone Nom de l’application .
Fermez les volets Propriétés pour DataFormatTransformationReceive.Pipeline et DataFormatTransformation.Schemas.
Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet DataFormatTransformation, puis cliquez sur Déployer la solution.
Pour créer et configurer un ESB on-ramp
Cliquez sur Démarrer dans la barre des tâches, pointez sur Tous les programmes, pointez sur BizTalk Server, puis cliquez sur BizTalk Server Administration.
Dans la console d’administration BizTalk Server, développez Groupe BizTalk, Applications, puis cliquez sur Microsoft.Practices.ESB.
Cliquez avec le bouton droit sur Emplacements de réception, pointez sur Nouveau, puis cliquez sur Emplacement de réception unidirectionnel.
Dans la boîte de dialogue Sélectionner un port de réception , cliquez sur OnRamp.Itinerary, puis sur OK.
Dans la boîte de dialogue Propriétés de l’emplacement de réception, dans la zone Nom , tapez OnRamp.Itinerary.FlatFile.FILE.
Dans la liste déroulante Type , cliquez sur FICHIER, puis sur Configurer.
Dans la boîte de dialogue Propriétés du transport fichier, dans la zone Dossier de réception, tapez C :\HowTos\DropFolder.
Dans la boîte de dialogue Propriétés du transport de fichier, dans la zone Masque de fichier, tapez *.txt, puis cliquez sur OK.
Pour configurer le composant de pipeline du sélecteur d’itinéraire
Dans la boîte de dialogue Propriétés de l’emplacement de réception, cliquez sur ItinerarySelectReceiveFF dans la liste déroulante Pipeline de réception, puis cliquez sur le bouton de sélection (...).
Utilisez la boîte de dialogue Configurer le pipeline pour configurer les propriétés de composant sélecteur d’itinéraire suivantes :
Cliquez sur la propriété ItineraryFactKey , puis tapez Resolver.Itinerary.
Cliquez sur la propriété ResolverConnectionString , tapez ITINERARY :\\name=DataFormatTransformation, puis cliquez sur OK.
Cliquez sur OK pour fermer la boîte de dialogue Propriétés de l’emplacement de réception.
Dans la console d’administration BizTalk Server, cliquez avec le bouton droit sur l’emplacement de réception OnRamp.Itinerary.FlatFile.FILE, puis cliquez sur Activer.
Pour tester le routage basé sur l’itinéraire d’un message de fichier plat
Dans Windows Explorer, accédez à C :\HowTos.
Copiez (ne pas déplacer) NAOrderDocFF.txt vers C :\HowTos\DropFolder.
Accédez à C :\HowTos\Out. Vérifiez que le message DFT%MessageID%.xml a été écrit dans le répertoire.
Dans la console d’administration BizTalk Server, cliquez avec le bouton droit sur l’emplacement de réception OnRamp.Itinerary.FlatFile.FILE, puis cliquez sur Désactiver.
Une fois l’emplacement de réception OnRamp.Itinerary.FlatFile.FILE désactivé, cliquez dessus avec le bouton droit, puis cliquez sur Supprimer. Dans la boîte de dialogue Confirmer la suppression de l’emplacement de réception , cliquez sur Oui.
Ressources supplémentaires
Pour plus d'informations, consultez les rubriques connexes suivantes :