HTTPSolicitResponse
Im HTTPSolicitResponse-Beispiel wird veranschaulicht, wie Sie eine Microsoft BizTalk Server-Orchestrierung erstellen, die eine ASP.NET Anwendung zum Verarbeiten von Orchestrierungsdaten nutzt. In diesem Beispiel verwendet die Orchestrierung einen Port vom Typ „Anforderungsantwort“, um eine Nachricht an die ASP.NET-Anwendung zu senden und die Antwort dann abzurufen. Die Integration zwischen der BizTalk Server-Orchestrierung und der ASP.NET-Anwendung erfolgt mithilfe des HTTP-Adapters. Weitere Informationen finden Sie unter HTTP-Adapter.
Ziel des Beispiels
Dieses Beispiel besteht aus einer BizTalk Server-Orchestrierung, die eine Anforderung empfängt, die zwei Zahlen enthält, die miteinander multipliziert werden sollen. Sie erfüllt diese Anforderung mithilfe der folgenden Schritte:
Die BizTalk Server-Orchestrierung ruft eine XML-Eingabedatei aus einem bestimmten Ordner ab.
Die Orchestrierung verwendet eine HTTP-Anforderung, um das XML aus der Datei an eine ASP.NET-Multiplikationsanwendung weiterzuleiten.
Die ASP.NET-Multiplikationsanwendung antwortet auf die HTTP-Anforderung, indem Sie die Multiplikation ausführt und das Ergebnis als XML in der HTTP-Antwort zurückgibt.
Die Orchestrierung empfängt das Ergebnis als XML in einer HTTP-Antwort und schreibt dieses Ergebnis in eine XML-Datei in einem bestimmten Ordner.
Speicherort dieses Beispiels
<Beispielpfad>\AdaptersUsage\HTTPSolicitResponse
In der folgenden Tabelle werden die Dateien in diesem Beispiel samt Zweck beschrieben.
| Datei(en) | BESCHREIBUNG |
|---|---|
| Cleanup.bat | Nimmt die Bereitstellung der Assemblys zurück und entfernt sie aus dem globalen Assemblycache (GAC), entfernt Sende- und Empfangsport und entfernt die virtuellen IIS-Verzeichnisse (Microsoft Internet Information Services, Internetinformationsdienste) nach Bedarf. |
| HttpSolicitResponse.btproj, HttpSolicitResponse.sln | Stellt Projekt- und Quelldateien für das BizTalk-Projekt zur Verfügung, das die Orchestrierung enthält, die die ASP.NET-Multiplikationsanwendung, die zugehörigen Schemas usw. verwendet. |
| HttpSolicitResponseBinding.xml | Stellt eine automatisierte Einrichtung bereit, z. B. portbindung. |
| MultiplyRequest.xsd, MultiplyResponse.xsd | Stellt Schemas für die Multiplikationsanforderung und XML-Antwortnachrichten bereit. |
| MultiplyTwoIntegers.odx | Stellt eine BizTalk Server-Orchestrierung zur Verfügung, die eine XML-Datei empfängt, die einen Multiplikationsvorgang anfordert, die Anforderung an die ASP.NET-Multiplikationsanwendung weiterleitet und ihre Antwort in eine Datei schreibt. |
| request_in.xml | Beispieleingabedatei |
| Setup.bat | Erstellt und initialisiert dieses Beispiel. |
| Im Ordner \Multiplier: Multiplier.aspx, Multiplier.aspx.cs, Multiplier.sln |
Enthält Dateien, die die ASP.NET-Anwendung bilden, die den Multiplikationsdienst implementiert. Dazu gehören Projekt- und Projektmappendateien, ASPX-Dateien, Microsoft Visual C# NET-Quelldateien usw. |
Erstellen und Initialisieren des Beispiels
Mithilfe des folgenden Verfahrens können Sie das Beispiel „HTTPSolicitResponse“ erstellen und initialisieren.
Hinweis
Dieses Beispiel funktioniert nicht, wenn der Name des Empfangsspeicherorts Großbuchstaben enthält.
So erstellen und initialisieren Sie das Beispiel
Navigieren Sie in einem Befehlsfenster zum folgenden Ordner:
<Beispielpfad>\AdaptersUsage\HTTPSolicitResponse
Führen Sie die Datei "Setup.bat" aus, von der folgende Aktionen ausgeführt werden:
Erstellen der Eingabe- und Ausgabeordner für dieses Beispiel:
<Beispielpfad>\AdaptersUsage\HttpSolicitResponse\HttpSolicitResponseInput
<Beispielpfad>\AdaptersUsage\HttpSolicitResponse\HttpSolicitResponseOutput
Kompilieren und Konfigurieren der ASP.NET-Multiplikationsanwendung, die von diesem Beispiel verwendet wird.
Hinweis
Legen Sie beim Erstellen eines Anwendungspools im IIS-Manager die Version defaultAppPool .NET Framework auf .NET Framework v4.0 fest.
Kompiliert und stellt die in diesem Beispiel verwendete orchestrierte BizTalk Server bereit.
Erstellt und bindet die erforderlichen BizTalk Server Empfangsspeicherort und -ports.
Hinweis
In diesem Beispiel werden beim Erstellen und Binden der Ports die folgenden Warnungen angezeigt:
Hinweis
Warning: Receive handler not specified for receive location "HttpSolicitResponseReceiveLocation"; updating with first receive handler with matching transport type.Hinweis
Warning: Host not specified for orchestration "Microsoft.Samples.BizTalk.HttpSolicitResponse.MultiplyTwoIntegers"; updating with first available host.Aktiviert den Empfangsspeicherort und startet den Sendeport.
Hinweis
Die Orchestrierung verwendet in diesem Beispiel einen bidirektionalen Port für die HTTP-Interaktion mit der ASP.NET-Anwendung.
Hinweis
Sie sollten sicherstellen, dass von BizTalk während des Erstellungs- und Initialisierungsprozesses keine Fehler gemeldet wurden, bevor Sie dieses Beispiel ausführen.
Hinweis
Wenn Sie die Projekte in diesem Beispiel öffnen und erstellen möchten, ohne die Datei Setup.bat auszuführen, müssen Sie zunächst ein Schlüsselpaar für starke Namen mit dem entsprechenden .NET Framework-Hilfsprogramm (sn.exe) erstellen. Verwenden Sie dieses Schlüsselpaar zum Signieren der resultierenden Assemblys.
Hinweis
Wenn Sie von "Setup.bat" vorgenommene Änderungen rückgängig machen möchten, führen Sie "Cleanup.bat" aus. "Cleanup.bat" müssen Sie ausführen, bevor "Setup.bat" ein zweites Mal ausgeführt wird.
Ausführen des Beispiels
Gehen Sie zum Ausführen des Beispiels „HTTPSolicitResponse“ wie folgt vor:
So führen Sie das Beispiel aus
Fügen Sie eine Kopie der Datei request_in.xml in den Ordner HttpSolicitResponseInput ein.
Beachten Sie die im Ordner HttpSolicitResponseOutput erstellte XML-Datei. Der Name dieser XML-Datei basiert auf der GUID der Nachrichten-ID. Diese Datei enthält das als XML-Code formatierte Ergebnis des Multiplikationsvorgangs.
Hinweis
Sie können die Operandenwerte in der Eingabedatei ändern, um einen anderen Multiplikationsvorgang auszuführen.
Kommentare
Sie können dieses Beispiel so anpassen, dass die Kommunikation mit einem anderen externen System erfolgt, das eine HTTP-Schnittstelle bereitstellt.
Die Dateien MultiplyRequest.xsd und MultiplyResponse.xsd sind die XML-Schemas, die das Format der Eingabe- und Ausgabedaten für die ASP.NET-Multiplikationsanwendung definieren. Die Orchestrierung verwendet diese Dateien, um die Anforderungs- und Antwortnachrichtentypen zu definieren.