Teilen über

Konfigurieren eines HTTP-Sendeports

  • Artikel

Sie können einen HTTP-Sendeport entweder programmgesteuert oder über die BizTalk Server-Verwaltungskonsole konfigurieren.

Programmgesteuertes Konfigurieren eines HTTP-Sendeports

Der HTTP-Adapter speichert seine Konfigurationsinformationen in der BizTalk-Verwaltungsdatenbank (die auch als Konfigurationsdatenbank bezeichnet wird). Sie speichern Konfigurationsinformationen in einer benutzerdefinierten XML-Eigenschaftensammlung. Während der Initialisierung des HTTP-Adapters und zur Laufzeit übergibt der Server die Konfiguration folgendermaßen an den Adapter:

  • Für den HTTP-Sendehandler werden Konfigurationsinformationen an den Adapter übergeben, indem die Load-Methode der IPersistPropertyBag-Schnittstelle aufgerufen wird .

  • Für die HTTP-Sendeports werden Konfigurationsinformationen als Satz von Eigenschaften in einem Nachrichtenkontext an den Adapter übergeben. Im HTTP-Namespace werden diese Eigenschaften gruppiert.

    Das BizTalk Explorer-Objektmodell macht die ItransportInfo Adapterkonfigurationsschnittstelle für Sendeports verfügbar, die die TransportTypeData Lese-/Schreibeigenschaft enthält. Diese Eigenschaft akzeptiert die Eigenschaftensammlung für die Konfiguration des HTTP-Sendeports in Form einer aus einem Name/Wert-Paar bestehenden XML-Zeichenfolge. Beachten Sie, dass diese Eigenschaft zuerst für die Address Eigenschaft der ITransportInfo-Schnittstelle festgelegt werden muss, um diese Eigenschaft im BizTalk-Explorer-Objektmodell festzulegen.

    Das Festlegen der TransportTypeData-Eigenschaft der ITransportInfo-Schnittstelle ist nicht erforderlich. Wenn sie nicht festgelegt ist, verwendet der HTTP-Adapter die Standardwerte für den HTTP-Sendehandler.

    Wenn die Konfigurationseigenschaften des Sendeports, die die Konfiguration für den Handler duplizieren, nicht definiert sind, werden Konfigurationseigenschaften für den Handler verwendet. Wenn für den HTTP-Sendehandler keine Konfigurationswerte vorhanden sind, protokolliert der HTTP-Sendeadapter einen Fehler im Ereignisprotokoll und verschiebt die Nachricht zum Sicherungsadapter.

    Konfigurationseigenschaften können programmgesteuert für einen Nachrichtenkontext festgelegt werden. Die Eigenschaften können in einem BizTalk Server-Orchestrierungsplan oder in benutzerdefinierten Pipelinekomponenten festgelegt werden. Für die Verwendung dieser Eigenschaften gelten die folgenden Regeln:

  • Wenn die Konfigurationseigenschaft in einer Orchestrierung oder in einer benutzerdefinierten Pipelinekomponente in einer Empfangspipeline festgelegt wird, gilt Folgendes:

    • Wenn eine Nachricht an einen statischen Sendeport gesendet wird, wird der Eigenschaftenwert durch den für diesen Sendeport konfigurierten Wert überschrieben.

    • Wenn eine Nachricht an einen dynamischen Sendeport gesendet wird, wird der Eigenschaftenwert nicht überschrieben.

  • Wenn die Konfigurationseigenschaft in einer benutzerdefinierten Pipelinekomponente in einer Sendepipeline festgelegt wird, gilt Folgendes:

    • Der Eigenschaftenwert wird unabhängig davon nicht überschrieben, ob die Nachricht an einen statischen oder einen dynamischen Sendeport gesendet wird.

    In der folgenden Tabelle sind die Konfigurationseigenschaften aufgelistet, die Sie im Objektmodell von BizTalk-Explorer für den HTTP-Sendespeicherort festlegen können.

Eigenschaftenname type BESCHREIBUNG Beschränkungen Kommentare
RequestTimeout xs:int Timeout für das Warten auf eine Antwort vom Server. Wird der Wert auf null (0) gesetzt, wird das Timeout anhand der Größe der Anforderungsnachricht berechnet. Mindestwert: 0

Maximaler Wert: MAX_LONG		 Standardwert: 0
ContentType xs:string Inhaltstyp der Anforderungsnachrichten. Mindestlänge: 0

