HTTP-Adapterkonfigurationseigenschaften

In der folgenden Tabelle sind die Konfigurationseigenschaften aufgeführt, die Sie für einen HTTP-Adapter-Empfangsspeicherort festlegen können:

Eigenschaftsname Typ Beschreibung Einschränkungen Kommentare
ReturnCorrelationHandle VT_BOOL Geben Sie an, dass der Empfangsspeicherort das Korrelationstoken der gesendeten Nachricht in der HTTP-Antwort an den Client sendet. Diese Eigenschaft ist nur für einseitige Empfangsorte gültig.

Gültige Werte sind:

- -1 (wahr)
- 0 (false)
Nichts
ResponseContentType VT_BSTR Geben Sie den Inhaltstyp von HTTP-Antwortnachrichten an, die der Empfangsspeicherort an Clients zurücksendet. Diese Eigenschaft ist nur für Anforderungs-Antwort-Empfangsorte gültig.

Mindestlänge: 0

Maximale Länge: 256
Der Standardwert ist text/xml.
SuspendFailedRequests VT_BOOL Geben Sie an, ob HTTP-Anforderungen angehalten werden sollen, die bei der eingehenden Verarbeitung fehlschlagen. Gültige Werte sind:

- -1 (wahr)
- 0 (false)
Ein Wert von 0 (false) gibt an, die fehlgeschlagene Anforderung zu verwerfen und einen Fehlerstatuscode (401 oder 500) an den Client zu senden.

Ein Wert von -1 (true) gibt an, dass die fehlgeschlagene Anforderung angehalten und ein Statuscode "Akzeptiert" (200) an den Client gesendet wird, um Ports auf eine Weise zu empfangen, oder einen Fehlerstatuscode (500) an den Client für zwei Wege empfangende Ports.

Der Standardwert ist 0 (false).
UseSSO VT_BOOL Geben Sie an, dass enterprise Single Sign-On verwendet wird. Gültige Werte sind:

- -1 (wahr)
- 0 (false)
Der Standardwert ist 0 (false).
Loopback VT_BOOL Geben Sie an, dass die empfangene Anforderungsnachricht an diesen Speicherort entweder an einen Sendeport oder zurück an diesen Empfangsspeicherort weitergeleitet wird, der als Antwort gesendet werden soll. Diese Eigenschaft ist nur für Anforderungs-Antwort-Empfangsorte gültig.

Gültige Werte sind:

- -1 (wahr)
- 0 (false)
Der Standardwert ist 0 (false).

Der folgende Code zeigt das Format der XML-Zeichenfolge, die Sie zum Festlegen der Eigenschaften verwenden:

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

In der folgenden Tabelle sind die Konfigurationseigenschaften aufgeführt, die Sie für einen HTTP-Adapter-Sendeport festlegen können:

Eigenschaftsname Typ Beschreibung Einschränkungen Kommentare
ProxyPort VT_I4 Geben Sie den Proxyserverport für diesen Sendeport an. Gültige Werte liegen zwischen 0 und 65535. Diese Eigenschaft erfordert keinen Wert, wenn UseProxy auf 0 (false) festgelegt ist.

Der Standardwert ist 80.
RequestTimeout VT_I4 Geben Sie das Timeout in Sekunden für die HTTP/HTTPS-Übertragung an. Gültige Werte liegen zwischen 0 und MAX_LONG. Wenn der HTTP-Adapter die Antwort nicht innerhalb dieses Zeitraums empfängt, protokolliert der Dienst den Fehler und sendet die Nachricht basierend auf der Wiederholungsinfrastruktur erneut.

Bei Festlegung auf 0 berechnet das BizTalk Messaging-Modul das Timeout basierend auf der Anforderungsnachrichtgröße. Wenn Sie keinen Wert angeben, wird der Wert für den Handler verwendet.
Zertifikat VT_BSTR Geben Sie den Fingerabdruck des Clientzertifikats an, das zum Herstellen einer SSL-Verbindung (Secure Sockets Layer) verwendet werden soll. Mindestlänge: 0

Maximale Länge: 59
Der Standardwert ist leer.
AuthenticationScheme VT_BSTR Geben Sie den Typ der Authentifizierung an, die mit dem Zielserver verwendet werden soll. Gültige Werte sind:

-Anonym
-Basic
-Digest
-Kerberos
Der Standardwert ist "Anonym".
Nutzername VT_BSTR Geben Sie den Benutzernamen an, der für die Authentifizierung mit dem Zielserver verwendet werden soll. Diese Eigenschaft erfordert einen Wert, wenn eine AuthenticationScheme von Basic oder Digest verwendet wird, und enterprise Single Sign-On nicht verwendet wird.

Mindestlänge: 0

Maximale Länge: 256
Nichts
EnableChunkedEncoding VT_BOOL Geben Sie an, dass die blockierte Codierung verwendet werden soll. Blockierte Codierung ist implizit deaktiviert, wenn der HTTP-Sendehandler für die Verwendung des Proxys konfiguriert ist.

