Konfigurieren eines SOAP-Sendeports

Sie können einen SOAP-Sendeport programmgesteuert oder mithilfe der BizTalk Server-Verwaltungskonsole konfigurieren.

Programmgesteuertes Konfigurieren eines SOAP-Sendeports

Das BizTalk-Explorer-Objektmodell macht eine adapterspezifische Schnittstelle für Sendeports namens ITransportInfo verfügbar, die über die TransportTypeData-Lese-/Schreibeigenschaft verfügt. Diese Eigenschaft akzeptiert einen Konfigurationseigenschaftenbehälter für den SOAP-Sendeport in Form eines Name/Wert-Paars aus XML-Zeichenfolgen. Beachten Sie, dass Sie zuerst die OutboundTransportLocation-Eigenschaft der ITransportInfo-Schnittstelle festlegen müssen, um diese Eigenschaft im BizTalk-Explorer-Objektmodell festzulegen.

Die TransportTypeData-Eigenschaft der ITransportInfo-Schnittstelle ist nicht erforderlich. Falls nicht festgelegt, verwendet der Adapter die Standardwerte für die Konfiguration des SOAP-Sendeports, die in der folgenden Tabelle aufgeführt sind.

In der folgenden Tabelle sind die Konfigurationseigenschaften aufgelistet, die Sie im BizTalk-Explorer-Objektmodell für SOAP-Sendeports festlegen können.

Eigenschaftenname	type	BESCHREIBUNG
URI	String	Virtuelles Verzeichnis, das den Webdienst auf dem Bereitstellungsserver enthält
Benutzername	String	Benutzername, der für den Zugriff auf den Zielwebdienst angegeben werden muss Standardwert: Leer
Kennwort	String	Das für die Authentifizierung mit dem Zielserver zu verwendende Kennwort. Standardwert: Leer
ClientCertificate	String	Fingerabdruck des SSL-Clientzertifikats Standardwert: Leer
AffiliateApplicationName	String	Der Name der SSO-Anwendung, der zum Einlösen des Tickets für Clientanmeldeinformationen verwendet werden soll AffiliateApplicationName schließt sich gegenseitig für ein Username- und Password-Paar aus. Standardwert: Leer
UseProxy	Boolean	Gibt an, ob der SOAP-Sendeport über einen Proxyserver auf den Zielwebdienst zugreift. Der Proxyserver kann von allen SOAP-Sendeports gemeinsam genutzt werden. Standardwert: False
ProxyAddress	String	Adresse des HTTP-Proxys für den Aufruf des Webdiensts Standardwert: Leer
ProxyPort	Integer	Port des HTTP-Proxys für den Aufruf des Webdiensts Standardwert: Leer
ProxyBenutzername	String	Benutzername für den Proxy Standardwert: Leer
ProxyPassword	String	Kennwort für den Proxy Standardwert: Leer

Im folgenden Code wird das Format der Zeichenfolge dargestellt, die zum Festlegen dieser Eigenschaften verwendet werden soll:

<CustomProps>  
   <URI vt="8"/>  
   <ClientCertificate vt="8"/>  
   <Password vt="8">Encrypted</Password>  
   <ProxyAddress vt="8"/>  
   <ProxyPassword vt="8">Encrypted</ProxyPassword>  
   <ProxyPort vt="3"/>  
   <ProxyUsername vt="8"/>  
   <UseProxy vt="11"/>  
   <Username vt="8"/>  
   <AffiliateApplicationName vt="8"/>  
</CustomProps>  

Konfigurieren eines SOAP-Sendeports über die BizTalk Server-Verwaltungskonsole

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

So konfigurieren Sie Variablen für einen SOAP-Sendeport

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 SOAP für die Option Typ im Abschnitt Transport der Registerkarte Allgemein an.

2. Klicken Sie auf der Registerkarte Allgemein im Abschnitt Transport neben Typ auf Konfigurieren.