Maximale Länge: 256		 Standardwert: Text/XML
MaxRedirects xs:int Gibt an, wie häufig der HTTP-Adapter die Anforderung maximal umleiten kann. Mindestwert: 0

Maximaler Wert: 10		 Standardwert: 5
UseHandlerProxySettings xs:boolean Gibt an, ob der HTTP-Sendeport die Proxykonfiguration für den Sendehandler verwenden soll. Keine Standardwert: STIMMT

Lautet der Wert Wahr, verwendet der Sendeport die auf der Ebene des Handlers angegebenen Proxyeinstellungen. Lautet der Wert Falsch, verwendet der Sendeadapter die für den Sendeport festgelegten Proxyinformationen.
UseProxy xs:boolean Gibt an, ob der HTTP-Adapter den Proxyserver verwendet. Der Proxyserver kann von allen HTTP-Sendeports gemeinsam verwendet werden. Keine Standardwert: FALSE

Diese Eigenschaft wird ignoriert, wenn UseHandlerProxySettingsauf True festgelegt ist.
ProxyName xs:string Gibt den Namen des Proxyservers an. Mindestlänge: 0

Maximale Länge: 256		 Standardwert: Leer

Der HTTP-Sendeadapter ignoriert diese Eigenschaft, wenn die UseHandlerProxySettings-Eigenschaft auf True festgelegt ist. Andernfalls verwendet der HTTP-Sendeadapter diese Eigenschaft nur, wenn UseProxyauf True festgelegt ist. Diese Eigenschaft ist erforderlich, wenn UseProxyauf True festgelegt ist.
ProxyPort xs:int Gibt den Proxyserverport an. Mindestwert: 0

Maximaler Wert: 65535		 Standardwert: 80

Der HTTP-Sendeadapter ignoriert diese Eigenschaft, wenn UseHandlerProxySettingsauf True festgelegt ist. Andernfalls verwendet der HTTP-Sendeadapter diese Eigenschaft nur, wenn UseProxyauf True festgelegt ist. Diese Eigenschaft ist erforderlich, wenn UseProxyauf True festgelegt ist.
ProxyUsername xs:string Gibt den Benutzernamen für die Authentifizierung am Proxyserver an. Mindestlänge: 0

Maximale Länge: 256		 Standardwert: leer

Der HTTP-Sendeadapter ignoriert diese Eigenschaft, wenn UseHandlerProxySettingsauf True festgelegt ist. Andernfalls verwendet der HTTP-Sendeadapter diese Eigenschaft nur, wenn UseProxyauf True festgelegt ist.
ProxyPassword xs:string Gibt das Benutzerkennwort für die Authentifizierung am Proxyserver an. Mindestlänge: 0

Maximale Länge: 256		 Standardwert: leer

Der HTTP-Sendeadapter ignoriert diese Eigenschaft, wenn UseHandlerProxySettingsauf True festgelegt ist. Andernfalls verwendet der HTTP-Sendeadapter diese Eigenschaft nur, wenn UseProxyauf True festgelegt ist.
AuthenticationScheme xs:string Typ der Authentifizierung am Zielserver. Keine Gültige Werte:

- Anonym (Standard)
- Basic
- Digest
- Kerberos
Benutzername xs:string Benutzername für die Authentifizierung am Server. Mindestlänge: 0

Maximale Länge: 256		 Standardwert: Leer

Dieser Wert ist erforderlich, wenn Sie Standard - oder Digestauthentifizierung auswählen. Der HTTP-Adapter ignoriert den Wert dieser Eigenschaft, wenn UseSSOtrue ist.
Kennwort xs:string Das für die Authentifizierung mit dem Zielserver zu verwendende Kennwort. Mindestlänge: 0

Maximale Länge: 256		 Standardwert: leer

Dieser Wert ist erforderlich, wenn Sie Standard - oder Digestauthentifizierung auswählen. Der Wert dieser Eigenschaft wird ignoriert, wenn UseSSOtrue ist.
EnableChunkedEncoding xs:boolean Gibt an, ob aufgeteilte Codierung vom HTTP-Adapter verwendet wird. Keine Standardwert:

True
Certificate xs:string Fingerabdruck des SSL-Clientzertifikats. Mindestlänge: 0

Maximale Länge: 59		 Standardwert: Leer
UseSSO xs:boolean Gibt an, ob SSO für den Sendeport verwendet wird. Keine Standardwert: FALSE
AffiliateApplicationName xs:string Name der Partneranwendung für SSO. Mindestlänge: 0