Gültige Werte sind:

- -1 (wahr)
- 0 (false)
Wenn diese Option aktiviert ist, verwendet der HTTP-Adapter die HTTP-Blockcodierung mit maximaler Blockgröße von 8 KB.

Der Standardwert ist 0 (false).
UseProxy VT_BOOL Geben Sie an, ob der HTTP-Sendehandler einen Proxyserver verwendet. Gültige Werte sind:

- -1 (wahr)
- 0 (false)
Der Standardwert ist 0 (false).
ProxyName VT_BSTR Geben Sie die Proxyserveradresse für diesen Sendeport an. Mindestlänge: 0

Maximale Länge: 256
Diese Eigenschaft erfordert keinen Wert, wenn UseProxy auf 0 (false) festgelegt ist.
UseSSO VT_BOOL Geben Sie an, ob single Sign-On zum Abrufen von Clientanmeldeinformationen für die Authentifizierung mit dem Zielserver verwendet werden soll. Gültige Werte sind:

- -1 (wahr)
- 0 (false)
Der Standardwert ist 0 (false).
Passwort VT_NULL Geben Sie das Kennwort an, das für die Authentifizierung mit dem Zielserver verwendet werden soll. Diese Eigenschaft erfordert einen Wert, wenn eine AuthenticationScheme von Basic oder Digest verwendet wird, und enterprise Single Sign-On nicht verwendet wird.

Dieser Wert wird beim Exportieren einer Bindungsdatei immer auf NULL festgelegt. Dieses Feld muss manuell mit dem Kennwort aufgefüllt werden, bevor die Bindungsdatei in die BizTalk Server-Zielkonfiguration importiert wird.

Mindestlänge: 0

Maximale Länge: 256
Legen Sie den Typ für diese Eigenschaft auf VT_BSTR (vt="8") fest, bevor Sie die Bindungsdatei importieren, wenn Sie einen Wert für dieses Feld angeben.
MaxRedirects VT_I4 Geben Sie die maximal zulässigen Umleitungen für die gesendete Nachricht an. Gültige Werte liegen zwischen 0 und 10. Der Standardwert ist 5.
Inhaltstyp VT_BSTR Geben Sie den Inhaltstyp der Anforderungsnachrichten an. Mindestlänge: 0

Maximale Länge: 256
Wenn dieser Wert nicht festgelegt ist, wird der Wert für den Handler verwendet.
ProxyPassword VT_NULL Geben Sie das Benutzerkennwort für die Authentifizierung mit dem Proxyserver an. Dieser Wert wird beim Exportieren einer Bindungsdatei immer auf NULL festgelegt. Dieses Feld muss manuell mit dem Kennwort aufgefüllt werden, bevor die Bindungsdatei in die BizTalk Server-Zielkonfiguration importiert wird.

Mindestlänge: 0

Maximale Länge: 256
Diese Eigenschaft erfordert keinen Wert, wenn UseProxy auf 0 (false) festgelegt ist.
ProxyUsername VT_BSTR Geben Sie den Benutzernamen für die Authentifizierung mit dem Proxyserver an. Mindestlänge: 0

Maximale Länge: 256
Diese Eigenschaft erfordert keinen Wert, wenn UseProxy auf 0 (false) festgelegt ist.
UseHandlerSetting VT_BOOL Geben Sie an, dass die Konfiguration des Sendeports die für den HTTP-Sendehandler angegebenen Proxyeinstellungen verwenden muss. Gültige Werte sind:

- -1 (wahr)
- 0 (false)
Der Standardwert ist -1 (true).

Der folgende Code zeigt das Format der XML-Zeichenfolge, die Sie zum Festlegen der Eigenschaften verwenden:

<CustomProps>  
<ProxyPort vt="3">80</ProxyPort>  
<RequestTimeout vt="3">60</RequestTimeout>  
<Certificate vt="8">A7 6D F9 06 5E FC 97 66 75 59 B5 D6 67 0C 84 DC 64 F5 BF B9</Certificate>  
<AuthenticationScheme vt="8">Basic</AuthenticationScheme>  
<Username vt="8">authenticateduser</Username>  
<EnableChunkedEncoding vt="11">-1</EnableChunkedEncoding>  
<UseProxy vt="11">-1</UseProxy>  
<ProxyName vt="8">proxyserver</ProxyName>  
<UseSSO vt="11">0</UseSSO>  
<Password vt="1" />  
<MaxRedirects vt="3">5</MaxRedirects>  
<ContentType vt="8">text/xml</ContentType>  
<ProxyPassword vt="1" />  
<ProxyUsername vt="8">proxyuser</ProxyUsername>  
<UseHandlerSetting vt="11">0</UseHandlerSetting>  
</CustomProps>