Konfigurieren eines HTTP-Empfangsspeicherorts

Sie können die Adaptervariablen für den HTTP-Empfangsspeicherort programmgesteuert oder über die BizTalk Server-Verwaltungskonsole festlegen. Wenn für den Empfangsspeicherort keine Eigenschaften festgelegt sind, werden die Standardwerte des Empfangshandlers verwendet, die in der BizTalk Server-Verwaltungskonsole festgelegt sind.

Hinweis

Bevor Sie die folgenden Schritte ausführen, müssen Sie bereits einen Empfangsport hinzugefügt haben. Weitere Informationen finden Sie unter Erstellen eines Empfangsports.

Programmgesteuertes Konfigurieren eines HTTP-Empfangsspeicherorts

Der HTTP-Adapter speichert seine Konfigurationsinformationen in der BizTalk-Verwaltungsdatenbank (die auch als Konfigurationsdatenbank bezeichnet wird). Die Konfiguration wird Nachricht wird in einer benutzerdefinierten XML-Eigenschaftensammlung gespeichert.

Das BizTalk Explorer-Objektmodell macht die IReceiveLocation-Konfigurationsschnittstelle verfügbar, die über eine TransportTypeData-Lese-/Schreibeigenschaft verfügt. Diese Eigenschaft akzeptiert den Konfigurationseigenschaftenbehälter für den HTTP-Empfangsspeicherort in Form einer aus einem Name/Wert-Paar bestehenden XML-Zeichenfolge.

Das Festlegen der TransportTypeData-Eigenschaft von IReceiveLocation ist nicht erforderlich. Ist der Wert nicht festgelegt, werden die Standardwerte für die Konfiguration des HTTP-Empfangsspeicherorts verwendet. In der folgenden Tabelle sind die Standardwerte sowie die Konfigurationseigenschaften aufgelistet, die Sie im Objektmodell von BizTalk-Explorer für den HTTP-Empfangsspeicherort festlegen können.

Eigenschaftenname	type	BESCHREIBUNG	Beschränkungen	Kommentare
ResponseContentType	Zeichenfolge	Geben Sie den Typ der HTTP-Antwortnachrichten an, die der HTTP-Adapter von diesem Empfangsspeicherort an Clients zurücksendet. Diese Eigenschaft gilt nur für Empfangsspeicherorte vom Typ Anforderungsantwort und wird für unidirektionale Empfangsports ignoriert.	String Mindestlänge: 0 Maximale Länge: 256	Standardwert: Text/XML
Loopback	Boolean	Gibt an, dass die an diesem Speicherort empfangene Anforderungsnachricht an einen Sendeport weitergeleitet oder als Antwort an den Empfangsspeicherort zurückgesendet wird. Diese Eigenschaft gilt nur für Empfangsports vom Typ Anforderungsantwort. Sie wird für unidirektionale Empfangsports ignoriert.	Keine	Standardwert: FALSE
ReturnCorrelationHandle	Boolean	Gibt an, dass das bei erfolgreicher Durchführung der Übertragung das Korrelationstoken der übermittelten Nachricht, das der HTTP-Adapter sendet, in der HTTP-Antwort an den Client gesendet wird. Diese Eigenschaft gilt nur für unidirektionale Empfangsports und wird für Empfangsports vom Typ Anforderungsantwort ignoriert.	Keine	Standardwert: STIMMT
SuspendFailedRequests	Boolean	Gibt an, ob HTTP-Anforderungsfehler angehalten werden. Durch den Wert Wahr wird festgelegt, dass die fehlerhafte Anforderung angehalten und der Statuscode Akzeptiert (202) bei unidirektionalen Empfangsports bzw. der Statuscode Fehler (500) bei bidirektionalen Empfangsports an den Client gesendet wird.	Keine	Standardwert: FALSE
UseSSO	Boolean	Gibt an, ob der HTTP-Adapter ein SSO-Ticket für Nachrichten ausgibt, die an diesem Empfangsspeicherort eingehen.	Keine	Standardwert: FALSE