Maximale Länge: 256		 Standardwert: leer

Erforderlich, wenn UseSSOtrue ist.

Der folgende Code zeigt die XML-Zeichenfolge, die zum Festlegen der Eigenschaften verwendet wird:

<CustomProps>  
   <ContentType vt="8">text/xml</ContentType>  
   <RequestTimeout vt="3">0</RequestTimeout>  
   <MaxRedirects vt="3">5</MaxRedirects>  
   <UseHandlerProxySettings vt="8">-1</UseHandlerProxySettings>  
   <UseProxy vt="8">-1</UseProxy>  
   <ProxyName vt="8">sdfsd</ProxyName>  
   <ProxyPort vt="3">80</ProxyPort>  
   <ProxyUsername vt="8">Somename</ProxyUsername>  
   <ProxyPassword vt="8">Somepassword</ProxyPassword>  
   <AuthenticationScheme vt="8">Basic</AuthenticationScheme>  
   <Username vt="8">Somename</Username>  
   <Password vt="8">Somepassword</Password>  
   <EnableChunkedEncoding vt="11">1</EnableChunkedEncoding>  
   <Certificate vt="8">AAAA BBBB CCCC DDDD</Certificate>  
   <UseSSO vt="11">0</UseSSO>  
   <AffiliateApplicationName vt="8">Name</AffiliateApplicationName>  
</CustomProps>

Konfigurieren eines HTTP-Sendeports mit der BizTalk Server-Verwaltungskonsole

Sie können in der BizTalk Server-Verwaltungskonsole Adaptervariablen für den HTTP-Sendeport festlegen. Wenn keine Eigenschaften für den Sendeport festgelegt sind, werden die standardmäßigen Sendehandlerwerte verwendet, die in der BizTalk Server-Verwaltungskonsole festgelegt sind.

Hinweis

