Composant Transformation XSLT (exemple BizTalk Server)
L'exemple de composant Transformation XSLT décrit l'écriture d'un composant de pipeline personnalisé permettant de transformer un message XML à l'aide de XSLT.
Fonctions de l'exemple
Cet exemple effectue la transformation selon la procédure suivante :
Un document XML est extrait d'un dossier.
Le pipeline transforme le document XML en un corps de message électronique HTML à l'aide de Transform.xsl.
Accès à l'exemple
<Samples Path>\Pipelines\XslTransformComponent\
Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.
| Fichier(s) | Description |
|---|---|
| AssemblyInfo.cs | Fichier d'assembly C#. |
| Cleanup.bat | Exemple de fichier de nettoyage. |
| Confirmation.xsd | Exemple de fichier de schéma. |
| DocInstance.xml | Exemple de fichier .xml à transformer. |
| SendHtmlMessage.btproj | Projet BizTalk. |
| Setup.bat | Fichier de commandes de configuration. |
| Xml2HtmlSendPipeline.btp | Fichier de pipeline BizTalk Server. |
| XslTransform.csproj | Projet C#. |
| XslTransformComponent.sln | Exemple de fichier de solution. |
| XslTransformComponentBinding.XML | Fichier de liaison XML. |
| XslTransformer.cs | Code source C#. |
| Transform.xsl | Fichier XSLT permettant de transformer DocInstance.xml. |
Génération et initialisation de cet exemple
La procédure suivante permet de créer et d'initialiser l'exemple de composant Transformation XSLT.
Pour créer et initialiser l'exemple
Dans une fenêtre de commande, remplacez le répertoire (cd) par le dossier suivant :
<Samples Path>\Pipelines\XslTransformComponent
Exécutez le fichier Setup.bat, qui effectue les actions suivantes :
Création des dossiers d'entrée (\In) et de sortie (\Out) utilisés dans l'exemple ;
Création d'un nouveau fichier clé ;
Création et déploiement du pipeline de composant Transformation XSLT ;
Copie le composant de pipeline généré dans le <dossier Chemin> d’installation\Composants de pipeline.
crée les ports d'envoi et de réception ;
Notes
Avant de tenter d'exécuter cet exemple, vous devez vérifier qu'aucune erreur n'a été signalée durant le processus de création et d'initialisation.
Notes
Pour annuler les modifications apportées par Setup.bat, arrêtez puis redémarrez l'instance de l'hôte à partir de la console MMC Administration de BizTalk Server. Ensuite, exécutez Cleanup.bat. Vous devez exécuter Cleanup.bat avant d'exécuter Cleanup.bat une seconde fois.
Exécution de cet exemple
La procédure suivante permet d'exécuter l'exemple de composant Transformation XSLT.
Pour exécuter l'exemple
Copiez le fichier DocInstance.xml dans le dossier \In.
Examinez les résultats dans le dossier \Out (le nom du fichier de sortie est guid.htm).
Configuration de l'exemple à l'aide de SMTP
La procédure suivante permet de configurer l'exemple de composant Transformation XSLT à des fins de compatibilité avec un serveur SMTP.
Pour configurer l'exemple à l'aide de SMTP
Reconfigurez le port d'envoi du composant Transformation XSLT de manière à ce qu'il utilise un type de transport SMTP.
Configurez le paramètre SMTP en modifiant les paramètres d'adresse (URI) de manière à ce qu'ils correspondent à votre configuration SMTP.
Exécution de l'exemple avec une sortie vers un port SMTP
La procédure suivante permet d'exécuter l'exemple de composant Transformation XSLT avec une sortie vers un port SMTP.
Pour exécuter l'exemple avec une sortie vers un port SMTP
Copiez le fichier DocInstance.xml dans le dossier \In.
Examinez les résultats dans le client de messagerie associé au destinataire configuré pour le port SMTP.