Dynamisches Festlegen des URIs eines verarbeiteten Webdiensts [BTS05]
Wenn Sie einen Webport für einen verwendeten Webdienst erstellen, können Sie eine dynamische Portbindung auswählen. Wenn Sie eine dynamische Portbindung auswählen, müssen Sie den URI des verwendeten Webdiensts zur Laufzeit festlegen. Der URI muss einen Webdienst aufrufen, der den gleichen Webproxy wie der Webdienst verwendet, den Sie zum Erstellen des Webporttyps verwendet haben.
Hinweis
In diesem Thema wird beschrieben, wie Eigenschaften für den dynamischen SOAP-Sendeport in einer Orchestrierung programmgesteuert festgelegt werden. Sie können diese Eigenschaften in einer Orchestrierung oder einer benutzerdefinierten Pipelinekomponente jedoch auch unabhängig davon festlegen, ob der Sendeport statisch oder dynamisch ist. Weitere Informationen zu benutzerdefinierten Pipelinekomponenten finden Sie unter Entwickeln benutzerdefinierter Pipelinekomponenten.
Dynamische Portbindungen für Webports weisen ein anderes Verhalten als dynamische Portbindungen für Nicht-Webports auf. Wenn Sie dynamische Bindungen für einen Nicht-Webport auswählen, können Sie nicht den SOAP-Adapter verwenden.
Wenn Sie dynamische Webports zum Nutzen eines Webdiensts verwenden, werden die Sendeporteigenschaften auf Standardwerte festgelegt. Einige dieser Werte werden intern festgelegt, und andere Werte werden standardmäßig auf die Werte festgelegt, die auf den Eigenschaftenseiten des SOAP-Adapterhandlers festgelegt sind. Sie können diese Werte in einer Orchestrierung überschreiben, wenn Sie dynamische Sendeports verwenden. Weitere Informationen finden Sie unter Überlegungen zur Nutzung von Webdiensten.
Dynamisches Ändern des URI eines verwendeten Webdiensts
Fügen Sie einen Webport wie unter Hinzufügen eines Webports beschrieben hinzu. Anstatt jedoch die Option Jetzt Portbindung angeben auszuwählen, wählen Sie dynamische Portbindung aus, wie in der folgenden Abbildung gezeigt.
Fügen Sie in der Orchestrierung, die den verwendeten Webdienst aufruft, irgendwann vor dem Shape Senden, das Sie mit dem Webport verbunden haben, ein Ausdrucks-Shape hinzu.
Fügen Sie im Ausdrucks-Shape einen Ausdruck ähnlich dem folgenden hinzu:
myWebPort(Microsoft.XLANGs.BaseTypes.Address) = "http://orders/myCompany.asmx";
Hinweis
Sie können den im BizTalk-Ausdrucks-Editor verwendeten URI auf verschiedene Weise abrufen, z. B. aus der eingehenden Nachricht, einer SQL-Datenbank oder einer Branchenanwendung.
Dynamisches Ändern der Sendeporteigenschaften
Fügen Sie im Shape Nachricht konstruktieren , das Sie zum Erstellen der Webnachricht verwenden, ein Shape für die Nachrichtenzuweisung hinzu, falls noch keine vorhanden ist.
Fügen Sie im Shape Nachrichtenzuweisung einen Ausdruck ähnlich dem folgenden hinzu:
myWebMessage(SOAP.UseSSO) = true;Alle Eigenschaften für den SOAP-Sendeport verwenden den SOAP-Namespace.
In der folgenden Tabelle ist eine Liste der SOAP-Sendeporteigenschaften enthalten, die Sie beim Verwenden dynamischer Webports festlegen können.
| Eigenschaftenname | type | BESCHREIBUNG |
|---|---|---|
| AuthenticationScheme | String | Die zum Aufrufen des Webdiensts zu verwendende Authentifizierungsmethode. Standardwert: Anonym Andere zulässige Werte: Basic, Digest, NTLM |
| 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 | Der Fingerabdruck des SSL-Clientzertifikats (Secure Sockets Layer). Standardwert: Leer |
| UseSSO | Boolean | Gibt an, ob dieser Webport Einmaliges Anmelden (SSO) verwendet. Standardwert: False |
| AffiliateApplicationName | String | Der Name der SSO-Anwendung, die dieser Webport zum Einlösen des Tickets für Clientanmeldeinformationen verwendet. Standardwert: Leer |
| UseHandlerSetting | Boolean | Gibt an, ob dieser Webport HTTP-Proxyeinstellungen des SOAP-Sendehandlers verwendet. Hinweis: Wenn die UseProxy-Kontexteigenschaft festgelegt ist, wird die UseHandlerSetting-Kontexteigenschaft ignoriert. Standardwert: False |
| UseProxy | Boolean | Gibt an, ob dieser Webport einen Proxyserver für den Zugriff auf den Zielwebdienst verwendet. Hinweis: Wenn die UseProxy-Kontexteigenschaft festgelegt ist, wird die UseHandlerSetting-Kontexteigenschaft ignoriert. Standardwert: False |
| ProxyAddress | String | Adresse des HTTP-Proxys für den Aufruf des Webdiensts Standardwert: Wird aus SOAP-Sendehandlereigenschaften abgerufen. |
| ProxyPort | Integer | Port des HTTP-Proxys für den Aufruf des Webdiensts Standardwert: Wird aus SOAP-Sendehandlereigenschaften abgerufen. |
| ProxyUsername | String | Der Benutzername, der für den HTTP-Proxy verwendet werden soll. Standardwert: Wird aus SOAP-Sendehandlereigenschaften abgerufen. |
| ProxyPassword | String | Das Kennwort, das für den HTTP-Proxy verwendet werden soll. Standardwert: Wird aus SOAP-Sendehandlereigenschaften abgerufen. |
| ClientConnectionTimeout | Int32 | Timeoutwert für die HTTP-Clientverbindung. Standardwert: Entspricht dem Standardtimeout ASP.NET HTTP-Verbindung. |
| TypeName | String | Geben Sie den Namen der Klasse an, die die aufzurufende Webmethode enthält. Standardwert: Leer |
| MethodName | String | Legen Sie die Methode der Klasse fest, die aufgerufen wird. Hinweis: Um die MethodName-Eigenschaft für den statischen SOAP-Sendeport programmgesteuert zu konfigurieren, müssen Sie den Methodennamen auf der Registerkarte Webdienst des Dialogfelds SOAP-Transporteigenschaften in BizTalk Server Verwaltungskonsole auf [Später angeben] festlegen. Weitere Informationen zum Dialogfeld SOAP-Transporteigenschaften finden Sie im Dialogfeld SOAP-Transporteigenschaften, Registerkarte Webdienst in der Referenz zu Benutzeroberflächenanleitungen und Entwickler-API-Namespaces. Standardwert: Leer |
| Assemblyname | String | Gibt den zu ladenden und auszuführenden .NET-Typ und die entsprechende .NET-Assembly an. Standardwert: Leer |
| UnknownHeaders | String | Gibt die serialisierte Liste unbekannter SOAP-Header an. Standardwert: Leer |
| Userdefined | String | Definiert benutzerdefinierte Klassen. Standardwert: Leer |
| UseSoap12 | Boolean | Geben Sie mithilfe dieses Werts an, dass Proxycode generiert wird, der das SOAP 1.2-Protokoll unterstützt. Wenn diese Eigenschaft den Wert Falsch besitzt, wird mit SOAP 1.1 kompatibler Proxycode generiert. Standardwert: False |
Hinweis
Mit Ausnahme der ClientConnectionTimeout-Einstellung können diese Werte nur dynamisch festgelegt werden, wenn dynamische Portbindungen verwendet werden. Sie sind schreibgeschützt, wenn Sie die Portbindung jetzt angeben verwenden . Sie können die ClientConnectionTimeout-Einstellung sowohl mit jetzt angeben als auch mit dynamischen Portbindungen festlegen.
Weitere Informationen
SOAP-Header mit verwendeten Webdiensten
Erstellen von Webports