HelloWorld (exemple BizTalk Server)
L'exemple HelloWorld illustre l'utilisation des orchestrations BizTalk pour convertir un message XML (un bon de commande) en un type de message lié mais distinct (une facture).
Fonctions de l'exemple
Cet exemple configure le dossier In en tant qu’emplacement de réception. Lorsque vous placez un fichier, tel que l’exemple de fichierSamplePOInput.xml, dans ce dossier, BizTalk Server traite le message en procédant comme suit :
BizTalk Server récupère le message de bon de commande XML à partir du dossier d’emplacement de réception.
L'orchestration utilise le fichier de mappage pour créer une facture XML à partir du bon de commande XML.
BizTalk Server place le message de facture XML résultant dans le dossier De sortie de l’adaptateur d’envoi.
Comment cet exemple est conçu et pourquoi
Dans un scénario d'échange de messages intersociétés, il est souvent nécessaire de convertir les messages entrants reçus des partenaires commerciaux dans un format reconnu par les applications internes. Cet exemple utilise une forme Receive , une forme Transform et une forme Send pour obtenir ce résultat. La forme Transformer joue le rôle important dans cet exemple, car c’est là que se produit la conversion du format de message. Vous faites glisser une forme Transformer dans votre orchestration et configurez le message source, le nom de la carte et le message de destination pour celle-ci. Lors de l'exécution, le message source est mappé au message de destination à l'aide du mappage que vous avez désigné.
Pour plus d’informations sur la forme Transformer , consultez Guide pratique pour configurer la forme de transformation. Pour plus d’informations sur la création d’une carte, consultez Création de cartes à l’aide du mappeur BizTalk.
Accès à l'exemple
<Chemin d’accès> des exemples\Orchestrations\HelloWorld\
Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.
| Fichier(s) | Description |
|---|---|
| Cleanup.bat | Permet d'annuler le déploiement des assemblys et de supprimer ceux-ci du Global Assembly Cache. Supprime les ports d'envoi et de réception. Supprime les répertoires virtuels Microsoft Internet Information Services (IIS) le cas échéant. |
| HelloOrchestration.odx | Orchestration qui coordonne la conversion du bon de commande en facture. |
| HelloWorld.btproj, HelloWorld.sln | Fichiers projet et solution de l'exemple. |
| HelloWorldBinding.xml | Utilisé pour une configuration automatisée, telle que la liaison de port. |
| InvoiceSchema.xsd, POSchema.xsd | Schémas des messages de facture et de bon de commande, respectivement. |
| POToInvoice.btm | Mappage pour la conversion du bon de commande en facture. |
| SamplePOInput.xml | Exemple de fichier d'entrée. |
| Setup.bat | Utilisé pour générer et initialiser cet exemple. |
Génération et initialisation de cet exemple
Pour créer et initialiser l'exemple HelloWorld
Dans une fenêtre de commande, accédez au dossier suivant :
<Chemin d’accès> des exemples\Orchestrations\HelloWorld
Exécutez le fichier Setup.bat, qui effectue les actions suivantes :
création des dossiers d'entrée (In) et de sortie (Out) de l'exemple dans le dossier suivant :
<Chemin d’accès> des exemples\Orchestrations\HelloWorld
Compile le projet Visual Studio pour cet exemple.
Crée et lie l’emplacement de réception BizTalk Server et les ports d’envoi et de réception à l’orchestration.
Active l'emplacement de réception, et démarre le port d'envoi. Inscrit et démarre l’orchestration.
Notes
Avant d'essayer d'exécuter cet exemple, vous devez vous assurer que BizTalk Server n'a signalé aucune erreur lors du processus de création et d'initialisation. Pour ce faire, consultez les journaux des événements.
Exécution de cet exemple
Pour exécuter l'exemple HelloWorld
Collez une copie du fichier SamplePOInput.xml dans le dossier In .
Observez le fichier .xml créé dans le dossier Out . Ce fichier contient la facture XML construite à partir du fichier d’entrée SamplePOInput.xml. Le format du nom de ce fichier est <MessageID>.xml, où <MessageID> est le GUID généré pour identifier le message de manière unique.
Désinstallation de l'exemple
Pour désinstaller l'exemple HelloWorld
Dans une fenêtre de commande, accédez au dossier suivant :
<Chemin d’accès> des exemples\Orchestrations\HelloWorld\
Exécutez Cleanup.bat.