Die XML-Zeichenfolge zum Festlegen dieser Eigenschaften weist das folgende Format auf:

<CustomProps>  
   <UseSSO vt="11">-1</UseSSO>  
   <SuspendFailedRequests vt="11">-1</SuspendFailedRequests>  
   <ReturnCorrelationHandle vt="11">-1</ReturnCorrelationHandle>  
   <ResponseContentType vt="8">text/xml</ResponseContentType>  
   <LoopBack vt="11">-1</LoopBack>  
</CustomProps>  

Konfigurieren eines HTTP-Empfangsspeicherorts mithilfe der BizTalk Server-Verwaltungskonsole

Gehen Sie wie folgt vor, um den Empfangsspeicherort mithilfe der BizTalk Server-Verwaltungskonsole zu konfigurieren.

So konfigurieren Sie Variablen für einen HTTP-Empfangsspeicherort

1. Konfigurieren Sie IIS (Internet Information Services, Internetinformationsdienste für die Zusammenarbeit mit HTTP-Empfangsspeicherorten. Anweisungen zum Konfigurieren von IIS finden Sie unter Konfigurieren von IIS für einen HTTP-Empfangsspeicherort.

2. Erweitern Sie in der BizTalk Server Verwaltungskonsole BizTalk ServerAdministration, BizTalk-Gruppe, Anwendungen, und erweitern Sie dann die Anwendung, in der Sie einen Empfangsspeicherort erstellen möchten.

3. Klicken Sie im linken Bereich auf den Knoten Empfangsports . Klicken Sie anschließend im rechten Bereich mit der rechten Maustaste auf den Empfangsport, der einem vorhandenen Empfangsspeicherort zugeordnet ist oder den Sie einem neuen Empfangsspeicherort zuordnen möchten, und klicken Sie dann auf Eigenschaften.

4. Wählen Sie im Dialogfeld Eigenschaften des Empfangsports im linken Bereich Empfangsspeicherorte aus, und doppelklicken Sie im rechten Bereich auf einen vorhandenen Empfangsspeicherort, oder klicken Sie auf Neu , um einen neuen Empfangsspeicherort zu erstellen.

5. Wählen Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts im Abschnitt Transport neben Typ die Option HTTP aus der Dropdownliste aus, und klicken Sie dann auf Konfigurieren.

6. Gehen Sie im Dialogfeld HTTP-Transporteigenschaften wie folgt vor:

   Option	Aufgabe
   Virtuelles Verzeichnis mit ISAPI-Erweiterung	Geben Sie den Namen des virtuellen Verzeichnisses an, in dem Sie die am HTTP/HTTPS-Empfangsspeicherort eingegangenen Nachrichten bereitstellen. Der Name des virtuellen Verzeichnisses enthält den Namen der DLL-Datei des Empfangsspeicherorts und eine optionale Abfragezeichenfolge. Beispiele für die Namen virtueller Verzeichnisse: /<virtual directory>/BTSHTTPReceive.dll /<virtual directory>/BTSHTTPReceive.dll? Purchase%20Order Dieser Speicherort darf nur eine ISAPI-Erweiterung für BTSHTTPReceive.dll (einschließlich aller Unterordner) enthalten. Typ: Schnur Maximale Länge: 256 Hinweis: Der URI für einen Sendeport oder Empfangsspeicherort darf 256 Zeichen nicht überschreiten.
   Öffentliche Adresse	Gibt den vollqualifizierten URI für diesen Empfangsspeicherort an. Der Wert für diese Eigenschaft ist eine Kombination aus dem Servernamen und dem virtuellen Verzeichnis. Die BizTalk-Messaging-Engine stellt diese Adresse externen Partnern zur Verfügung. Der angegebene URI sollte die öffentliche Website-URL festlegen, die Handelspartner aufrufen, wenn sie Nachrichten an BizTalk Server senden. Diese Angabe ist optional und wird von BizTalk Server nicht verwendet. Dieser Parameter ermöglicht Administratoren, die öffentliche URL zu dokumentieren, an die der Empfangsspeicherort gebunden ist. Typ: Schnur Mindestlänge: 0 Maximale Länge: 256
   Inhaltstyp zurückgeben	Geben Sie den Inhaltstyp von HTTP-Antwortnachrichten an, die der Empfangsspeicherort an Clients zurücksendet. Diese Eigenschaft gilt nur für Empfangsspeicherorte vom Typ "Anforderungsantwort". Standardwert: text/xml Typ: Schnur Mindestlänge: 0 Maximale Länge: 256
   Loopback	Definieren Sie, dass die an diesem Speicherort empfangene Anforderungsnachricht entweder an einen Sendeport oder zurück an diesen Empfangsspeicherort weitergeleitet wird, um als Antwort gesendet zu werden. Diese Eigenschaft gilt nur für Empfangsspeicherorte vom Typ "Anforderungsantwort". Standardwert: FALSE Typ: Boolean
   Bei Erfolg Korrelationshandle zurückgeben (nur unidirektionaler Port)	Legen Sie fest, dass bei Erfolg der Empfangsspeicherort das Korrelationstoken der übermittelten Nachricht für die HTTP-Antwort an den Client sendet. Diese Eigenschaft gilt nur für unidirektionale Empfangsspeicherorte. Standardwert: STIMMT Typ: Boolean
   Einmaliges Anmelden verwenden	Geben Sie an, dass Einmaliges Anmelden für Unternehmen verwendet werden soll. Standardwert: FALSE Typ: Boolescher Hinweis: Wenn diese Option aktiviert ist, müssen Sie auch die Option Tickets aufSSO-Systemebene zulassen aktivieren. Die Option Tickets zulassen kann auf der Registerkarte Optionen des Dialogfelds SSO-Systemeigenschaften konfiguriert werden, das in der MMC-Schnittstelle für die SSO-Verwaltung verfügbar ist. Wenn diese Option aktiviert ist und die Option Tickets zulassen auf SSO-Systemebene nicht aktiviert ist, werden alle nachrichten, die von diesem Empfangsspeicherort empfangen werden, angehalten.
   Fehlerhafte Anforderungen anhalten	Geben Sie an, ob HTTP-Anforderungen angehalten werden, bei denen ein Fehler bei der Eingangsverarbeitung aufgetreten ist. Durch den Wert Falsch wird festgelegt, dass die fehlerhafte Anforderung verworfen und ein Fehlerstatuscode (401 oder 500) an den Client gesendet wird. Der Wert True gibt an, dass die fehlerhafte Anforderung angehalten und ein "Akzeptierter" status Code (200) an den Client für unidirektionale Empfangsports oder ein "Error" status Code (500) an den Client für bidirektionale Empfangsports gesendet wird. Standardwert: FALSE Typ: Boolean

7. Klicken Sie auf OK, um die Einstellungen zu speichern.

8. Geben Sie in das Dialogfeld Eigenschaften für Empfangsspeicherort entsprechende Werte ein, um die Konfiguration des Empfangsspeicherorts abzuschließen, und klicken Sie auf OK , um die Einstellungen zu speichern. Informationen zum Dialogfeld Eigenschaften für Empfangsspeicherort finden Sie unter Erstellen eines Empfangsspeicherorts.

   Während der HTTP-Client den HTTP-Speicherort aufruft, authentifiziert der HTTP-Adapter den HTTP-Client mittels anonymer, Standard-, Digest- oder integrierter Windows-Authentifizierung. Nach der Überprüfung des Benutzers wird der Benutzerkontext an den Empfangshandler übergeben.

Hinweis

IIS-Konfigurationen, die dazu führen, dass SOAP und HTTP denselben Prozess verwenden, sind ungültig. Es darf nur einen isolierten Empfänger pro Prozess geben.