Freigeben über

Erstellen des Siebel-Systemverbindungs-URI

  • Artikel

Der Verbindungs-URI des Microsoft BizTalk-Adapters für Siebel eBusiness Applications enthält Eigenschaften, die der Adapter zum Herstellen einer Verbindung mit dem Siebel-System verwendet.

Dieses Thema enthält Informationen zum Siebel-Verbindungs-URI sowie Links zu anderen Themen, in denen erläutert wird, wie ein Verbindungs-URI in verschiedenen Programmierszenarien angegeben wird.

Verbindungs-URI für den Siebel-Adapter

Ein typischer WCF-Endpunktadressen-URI wird wie folgt dargestellt:

scheme://userinfoparams@hostinfoparams?query_string

Der Endpunktadressen-URI enthält die folgenden Komponenten:

  • scheme ist der Schemaname.

  • userinfoparams ist eine Name-Wert-Sammlung von Parametern, die für die Benutzerauthentifizierung durch den Endpunkt erforderlich sind.

  • hostinfoparams sind Informationen, die zum Herstellen der Verbindung mit dem Host erforderlich sind. Beispielsweise ein Pfad.

  • query_string ist eine optionale Name-Wert-Auflistung von Parametern, die durch ein Fragezeichen (?) getrennt sind.

    Der Siebel-Verbindungs-URI folgt diesem allgemeinen Format und wird wie folgt implementiert:

siebel://Username=[USER_NAME];Password=[PASSWORD]@[SERVER]:[PORT]?SiebelObjectManager=[SIEBEL_OBJECT_MANAGER_NAME]&SiebelEnterpriseServer=[SERVER_NAME]&Language=[LANGUAGE]&Transport=[TRANSPORT]&Encryption=[ENCRYPTION]&Compression=[COMPRESSION]&SiebelServer=[SIEBEL_SERVER_NAME]&SiebelRepository=[SIEBEL_REPOSITORY_NAME]

In den folgenden Abschnitten werden die Eigenschaften beschrieben, die für jede Komponente des Siebel-Verbindungs-URI implementiert werden.

Das Schema für den Siebel-Verbindungs-URI

Das Schema für den Siebel-Verbindungs-URI lautet "siebel".

Benutzerinformationen im Siebel-Verbindungs-URI

Standardmäßig löst der Siebel-Adapter eine Ausnahme aus, wenn Siebel-Systemanmeldeinformationen im Verbindungs-URI angegeben sind. Dies liegt daran, dass diese Anmeldeinformationen als Nur-Text dargestellt werden, was ein inhärentes Sicherheitsrisiko darstellt. Sie können die AcceptCredentialsInUri-Bindungseigenschaft festlegen, um zu steuern, ob der Verbindungs-URI Anmeldeinformationen enthalten kann. Wenn die AcceptCredentialsInUri-Eigenschaftfalse ist, löst der Siebel-Adapter eine Ausnahme aus, wenn der Verbindungs-URI Anmeldeinformationen enthält. wenn die Eigenschaft true ist, wird keine Ausnahme ausgelöst.

Wichtig

Aufgrund der inhärenten Sicherheitsrisiken, die durch die Übergabe von Anmeldeinformationen in Zeichenfolgen als Nur-Text entstehen, ist es am besten, keine Siebel-Systemanmeldeinformationen im Verbindungs-URI anzugeben.

Es gibt mehrere Möglichkeiten, Siebel-Systemanmeldeinformationen anzugeben, ohne sie im Verbindungs-URI anzugeben.

  • Im Code können Sie die ClientCredentials-Eigenschaft für das entsprechende Objekt festlegen.

  • Wenn Sie das Add Adapter Service Reference Plug-In oder das Add-In Adapter Service Use verwenden, können Sie die Anmeldeinformationen eingeben, indem Sie im Dialogfeld Adapter konfigurieren die Registerkarte Sicherheit auswählen.

  • Wenn Sie eine Sendeport- oder Empfangsspeicherortbindung in einer BizTalk Server-Lösung angeben, können Sie die Anmeldeinformationen eingeben, indem Sie im entsprechenden Dialogfeld die Registerkarte Sicherheit auswählen.

    Die Benutzerinformationen (userinfoparams) im Siebel-Verbindungs-URI werden als Name-Wert-Sammlung von Parametern dargestellt, die für die Benutzerauthentifizierung erforderlich sind. In der folgenden Tabelle werden diese Parameter beschrieben.

Eigenschaft BESCHREIBUNG
Username Der Benutzername auf dem Siebel-System; Bei diesem Wert wird die Groß-/Kleinschreibung beachtet. Sie müssen die AcceptCredentialsInUri-Bindungseigenschaft auf true festlegen, um den Benutzernamen und das Kennwort im Verbindungs-URI anzugeben. Hinweis: Der Siebel-Adapter behält die Groß-/Kleinschreibung des Werts bei, den Sie beim Öffnen einer Verbindung im Siebel-System für den Benutzernamen eingeben.
Kennwort Das Kennwort für den Benutzer im Siebel-System; Bei diesem Wert wird die Groß-/Kleinschreibung beachtet. Sie müssen die AcceptCredentialsInUri-Bindungseigenschaft auf true festlegen, um den Benutzernamen und das Kennwort im Verbindungs-URI anzugeben. Hinweis: Der Siebel-Adapter behält die Groß-/Kleinschreibung des Werts bei, den Sie für das Kennwort eingeben, wenn er eine Verbindung im Siebel-System öffnet.

Hostinformationen im Siebel-Verbindungs-URI