Die in diesem Thema beschriebenen Konfigurationseigenschaften gelten sowohl für unidirektionale HTTP-Sendeports als auch für HTTP-Sendeports vom Typ „Antwort anfragen“.

  1. Erstellen Sie in der BizTalk Server-Verwaltungskonsole einen neuen Sendeport, oder doppelklicken Sie auf einen vorhandenen Sendeport, um diesen zu ändern. Weitere Informationen finden Sie unter Erstellen eines Sendeports . Konfigurieren Sie alle Sendeportoptionen, und geben Sie HTTP für die Option Typ im Abschnitt Transport auf der Registerkarte Allgemein an.

  2. Klicken Sie auf der Registerkarte Allgemein im Abschnitt Transport auf die Schaltfläche Konfigurieren neben Typ.

  3. Gehen Sie im Dialogfeld HTTP-Transporteigenschaften auf der Registerkarte Allgemein wie folgt vor:

    Option Aufgabe
    Ziel-URL Erforderlich. Geben Sie die Adresse an, an die HTTP-Anforderungen gesendet werden sollen. Schließen Sie Abfragezeichenfolgen ein, die an die Basis-URL angehängt sind.

    Typ: Schnur

    Maximale Länge: 256

    Weitere Informationen finden Sie unter Einschränkungen für die Ziel-URL-Eigenschaft. Hinweis: Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein.
    Aufgeteilte Codierung aktivieren Wählen Sie diese Option aus, um die aufgeteilte Codierung zu verwenden. Wenn diese Option aktiviert wurde, verwendet der HTTP-Adapter die aufgeteilte HTTP-Codierung mit einer maximalen Segmentgröße von 8 KB. Die blockierte Codierung ist implizit deaktiviert, wenn der HTTP-Sendehandler auf Proxy verwenden konfiguriert ist.

    Typ: Boolean

    Standardwert: STIMMT
    Anforderungstimeout (Sek.) Geben Sie den Timeoutwert (in Sekunden) für die HTTP-/HTTPS-Übertragung an. 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 null (0) festgelegt wurde, berechnet die BizTalk-Messaging-Engine das Timeout anhand der Größe der Anforderungsnachricht. Wenn kein Wert angegeben ist, wird der Wert für den Handler verwendet.

    Typ: Lange

    Mindestwert: 0

    Maximaler Wert: MAX_LONG
    Maximale Anzahl von Umleitungen Geben Sie an, wie oft die gesendete Nachricht maximal umgeleitet werden darf.

    Standardwert: 5

    Typ: Int

    Mindestwert: 0

    Maximalwert: 10
    Inhaltstyp Geben Sie den Inhaltstyp der Anforderungsnachrichten an.

    Wenn dieser Wert nicht festgelegt ist, wird der Wert für den Handler verwendet.

    Typ: Schnur

    Mindestlänge: 0

    Maximale Länge: 256

  4. Gehen Sie im Dialogfeld HTTP-Transporteigenschaften auf der Registerkarte Proxy (Handler außer Kraft setzen) wie folgt vor:

    Option Aufgabe
    Standardproxykonfiguration des Handlers verwenden Geben Sie an, dass die Sendeportkonfiguration die Proxyeinstellungen verwenden muss, die für den HTTP-Sendehandler angegeben sind.

    Dies ist die Standardeinstellung.
    Proxy nicht verwenden Geben Sie an, ob der HTTP-Sendehandler den Proxyserver verwendet.

    Bei Auswahl dieser Option verwendet der HTTP-Sendehandler für diesen Sendeport den Proxyserver nicht.
    Proxy verwenden Geben Sie an, ob der HTTP-Sendehandler den Proxyserver verwendet.

    Bei Auswahl dieser Option verwendet der HTTP-Sendehandler den Proxyserver.
    Server Geben Sie die Proxyserveradresse für diesen Sendeport an.

    Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist.

    Typ: Schnur

    Mindestlänge: 0

    Maximale Länge: 256
    Port Geben Sie den Proxyserverport für diesen Sendeport an.

    Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist.

    Standardwert: 80

    Typ: Lange

    Mindestwert: 0

    Maximalwert: 65535
    Benutzername Geben Sie den Benutzernamen für die Authentifizierung beim Proxyserver an.

    Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist.

    Typ: Schnur

    Mindestlänge: 0

    Maximale Länge: 256
    Kennwort Geben Sie das Benutzerkennwort für die Authentifizierung am Proxyserver an.

    Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist.

    Typ: Schnur

    Mindestlänge: 0

    Maximale Länge: 256

  5. Führen Sie im Dialogfeld HTTP-Transporteigenschaften auf der Registerkarte Authentifizierung die folgenden Schritte aus:

    Option Aufgabe
    Authentifizierungstyp Geben Sie den Typ der Authentifizierung am Zielserver an.

    Folgende Optionen sind gültig:

    - Anonym
    - Basic
    - Digest
    - Kerberos

    Standardwert: Anonym
    Anmeldeinformationen Geben Sie den Typ der zu verwendenden Anmeldeinformationen an.

    Nur verfügbar, wenn der AuthentifizierungstypBasic oder Digest ist.

    Folgende Optionen sind gültig:

    - Einmaliges Anmelden nicht verwenden
    Benutzername:
    Der Benutzername für die Authentifizierung am Zielserver. Wenn die AuthentifizierungstypeigenschaftAnonym oder Kerberos ist, ist diese Option deaktiviert. Diese Eigenschaft erfordert einen Wert, wenn Basic oder Digest ausgewählt ist und enterprise Single Sign-On nicht verwendet wird.
    Mindestlänge: 0
    Maximale Länge: 256
    Kennwort:
    Das Kennwort für die Authentifizierung am Zielserver. Wenn die AuthentifizierungstypeigenschaftAnonym oder Kerberos ist, ist diese Option deaktiviert. Diese Eigenschaft erfordert einen Wert, wenn Basic oder Digest ausgewählt ist und Single Sign-On nicht verwendet wird.
    Mindestlänge: 0
    Maximale Länge: 256
    - Verwenden des einmaligen Anmeldens
    Geben Sie an, ob Clientanmeldeinformationen für die Authentifizierung am Zielserver mittels Einmaligem Anmelden abgerufen werden sollen.
    Partneranwendung
    Gibt die Partneranwendung für Einmaliges Anmelden an.
    Wählen Sie die Anwendungen aus, die in Einmaligem Anmelden enthalten sein sollen.
    Mindestlänge: 0
    Maximale Länge: 256
    Zertifikatfingerabdruck des SSL-Clients Geben Sie den Fingerabdruck des Clientzertifikats für das Herstellen einer SSL-Verbindung (Secure Sockets Layer) an.

    Mindestlänge: 0

    Maximale Länge: 59

  6. Klicken Sie erneut aufOK, um die Einstellungen zu speichern.

Weitere Informationen

Konfigurieren eines HTTP-Sendeports