HTTPRequestResponse
Das HTTPRequestResponse-Beispiel veranschaulicht die Verwendung des IsAPI-Filters (Microsoft BizTalk Server Internet Server Application Programming Interface), um einer ASP.NET Anwendung die Kommunikation mit einer BizTalk Server-Orchestrierung zu ermöglichen.
Ziel des Beispiels
In diesem Beispiel sendet die ASP.NET-Anwendung eine Anforderung an den BizTalk Server ISAPI-Filter. Die Orchestrierung verarbeitet dann diese Nachricht und gibt sie mit einer synchronen Antwort an die ASP.NET-Anwendung zurück. Sie erreichen die Integration zwischen der BizTalk Server-Orchestrierung und der ASP.NET-Anwendung, indem Sie den BizTalk Server ISAPI-Filter verwenden.
In diesem Beispiel BizTalk Server und eine ASP.NET Application Exchange Purchase Order (PO) und Auftragsbestätigungsmeldungen mithilfe der folgenden Schritte:
Eine ASP.NET-Anwendung sendet mithilfe einer HTTP-Anforderung eine XML-Po-Nachricht an BizTalk Server.
BizTalk Server empfängt die XML PO-Nachricht und erstellt eine XML PO-Bestätigungsmeldung und sendet diese Nachricht dann an die ASP.NET-Anwendung in der HTTP-Antwort zurück.
Die ASP.NET-Anwendung empfängt die XML-Bestellbestätigungsantwort und aktualisiert das Webformular mit den aus der Antwort extrahierten Statusinformationen.
Speicherort dieses Beispiels
<Samples Path>\AdaptersUsage\HTTPRequestResponse\
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. |
| HTTPRequestResponse.btproj, HTTPRequestResponse.sln | Stellt Projekt- und Quelldateien für das BizTalk-Projekt bereit, das die HTTP-Anforderung empfängt, verarbeitet die Bestellungsnachricht und gibt die Antwort aus. |
| HTTPRequestResponseBinding.xml | Stellt automatisiertes Setup bereit, z. B. Portbindung. |
| POAck.xsd, POSchema.xsd | Stellt Schemas für die Bestellungsbestätigung bzw. die XML-Bestellungsdateien bereit. |
| POReceiveOrchestration.odx | Stellt eine BizTalk Server Orchestrierung bereit, die den Bestellschein empfängt, verarbeitet und die Auftragsbestätigung ausgibt. |
| Setup.bat | Erstellt und initialisiert dieses Beispiel. |
| Im Ordner \RequestResponse: AssemblyInfo.cs, default.aspx, default.aspx.cs, Global.asax, Global.asax.cs, RequestResponse.csproj, RequestResponse.csproj.webinfo, RequestResponse.sln, Web.config |
Enthält Dateien, die die ASP.NET-Anwendung bilden, die bei diesem Beispiel als Treiber dient. Dazu gehören Projekt- und Projektmappendateien, ASPX-Dateien, Microsoft Visual C# NET-Quelldateien usw. |
Erstellen und Initialisieren dieses Beispiels
Mithilfe des folgenden Verfahrens können Sie das Beispiel „HTTPRequestResponse“ erstellen und initialisieren.
So erstellen und initialisieren Sie dieses Beispiel
Navigieren Sie in einem Befehlsfenster zum folgenden Ordner:
<Beispielpfad>\AdaptersUsage\HTTPRequestResponse
Führen Sie die Datei "Setup.bat" aus, von der folgende Aktionen ausgeführt werden:
Kompilieren und Konfigurieren der ASP.NET-Anwendung für dieses Beispiel.
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.
Kompiliert und stellt die Microsoft Visual Studio-Projekte für dieses Beispiel bereit.
Erstellt und bindet die erforderlichen BizTalk Server Ports.
Startet die BizTalk Server-Orchestrierung.
Wichtig
Sie müssen den Beispielcode zum Implementieren der Webanwendung (Default.aspx.cs) an die jeweilige Umgebung anpassen:
< http:// Servername>/<virtuelles Verzeichnis>/BTSHTTPReceive.dll wobei
<servername>der Name des Webservers, auf den Sie posten, und<virtuelles Verzeichnis>das virtuelle Verzeichnis ist, in dem sich diese Datei befindet.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. Außerdem müssen Sie die Verweise auf default.aspx.resx und Global.asax.resx manuell aus der Datei RequestResponse.csproj entfernen, bevor Sie dieses Projekt zu erstellen versuchen.
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.
Hinweis
Sie müssen IIS für die Verwendung des HTTP-Empfangsadapters konfigurieren und aktivieren. Weitere Informationen finden Sie unter Konfigurieren von IIS für einen HTTP-Empfangsspeicherort.
Das virtuelle Verzeichnis für dieses Beispiel wird mithilfe der Datei setup.bat für die Ausführung in dem IIS-Anwendungspool konfiguriert, der der Standardwebsite zugeordnet ist. Um das virtuelle Verzeichnis für dieses Beispiel so zu konfigurieren, dass es im Kontext eines Benutzers in bizTalk Isolated Host Users und IIS_IURS Benutzergruppen ausgeführt wird, sollten Sie das virtuelle Verzeichnis so konfigurieren, dass es in einem neuen IIS-Anwendungspool ausgeführt wird. Führen Sie die folgenden Schritte aus, um das virtuelle Verzeichnis für die Ausführung in einem neuen IIS-Anwendungspool zu konfigurieren:
Hinweis
Wenn Sie bereits einen neuen Anwendungspool für ein anderes SDK-Beispiel erstellt haben, können Sie direkt mit dem letzten Schritt fortfahren.
Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Verwaltung, und klicken Sie dann auf Internetinformationsdienste-Manager.
Navigieren Sie im Internetinformationsdienste-Manager (IIS) zum Ordner Anwendungspools .
Klicken Sie mit der rechten Maustaste auf den Ordner Anwendungspools , und klicken Sie dann auf Neu, Anwendungspool...
Geben Sie einen Namen für die Anwendungspool-ID ein: z. B. BizTalkSDKSamples, überprüfen Sie, ob die Option Standardeinstellungen für neuen Anwendungspool verwenden ausgewählt ist, und klicken Sie auf OK , um den neuen Anwendungspool zu erstellen.
Klicken Sie mit der rechten Maustaste auf den neuen Anwendungspool, und klicken Sie dann auf Eigenschaften.
Klicken Sie im Dialogfeld Eigenschaften auf die Registerkarte Identität , und ändern Sie die Identität, unter der dieser Anwendungspool ausgeführt wird, in einen Benutzer, der Mitglied der BizTalk Isolated Host Users-Benutzergruppe ist. Dieser Benutzer sollte auch Mitglied der lokalen benutzergruppe IIS_IURS sein.
Konfigurieren Sie das virtuelle Verzeichnis für dieses SDK-Beispiel zur Ausführung unter dem neuen Anwendungspool. Die Einstellung Anwendungspool ist auf der Registerkarte Virtuelles Verzeichnis des Dialogfelds Eigenschaften des virtuellen Verzeichnisses verfügbar. Das für dieses Beispiel erstellte virtuelle Verzeichnis lautet HttpRequestResponseSample.
Ausführen dieses Beispiels
Gehen Sie zum Ausführen des Beispiels „HTTPRequestResponse“ wie folgt vor:
So führen Sie dieses Beispiel aus
Navigieren Sie in Internet Explorer zuhttp://localhost/RequestResponse/.
Füllen Sie die erforderlichen Felder im Webformular aus, und klicken Sie dann auf Bestellung aufgeben , um Ihre Bestellung zu übermitteln.
Sehen Sie sich den Status der Bestellung an, wenn das Webformular nach dem Empfang einer Antwort aktualisiert wird.
Kommentare
Die in diesem Beispiel verwendete BTSHTTPReceiveISAPI-Erweiterung ist so konfiguriert, dass sie auf einer Standardinstallation auf einem einzelnen Computer funktioniert. Informationen zum Erweitern dieses Beispiels für zusätzliche Konfigurationen finden Sie unter HTTP-Adapter.
Sie können dieses Beispiel auf Anwendungen erweitern, die zum Übermitteln von Daten an BizTalk Server über ein Webformular oder über HTTP im Allgemeinen erforderlich sind. Durch Erweitern des ASP.NET Anwendungsteils dieses Beispiels können Sie weitere Informationen abfragen und andere Vorverarbeitungen durchführen, bevor Sie die Daten an BizTalk Server übermitteln.
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für