Die Siebel-Hostinformationen (hostinfoparams) geben die Adresse des Siebel-Systems im folgenden Format an: [SERVER]:[PORT]. Je nach Siebel-Serverversion werden für die Siebel-Hostinformationen unterschiedliche Werte verwendet:

  • Für Siebel Version 7.5 und früher übernimmt der Hostinformationsparameter den Namen des Computers, auf dem der Siebel-Gatewayserver installiert ist, und die Siebel-Gatewayportnummer.

  • Für Siebel Version 7.7 und höher übernimmt der Hostinformationsparameter den Namen des Computers, auf dem der Siebel-Server installiert ist, und die Portnummer des Siebel-Verbindungsbrokers.

    Wichtig

    Wenn Sie das Visual Studio-Plug-In Add Adapter Service Reference oder das BizTalk Project Add-In Adapter Service verwenden, um eine Verbindung mit einem Siebel-System herzustellen, müssen die Hostinformationen für die Verbindungseigenschaft "SiebelGateway" bereitgestellt werden.

Abfrageinformationen im Siebel-Verbindungs-URI

Die Abfrageinformationen (query_string) im Siebel-Verbindungs-URI werden verwendet, um zusätzliche Verbindungseigenschaften anzugeben.

Eigenschaft BESCHREIBUNG
SiebelObjectManager Der Name des Siebel-Objekt-Managers auf dem Unternehmensserver. Dieser Parameter ist erforderlich.
SiebelEnterpriseServer Der Name des Siebel Enterprise Server. Dieser Parameter ist erforderlich.
Sprache Die Sprache des Objekt-Managers. Dieser Parameter ist optional. Wenn er nicht angegeben ist, stellt der Siebel-Adapter einen Standardwert (enu) bereit.
Transport Der Transport; nur tcpip wird unterstützt. Dieser Parameter ist optional. Wenn er nicht angegeben ist, stellt das Siebel-System einen Standardwert (tcpip) bereit.
Verschlüsselung Der Verschlüsselungstyp, der zwischen dem Siebel-Adapter und dem Siebel-System verwendet wird. Unterstützte Werte sind none, mscrypto oder rsa. Dieser Parameter ist optional. Wenn es nicht angegeben ist, stellt das Siebel-System einen Standardwert (keine) bereit.
Komprimierung Der Komprimierungsalgorithmus, der zwischen dem Siebel-Adapter und dem Siebel-System verwendet wird. Unterstützte Werte sind "none" oder "zlib". Dieser Parameter ist optional. Wenn dies nicht angegeben ist, stellt das Siebel-System einen Standardwert (zlib) bereit.
SiebelServer Der Siebel-Server. Erforderlich für alle Siebel 7.5-Serververbindungen (7.5.2, 7.5.3 usw.); Andernfalls legen Sie diesen Parameter nicht fest.
SiebelRepository Das Siebel-Repository. Erforderlich, wenn auf dem Server mehrere Repositorys vorhanden sind; andernfalls optional. Hinweis: Wenn auf dem Server mehrere Repositorys vorhanden sind, müssen Sie im Parameter SiebelRepository ein Zielrepository angeben.

Weitere Informationen zu den Siebel-Parametern, die in den Abfrageinformationen festgelegt sind, finden Sie in Ihrer Siebel-Dokumentation.

Verwenden reservierter Zeichen im Verbindungs-URI

Der Siebel-Adapter unterstützt die Angabe eines Verbindungs-URI mit Sonderzeichen für einen der Parameterwerte nicht. Wenn die Verbindungsparameterwerte Sonderzeichen enthalten, stellen Sie sicher, dass Sie eines der folgenden Schritte ausführen:

  • Wenn Sie den URI in Visual Studio mithilfe des Adapterdienstverweis-Plug-Ins hinzufügen oder das Adapterdienst-Add-In nutzen angeben, müssen Sie ihn unverändert auf der Registerkarte URI-Eigenschaften angeben, d. h. ohne Escapezeichen. Wenn Sie den URI direkt im Feld URI konfigurieren angeben und die Verbindungsparameter reservierte Zeichen enthalten, müssen Sie die Verbindungsparameter mithilfe der richtigen Escapezeichen angeben.

  • Wenn Sie den URI beim Erstellen eines Sende- oder Empfangsports in BizTalk Server Verwaltungskonsole angeben und die Verbindungsparameter reservierte Zeichen enthalten, müssen Sie die Verbindungsparameter mithilfe der richtigen Escapezeichen angeben.

Verwenden des Verbindungs-URI zum Herstellen einer Verbindung mit dem Siebel-System

Es folgt ein Siebel-Beispiel-Verbindungs-URI.

siebel://Username=YourUserName;Password=YourPassword@Siebel_server:1234?SiebelObjectManager=obj_mgr&SiebelEnterpriseServer=entserver&Language=enu

Hinweis

Dieser Beispiel-URI enthält die Siebel-Systemanmeldeinformationen. Sie müssen die AcceptCredentialsInUri-Bindungseigenschaft auf true festlegen, um einen Verbindungs-URI zu verwenden, der Anmeldeinformationen enthält.

Informationen zum Herstellen einer Verbindung mit dem Siebel-System (einschließlich Festlegen von Verbindungseigenschaften) finden Sie in folgenden Fällen:

Weitere Informationen

Herstellen einer Verbindung mit dem Siebel-System
Entwickeln von Siebel-Anwendungen
Entwickeln von Siebel-Anwendungen mit dem WCF-Kanalmodell3
Entwickeln von SQL-Anwendungen mithilfe des WCF-Dienstmodells