XSLT-Transformationskomponente (BizTalk Server-Beispiel)
Das Beispiel „XSLT-Transformationskomponente“ zeigt, wie eine benutzerdefinierte Pipelinekomponente zum Transformieren einer XML-Nachricht mithilfe von XSLT erstellt wird.
Ziel des Beispiels
Das Beispiel führt die Transformation anhand der folgenden Schritte aus:
Ein XML-Dokument wird aus einem Ordner abgerufen.
Die Pipeline transformiert das XML-Dokument mithilfe von Transform.xsl in den HTML-Nachrichtentext einer E-Mail-Nachricht.
Speicherort dieses Beispiels
<Beispielpfad>\Pipelines\XslTransformComponent\
In der folgenden Tabelle werden die Dateien in diesem Beispiel samt Zweck beschrieben.
| Datei(en) | BESCHREIBUNG |
|---|---|
| AssemblyInfo.cs | C#-Assemblydatei |
| Cleanup.bat | Beispielbereinigungsdatei |
| Confirmation.xsd | Beispielschemadatei |
| DocInstance.xml | Zu transformierende XML-Beispieldatei. |
| SendHtmlMessage.btproj | Das BizTalk-Projekt. |
| Setup.bat | Die Konfigurationsbatchdatei. |
| Xml2HtmlSendPipeline.btp | Die BizTalk Server-Pipelinedatei. |
| XslTransform.csproj | Das C#-Projekt. |
| XslTransformComponent.sln | Die Projektmappen-Beispieldatei. |
| XslTransformComponentBinding.XML | Die XML-Bindungsdatei. |
| XslTransformer.cs | Der C#-Quellcode. |
| Transform.xsl | Die XSLT-Datei, die zum Transformieren von DocInstance.xml verwendet wird. |
Erstellen und Initialisieren dieses Beispiels
Gehen Sie zum Erstellen und Initialisieren des Beispiels für die XSLT-Transformationskomponente wie folgt vor.
So erstellen und initialisieren Sie dieses Beispiel
Ändern Sie in einem Befehlsfenster das Verzeichnis (cd) in den folgenden Ordner:
<Beispielpfad>\Pipelines\XslTransformComponent
Führen Sie die Datei "Setup.bat" aus, von der folgende Aktionen ausgeführt werden:
Erstellen der Eingabeordner (In) und der Ausgabeordner (Out) für dieses Beispiel.
Erstellen einer neuen Schlüsseldatei.
Erstellen und Bereitstellen der XSLT-Transformationskomponente.
Kopiert die erstellte Pipelinekomponente in den <Ordner Installationspfad>\Pipelinekomponenten.
Erstellen der Sende- und Empfangsports.
Hinweis
Sie sollten sicherstellen, dass während des Erstellungs- und Initialisierungsprozesses keine Fehler gemeldet wurden, bevor Sie dieses Beispiel ausführen.
Hinweis
Damit die durch Setup.bat vorgenommenen Änderungen rückgängig gemacht werden, müssen Sie zuerst die Hostinstanz über das MMC-Snap-In BizTalk Server-Verwaltungskonsole beenden und dann neu starten. Führen Sie als Nächstes Cleanup.bat aus. "Cleanup.bat" müssen Sie ausführen, bevor "Setup.bat" ein zweites Mal ausgeführt wird.
Ausführen dieses Beispiels
Gehen Sie zum Ausführen des Beispiels für die XSLT-Transformationskomponente wie folgt vor.
So führen Sie dieses Beispiel aus
Kopieren Sie DocInstance.xml in den Ordner \In.
Untersuchen Sie die Ergebnisse im Ordner \Out (der Ausgabedateiname lautet guid.htm).
Konfigurieren dieses Beispiels mithilfe von SMTP
Gehen Sie zum Konfigurieren des Beispiels für die XSLT-Transformationskomponente für die Zusammenarbeit mit einem SMTP-Server wie folgt vor.
So konfigurieren Sie dieses Beispiel mithilfe von SMTP
Konfigurieren Sie den Sendeport der XSLT-Transformationskomponente so neu, dass ein SMTP-Transporttyp verwendet wird.
Konfigurieren Sie die SMTP-Einstellungen, indem Sie die Adressparameter (URI) so ändern, dass sie mit Ihrer SMTP-Konfiguration übereinstimmen.
Ausführen dieses Beispiels mit Ausgabe an einen SMTP-Port
Gehen Sie zum Ausführen des Beispiels für die XSLT-Transformationskomponente mit Ausgabe an einen SMTP-Port wie folgt vor.
So führen Sie dieses Beispiels mit Ausgabe an einen SMTP-Port aus
Kopieren Sie DocInstance.xml in den Ordner \In.
Untersuchen Sie die Ergebnisse im E-Mail-Client für den Empfänger, für den SMTP konfiguriert ist.