Konfigurationseigenschaften des HTTP-Adapters
In der folgenden Tabelle sind die Konfigurationseigenschaften aufgelistet, die Sie für einen HTTP-Adapterempfangsspeicherort festlegen können:
| Eigenschaftenname | type | BESCHREIBUNG | Beschränkungen | Kommentare |
|---|---|---|---|---|
| ReturnCorrelationHandle | VT_BOOL | Legen Sie fest, dass bei erfolgreicher Durchführung das Korrelationstoken der übermittelten Nachricht vom Empfangsspeicherort in der HTTP-Antwort an den Client gesendet wird. | Diese Eigenschaft gilt nur für unidirektionale Empfangsspeicherorte. Gültige Werte sind: - -1 (wahr) - 0 (false) |
Keine |
| ResponseContentType | VT_BSTR | 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". Mindestlänge: 0 Maximale Länge: 256 |
Der Standardwert ist text/xml. |
| SuspendFailedRequests | VT_BOOL | Legen Sie fest, ob HTTP-Anforderungen angehalten werden, bei denen die Eingangsverarbeitung fehlgeschlagen ist. | Gültige Werte sind: - -1 (wahr) - 0 (false) |
Durch den Wert "0" (falsch) wird festgelegt, dass die fehlerhafte Anforderung verworfen und ein Fehlerstatuscode (401 oder 500) an den Client gesendet wird. Durch den Wert "-1" (wahr) wird festgelegt, dass die fehlgeschlagene Anforderung angehalten und der Statuscode "Akzeptiert" (200) bei unidirektionalen Empfangsports bzw. der Statuscode "Fehler" (500) bei bidirektionalen Empfangsports an den Client gesendet wird. Der Standardwert ist 0 (falsch). |
| UseSSO | VT_BOOL | Legen Sie fest, ob Einmaliges Anmelden für Unternehmen (SSO) verwendet wird. | Gültige Werte sind: - -1 (wahr) - 0 (false) |
Der Standardwert ist 0 (falsch). |
| LoopBack | VT_BOOL | Legen Sie fest, dass die an diesem Speicherort empfangene Anforderungsnachricht an einen Sendeport weitergeleitet oder als Antwort an diesen Empfangsspeicherort zurückgesendet wird. | Diese Eigenschaft gilt nur für Empfangsspeicherorte vom Typ "Anforderungsantwort". Gültige Werte sind: - -1 (wahr) - 0 (false) |
Der Standardwert ist 0 (falsch). |
Der folgende Code zeigt das Format der XML-Zeichenfolge, die zum Festlegen der Eigenschaften verwendet wird:
<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 aufgelistet, die Sie für den Sendeport eines HTTP-Adapters festlegen können:
| Eigenschaftenname | type | BESCHREIBUNG | Beschränkungen | Kommentare |
|---|---|---|---|---|
| ProxyPort | VT_I4 | Geben Sie den Proxyserverport für diesen Sendeport an. | Gültige Werte sind zwischen 0 und 65535. | Für diese Eigenschaft ist kein Wert erforderlich, wenn UseProxy auf 0 (falsch) festgelegt ist. Der Standardwert ist 80. |
| RequestTimeout | VT_I4 | Geben Sie den Timeoutwert (in Sekunden) für die HTTP-/HTTPS-Übertragung an. | Die gültigen 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 übermittelt die Nachricht entsprechend der Wiederholungslogik erneut. Wenn 0 festgelegt wurde, berechnet die BizTalk-Messaging-Engine den Timeout anhand der Größe der Anforderungsnachricht. Wenn kein Wert angegeben ist, wird der Wert für den Handler verwendet. |
| Zertifikat | VT_BSTR | Geben Sie den Fingerabdruck des Clientzertifikats für das Herstellen einer SSL-Verbindung (Secure Sockets Layer) an. | Mindestlänge: 0 Maximale Länge: 59 |
Der Standardwert ist leer. |
| Authentifizierungsschemas | VT_BSTR | Geben Sie den Typ der Authentifizierung am Zielserver an. | Gültige Werte sind: -Anonym -Basic -Digest -Kerberos |
Der Standardwert ist Anonym. |
| Username | VT_BSTR | Geben Sie den Benutzernamen für die Authentifizierung am Zielserver an. | Wenn Standard oder Digest für AuthenticationScheme ausgewählt wurde und Einmaliges Anmelden für Unternehmen (SSO) nicht verwendet wird, ist für diese Eigenschaft ein Wert erforderlich. Mindestlänge: 0 Maximale Länge: 256 |
Keine |
| EnableChunkedEncoding | VT_BOOL | Wählen Sie diese Option aus, um die aufgeteilte Codierung zu verwenden. | Die aufgeteilte Codierung ist implizit deaktiviert, wenn für den HTTP-Sendehandler die Einstellung Proxy verwenden aktiviert wurde. Gültige Werte sind: - -1 (wahr) - 0 (false) |
Wenn diese Option aktiviert ist, verwendet der HTTP-Adapter die HTTP-Blockcodierung mit einer maximalen Blockgröße von 8 KB. Der Standardwert ist 0 (falsch). |
| 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 (falsch). |
| ProxyName | VT_BSTR | Geben Sie die Proxyserveradresse für diesen Sendeport an. | Mindestlänge: 0 Maximale Länge: 256 |
Für diese Eigenschaft ist kein Wert erforderlich, wenn UseProxy auf 0 (falsch) festgelegt ist. |
| UseSSO | VT_BOOL | Geben Sie an, ob Clientanmeldeinformationen für die Authentifizierung am Zielserver mittels Einmaligem Anmelden abgerufen werden sollen. | Gültige Werte sind: - -1 (wahr) - 0 (false) |
Der Standardwert ist 0 (falsch). |
| Kennwort | VT_NULL | Geben Sie das Kennwort für die Authentifizierung am Zielserver an. | Wenn Standard oder Digest für AuthenticationScheme ausgewählt wurde und Einmaliges Anmelden für Unternehmen (SSO) nicht verwendet wird, ist für diese Eigenschaft ein Wert erforderlich. Dieser Wert ist beim Exportieren einer Bindungsdatei immer auf Null festgelegt. In dieses Feld muss das Kennwort manuell eingegeben werden, bevor die Bindungsdatei in die Konfiguration des BizTalk-Zielservers importiert wird. Mindestlänge: 0 Maximale Länge: 256 |
Legen Sie vor dem Importieren der Bindungsdatei den Typ für diese Eigenschaft auf VT_BSTR (vt="8") fest, wenn Sie für dieses Feld einen Wert bereitstellen. |
| MaxRedirects | VT_I4 | Geben Sie an, wie oft die gesendete Nachricht maximal umgeleitet werden darf. | Gültige Werte liegen zwischen 0 und 10. | Der Standardwert ist 5. |
| ContentType | 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 am Proxyserver an. | Dieser Wert ist beim Exportieren einer Bindungsdatei immer auf Null festgelegt. In dieses Feld muss das Kennwort manuell eingegeben werden, bevor die Bindungsdatei in die Konfiguration des BizTalk-Zielservers importiert wird. Mindestlänge: 0 Maximale Länge: 256 |
Für diese Eigenschaft ist kein Wert erforderlich, wenn UseProxy auf 0 (falsch) festgelegt ist. |
| ProxyUsername | VT_BSTR | Geben Sie den Benutzernamen für die Authentifizierung beim Proxyserver an. | Mindestlänge: 0 Maximale Länge: 256 |
Für diese Eigenschaft ist kein Wert erforderlich, wenn UseProxy auf 0 (falsch) festgelegt ist. |
| UseHandlerSetting | VT_BOOL | Legen Sie fest, dass für die Sendeportkonfiguration die für den HTTP-Sendehandler angegebenen Proxyeinstellungen verwendet werden müssen. | Gültige Werte sind: - -1 (wahr) - 0 (false) |
Der Standardwert ist -1 (wahr). |
Der folgende Code zeigt das Format der XML-Zeichenfolge, die zum Festlegen der Eigenschaften verwendet wird:
<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>