HelloWorld (BizTalk Server-Beispiel)
Anhand des HelloWorld-Beispiels wird gezeigt, wie BizTalk-Orchestrierungen verwendet werden, um eine XML-Nachricht (eine Bestellung) in eine zugehörige Nachricht umzuwandeln, die aber einen eigenen Typ hat (eine Rechnung).
Ziel des Beispiels
In diesem Beispiel wird der Ordner In als Empfangsspeicherort konfiguriert. Wenn Sie eine Datei, z. B. die Beispieldatei SamplePOInput.xml, in diesem Ordner ablegen, verarbeitet BizTalk Server die Nachricht mithilfe der folgenden Schritte:
BizTalk Server ruft die XML-Bestellnachricht aus dem Ordner "Empfangsspeicherort" ab.
Die Orchestrierung verwendet die Zuordnungsdatei, um aus der XML-Bestellung eine XML-Rechnung zu erstellen.
BizTalk Server platziert die resultierende XML-Rechnungsnachricht im Ordner "Out" des Sendeadapters.
Wie dieses Beispiel entworfen wird und warum
In einem Szenario mit Nachrichtenaustausch zwischen Unternehmen müssen eingehende Nachrichten, die von Handelspartnern empfangen wurden, häufig in ein Format umgewandelt werden, das interne Anwendungen erkennen können. In diesem Beispiel werden eine Empfangsform , eine Transformationsform und eine Senden-Form verwendet, um dieses Ergebnis zu erzielen. Das Transformations-Shape spielt in diesem Beispiel die wichtige Rolle, da dort die Konvertierung des Nachrichtenformats erfolgt. Sie ziehen ein Transformations-Shape in Ihre Orchestrierung und konfigurieren die Quellnachricht, den Kartennamen und die Zielnachricht dafür. Zur Laufzeit wird die Quellnachricht über die von Ihnen vorgesehene Zuordnung der Zielnachricht zugeordnet.
Weitere Informationen zum Transformieren-Shape finden Sie unter Konfigurieren der Transformationsform. Weitere Informationen zum Erstellen einer Karte finden Sie unter Erstellen von Karten mithilfe von BizTalk Mapper.
Speicherort dieses Beispiels
<Beispielpfad>\Orchestrierungen\HelloWorld\
In der folgenden Tabelle werden die Dateien in diesem Beispiel samt Zweck beschrieben.
| Datei(en) | BESCHREIBUNG |
|---|---|
| Cleanup.bat | Wird verwendet, um die Bereitstellung von Assemblys aufzuheben und die Assemblys aus dem globalen Assemblycache zu entfernen. Entfernt Sende- und Empfangsports. Entfernt nach Bedarf virtuelle Verzeichnisse von Microsoft Internetinformationsdienste (IIS). |
| HelloOrchestration.odx | Orchestrierung, die die Konvertierung einer Bestellung in eine Rechnung koordiniert. |
| HelloWorld.btproj, HelloWorld.sln | Projekt- und Projektmappendateien für dieses Beispiel. |
| HelloWorldBinding.xml | Wird für das automatisierte Setup verwendet, z. B. Portbindung. |
| InvoiceSchema.xsd, POSchema.xsd | Schemas für die Rechnungs- bzw. die Bestellungsnachrichten. |
| POToInvoice.btm | Zuordnung für das Konvertieren einer Bestellung in eine Rechnung. |
| SamplePOInput.xml | Beispieleingabedatei |
| Setup.bat | Dient zum Erstellen und Initialisieren dieses Beispiels. |
Erstellen und Initialisieren dieses Beispiels
So erstellen und initialisieren Sie das HelloWorld-Beispiel
Navigieren Sie in einem Befehlsfenster zum folgenden Ordner:
<Beispielpfad>\Orchestrierungen\HelloWorld
Führen Sie die Datei "Setup.bat" aus, von der folgende Aktionen ausgeführt werden:
Erstellen des Eingabe- (In) und des Ausgabeordners (Out) für dieses Beispiel im folgenden Ordner:
<Beispielpfad>\Orchestrierungen\HelloWorld
Kompiliert das Visual Studio-Projekt für dieses Beispiel.
Erstellt und bindet den BizTalk Server Empfangsspeicherort sowie die Sende- und Empfangsports an die Orchestrierung.
Aktiviert den Empfangsspeicherort und startet den Sendeport. Führt die Orchestrierung ein und startet sie.
Hinweis
Sie sollten sicherstellen, dass von BizTalk Server während des Erstellungs- und Initialisierungsprozesses keine Fehler gemeldet wurden, bevor Sie dieses Beispiel ausführen. Sie können dies sicherstellen, indem Sie die Ereignisprotokolle anzeigen.
Ausführen dieses Beispiels
So führen Sie das HelloWorld-Beispiel aus
Fügen Sie eine Kopie der Datei SamplePOInput.xml in den Ordner In ein.
Beobachten Sie die .xml Datei, die im Ordner Out erstellt wurde. Diese Datei enthält die XML-Rechnung, die aus der Eingabedatei SamplePOInput.xml erstellt wurde. Das Format des Namens dieser Datei ist <MessageID>.xml, wobei <MessageID> die GUID ist, die generiert wird, um die Nachricht eindeutig zu identifizieren.
Deinstallieren dieses Beispiels
So deinstallieren Sie das HelloWorld-Beispiel
Navigieren Sie in einem Befehlsfenster zum folgenden Ordner:
<Beispielpfad>\Orchestrierungen\HelloWorld\
Führen Sie die Datei Cleanup.bat aus.