3. Führen Sie im Dialogfeld SOAP-Transporteigenschaften auf der Registerkarte Allgemein die folgenden Schritte aus:

   Option	Aufgabe
   Webdienst-URL	Geben Sie die Adresse des Webdienstes an, den Sie aufrufen möchten. Hinweis: Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein.
   Authentifizierung	Geben Sie die Authentifizierungsmethode an, die vom aufgerufenen Webdienst verwendet wird. Optionen: - Anonym. Die Standardeinstellung. - Basic. Die SOAP-Verbindung sendet den Benutzernamen und das Kennwort in Nur-Text. - Digest. Die SOAP-Verbindung sendet das Kennwort in einem verschlüsselten Format. - NTLM. Weder der Benutzername noch das Kennwort werden über eine SOAP-Verbindung gesendet. Der SOAP-Adapter verwendet immer die Anmeldeinformationen des Prozesses, unter dem der SOAP-Sendeadapter für diesen Authentifizierungstyp ausgeführt wird.
   Anmeldeinformationen	Geben Sie den Typ der zu verwendenden Anmeldeinformationen an. Nur verfügbar, wenn der AuthentifizierungstypBasic oder Digest ist. Optionen: - Einmaliges Anmelden nicht verwenden Benutzername Der Benutzername für die Authentifizierung am Zielserver. Wenn die AuthentifizierungstypeigenschaftAnonym oder NTLM 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 NTLM 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. Informationen zum Auffüllen dieser Liste finden Sie unter SSO-Partneranwendungen. Mindestlänge: 0 Maximale Länge: 256
   Fingerabdruck des Clientzertifikats	Geben Sie den Fingerabdruck des Clientzertifikats zum Herstellen einer Verbindung an. Beispiel: 01 23 45 67 89 AB CD EF 01 23 45 67 89 AB CD EF 01 23 45 67 Mindestlänge: 0 Maximale Länge: 59

4. Gehen Sie im Dialogfeld SOAP-Transporteigenschaften auf der Registerkarte Proxy wie folgt vor:

   Option	Aufgabe
   Standardproxykonfiguration des Handlers verwenden	Geben Sie die Handlerkonfiguration für den Sendeportproxy an. Wenn der Wert Wahr lautet, verwendet der Port die auf der Handlerebene festgelegten Proxyeinstellungen. Lautet der Wert Falsch, verwendet der Sendeadapter die für den Sendeport festgelegten Proxyinformationen. Die Standardeinstellung ist Wahr.
   Proxy nicht verwenden	Geben Sie an, ob vom SOAP-Sendehandler ein Proxyserver verwendet werden soll.
   Proxy verwenden	Geben Sie an, ob vom SOAP-Sendehandler ein Proxyserver verwendet werden soll. Der Proxyserver kann von allen SOAP-Sendeports gemeinsam genutzt werden.
   Server	Gibt den Namen des Proxyservers an. Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist. Typ: String Mindestlänge: 0 Maximale Länge: 256
   Port	Geben Sie den Port an, den der SOAP-Sendehandler verwenden soll. Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist. Standardwert: 80 Typ: Long Minimalwert: 0 Maximalwert: 65535 Hinweis: Wenn Sie den Wert 0 angeben, wird der Standardwert verwendet, d. h. Port 80.
   Benutzername	Geben Sie den Benutzernamen für die Authentifizierung an. Wenn Sie die integrierte Windows-Authentifizierung verwenden, enthält der Benutzername die Domäne Domäne\Benutzername. Wenn Sie die Standard- oder Digestauthentifizierung verwenden, enthält der Benutzername keine Domäne\. Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist. Typ: String Mindestlänge: 0 Maximale Länge: 256
   Kennwort	Geben Sie das Kennwort für die Authentifizierung an. Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist. Typ: String Mindestlänge: 0 Maximale Länge: 256

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

   Option	Aufgabe
   Orchestrierungswebport	Geben Sie an, dass der Webdienst verwendet werden soll, der unter der Webdienst-URL auf der Registerkarte Allgemein verfügbar gemacht wird. Dies ist die Standardeinstellung.
   Assemblyname	Geben Sie den Namen der Assembly an, die den Webdienstproxy enthält. Dieses Feld kann ausgefüllt werden, indem Sie mithilfe der Schaltfläche zum Durchsuchen nach einer Assembly suchen. Nach Auswahl der Assembly wird deren vollqualifizierter Name in das Feld eingetragen. Hinweis: Die angegebene Assembly muss zur Laufzeit auf allen BizTalk-Servern vorhanden sein.
   Typname	Geben Sie den Namen der Klasse an, die die aufzurufende Webmethode enthält. Der Name kann in einer Liste der Typen in der Assembly ausgewählt werden.
   Methodenname	Geben Sie eine der Methoden im Listenfeld an, oder wählen Sie die Option "Später angeben" aus. Wenn Sie die Option Später angeben auswählen, muss die Webmethode auf andere Weise (z. B. als Pipelinekomponente) festgelegt werden. In diesem Szenario muss die Webmethode in die Kontexteigenschaft Soap Adapter MethodName geschrieben werden.
   SOAP 1.2	Geben Sie mithilfe dieses Werts an, dass Proxycode generiert wird, der das SOAP 1.2-Protokoll unterstützt. Wenn diese Option nicht ausgewählt wird, wird SOAP 1.1-kompatibler Proxycode generiert. Standardwert: gelöscht

6. Klicken Sie erneut auf OK und erneut auf OK , um die Einstellungen zu speichern.

Weitere Informationen

Veröffentlichen von Webdiensten