Freigeben über

Erstellen des Oracle E-Business Suite-Verbindungs-URI

  • Artikel

Der Microsoft BizTalk-Adapter für Oracle E-Business Suite-Verbindungs-URI enthält Eigenschaften, die der Adapter zum Herstellen einer Verbindung mit Oracle E-Business Suite und im Wesentlichen der zugrunde liegenden Oracle-Datenbank verwendet. Der Oracle E-Business-Adapter unterstützt zwei Arten der Verbindung mit der zugrunde liegenden Oracle-Datenbank: mit tnsnames.ora und ohne Verwendung von tnsnames.ora. Basierend auf der Art des Konnektivitätsansatzes unterscheidet sich auch das Format des Verbindungs-URI. Dieses Thema enthält Informationen zum Oracle-Verbindungs-URI sowie Links zu anderen Themen, in denen erläutert wird, wie ein URI in verschiedenen Programmierszenarien angegeben wird.

Oracle E-Business Suite ist eine Anwendungsschicht, die Schnittstellen mit einer zugrunde liegenden Oracle-Datenbank herstellt und basierend auf den unterschiedlichen Anforderungen innerhalb eines organization in verschiedene Anwendungen wie Finanzwesen und HR unterteilt wird. Jede dieser Anwendungen stellt verschiedene "Formulare" bereit, mit denen Benutzer Daten in die zugrunde liegende Oracle-Datenbank eingeben können. Der Zugriff auf diese Formulare wird eingeschränkt, indem Benutzer einem Anwendungskontext zugeordnet werden, der die organization-ID, zu der ein Benutzer gehört, die dem Benutzer zugeordnete "Verantwortung" und den Namen der Oracle E-Business Suite-Anwendung umfasst, die der Benutzer aufrufen möchte. Obwohl der Adapter eine direkte Verbindung mit der zugrunde liegenden Datenbank herstellt und keine Formulare für die Schnittstelle mit der Oracle E-Business Suite verwendet, ist das Festlegen des Anwendungskontexts obligatorisch, wenn Vorgänge für die Oracle E-Business Suite-Artefakte ausgeführt werden. Um mithilfe des Oracle E-Business-Adapters eine Verbindung mit der Oracle E-Business-Suite und der zugrunde liegenden Oracle-Datenbank herzustellen, müssen Sie folgendes ausführen:

  • Geben Sie einen Verbindungs-URI an, um eine Verbindung mit Oracle E-Business Suite und der zugrunde liegenden Oracle-Datenbank herzustellen. Beim Herstellen einer Verbindung können Sie die Anmeldeinformationen für Oracle E-Business Suite oder die zugrunde liegende Oracle-Datenbank angeben.

  • Legen Sie den Anwendungskontext für den Benutzer fest. Der Oracle E-Business-Adapter macht bestimmte Bindungseigenschaften verfügbar, die die Anmeldeinformationen und die Verantwortung akzeptieren. Weitere Informationen zu diesen Bindungseigenschaften finden Sie unter Informationen zu den Bindungseigenschaften des BizTalk-Adapters für Oracle E-Business Suite. Weitere Informationen zum Festlegen des Anwendungskontexts finden Sie unter Festlegen des Anwendungskontexts.

    Dieser Abschnitt enthält Informationen zum Angeben des Verbindungs-URI für die Verbindung mit der zugrunde liegenden Datenbank mithilfe von tnsnames.ora und ohne Verwendung von tnsnames.ora. Außerdem werden Informationen zur Verwendung des Verbindungs-URI zum Herstellen einer Verbindung mit Oracle E-Business Suite bereitgestellt.

Herstellen einer Verbindung mithilfe von tnsnames.ora

Wichtig

  • Für diesen Ansatz müssen Sie den Eintrag net service name in der Datei tnsnames.ora auf dem Computer hinzufügen, auf dem der Adapterclient installiert ist. Informationen zum Net Service Name-Eintrag finden Sie unter Konfigurieren des Oracle-Clients für den E-Business Suite-Adapter.
    • Aufgrund einer Oracle Client-Einschränkung darf der DataSourceName-Parameter (Net Service Name) im Verbindungs-URI nicht mehr als 39 Zeichen enthalten, wenn Sie Vorgänge in einer Transaktion ausführen. Stellen Sie daher sicher, dass der für den DataSourceName-Parameter angegebene Wert kleiner oder gleich 39 Zeichen ist, wenn Sie Vorgänge in einer Transaktion ausführen.

Der Verbindungs-URI kann einen Oracle net-Dienstnamen enthalten, der verwendet wird, um den Oracle E-Business Suite-Dienst zu identifizieren, mit dem Sie eine Verbindung herstellen möchten. Der Oracle-Client löst den Oracle-Net-Dienstnamen, den Sie im Verbindungs-URI angeben, gemäß einer Hierarchie von Oracle-Benennungsmethoden, die Sie für die Verwendung konfigurieren, in Verbindungsinformationen für einen Oracle E-Business Suite-Dienst auf. Eine gängige Benennungsmethode wird als lokale Benennung bezeichnet. Bei der lokalen Benennung verwendet der Oracle-Client eine Datei namens tnsnames.ora, um den Namen des Oracle-Net-Diensts aufzulösen.

Ein typischer Endpunktadress-URI in WCF wird wie folgt dargestellt: scheme://userauthparams@hostinfoparams

  • scheme ist der Schemaname.

  • userauthparams 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. Beispiel: Name eines Net-Diensts.

    Der Oracle E-Business-Adapterverbindungs-URI entspricht diesem grundlegenden Format und wird wie folgt implementiert:

oracleebs://User=[USER_NAME];Password=[PASSWORD]@[NET_SERVICE_NAME]

In der folgenden Tabelle werden die Im Verbindungs-URI enthaltenen Eigenschaften erläutert.

Verbindungs-URI-Eigenschaft Category BESCHREIBUNG
[USER_NAME] userauthparams Der Benutzername, der für die Authentifizierung verwendet werden soll. Der Oracle E-Business-Adapter macht eine ClientCredentialType-Bindungseigenschaft verfügbar, die den Typ der Oracle-Clientanmeldeinformationen angibt, die der Client zum Herstellen einer Verbindung angibt. Die möglichen Werte für die ClientCredentialType-Bindungseigenschaft sind Database und EBusiness. Abhängig vom Wert für diese Bindungseigenschaft müssen Sie relevante Anmeldeinformationen angeben. Weitere Informationen finden Sie unter Oracle-Anmeldeinformationen und verbindungs-URI. Hinweis: Sie müssen die AcceptCredentialsInUri-Bindungseigenschaft auf true festlegen, um den Benutzernamen und das Kennwort im Verbindungs-URI anzugeben. Hinweis: Der Oracle E-Business-Adapter behält nicht die Groß-/Kleinschreibung des Werts bei, den Sie für den Benutzernamen eingeben, wenn er eine Verbindung mit Oracle E-Business Suite herstellt. Der Benutzername wird unter Verwendung der Standardregeln von SQL*Plus an Oracle E-Business Suite übergeben. Wenn Sie jedoch die Groß-/Kleinschreibung des Benutzernamens beibehalten möchten oder einen Benutzernamen mit Sonderzeichen eingeben möchten, müssen Sie den Wert in doppelten Anführungszeichen angeben.
[KENNWORT] userauthparams Das Kennwort, das für die Authentifizierung verwendet werden soll. Der Oracle E-Business-Adapter macht eine ClientCredentialType-Bindungseigenschaft verfügbar, die den Typ der Oracle-Clientanmeldeinformationen angibt, die der Client zum Herstellen einer Verbindung angibt. Wenn die ClientCredentialType-Eigenschaft auf Database festgelegt ist, müssen die Clients das Kennwort für einen Oracle-Datenbankbenutzer angeben. Wenn die ClientCredentialType-Eigenschaft auf EBusiness festgelegt ist, müssen die Clients das Kennwort für einen Oracle E-Business Suite-Benutzer angeben. Hinweis: Der Oracle E-Business-Adapter behält den Wert nicht bei, den Sie für das Kennwort eingeben, wenn er eine Verbindung mit Oracle E-Business Suite herstellt. Der Benutzername wird unter Verwendung der Standardregeln von SQL*Plus an Oracle E-Business Suite übergeben. Wenn Sie jedoch den Fall des Kennworts beibehalten möchten oder ein Kennwort mit Sonderzeichen eingeben möchten, müssen Sie den Wert in doppelten Anführungszeichen angeben.
[NET_SERVICE_NAME] hostinfoparams Ein Net-Dienstname, der in der Datei tnsnames.ora auf dem Computer angegeben wird, auf dem der Oracle E-Business-Adapter installiert ist. Informationen zu Net-Dienstnamen und tnsnames.ora finden Sie unter Konfigurieren des Oracle-Clients für den E-Business Suite-Adapter.

Herstellen einer Verbindung ohne Verwendung von tnsnames.ora

Wichtig

  • Für diesen Ansatz müssen Sie nicht über den Namen des Net-Diensts in tnsnames.ora verfügen. Außerdem müssen Sie nicht einmal die Datei tnsnames.ora auf dem Computer haben, auf dem der Adapterclient installiert ist.
    • Dieser Konnektivitätsmodus wird nicht unterstützt, wenn Sie Vorgänge in einer Transaktion ausführen. Dies ist auf eine Einschränkung des Oracle-Clients zurückzuführen.

Ein typischer Endpunktadress-URI in WCF wird wie folgt dargestellt: scheme://userauthparams@hostinfoparams

  • scheme ist der Schemaname.

  • userauthparams 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. z. B. Servername, Portnummer usw.

    Der Oracle E-Business-Adapterverbindungs-URI entspricht diesem grundlegenden Format und wird wie folgt implementiert:

oracleebs://User=[USER_NAME];Password=[PASSWORD]@[SERVER_NAME]:[PORT_NUMBER]/[SERVICE_NAME]/[SERVICE_TYPE]

In der folgenden Tabelle werden die Im Verbindungs-URI enthaltenen Eigenschaften erläutert.

Verbindungs-URI-Eigenschaft Category BESCHREIBUNG
[USER_NAME] userauthparams Der Benutzername, der für die Authentifizierung verwendet werden soll. Der Oracle E-Business-Adapter macht eine ClientCredentialType-Bindungseigenschaft verfügbar, die den Typ der Oracle-Clientanmeldeinformationen angibt, die der Client zum Herstellen einer Verbindung angibt. Die möglichen Werte für die ClientCredentialType-Bindungseigenschaft sind Database und EBusiness. Abhängig vom Wert für diese Bindungseigenschaft müssen Sie relevante Anmeldeinformationen angeben. Weitere Informationen finden Sie unter Oracle-Anmeldeinformationen und verbindungs-URI. Hinweis: Sie müssen die AcceptCredentialsInUri-Bindungseigenschaft auf true festlegen, um den Benutzernamen und das Kennwort im Verbindungs-URI anzugeben. Hinweis: Der Oracle E-Business-Adapter behält nicht die Groß-/Kleinschreibung des Werts bei, den Sie für den Benutzernamen eingeben, wenn er eine Verbindung mit Oracle E-Business Suite herstellt. Der Benutzername wird unter Verwendung der Standardregeln von SQL*Plus an Oracle E-Business Suite übergeben. Wenn Sie jedoch die Groß-/Kleinschreibung des Benutzernamens beibehalten möchten oder einen Benutzernamen mit Sonderzeichen eingeben möchten, müssen Sie den Wert in doppelten Anführungszeichen angeben.
[KENNWORT] userauthparams Das Kennwort, das für die Authentifizierung verwendet werden soll. Der Oracle E-Business-Adapter macht eine ClientCredentialType-Bindungseigenschaft verfügbar, die den Typ der Oracle-Clientanmeldeinformationen angibt, die der Client zum Herstellen einer Verbindung angibt. Wenn die ClientCredentialType-Eigenschaft auf Database festgelegt ist, müssen die Clients das Kennwort für einen Oracle-Datenbankbenutzer angeben. Wenn die ClientCredentialType-Eigenschaft auf EBusiness festgelegt ist, müssen die Clients das Kennwort für einen Oracle E-Business Suite-Benutzer angeben. Hinweis: Der Oracle E-Business-Adapter behält den Wert nicht bei, den Sie für das Kennwort eingeben, wenn er eine Verbindung mit Oracle E-Business Suite herstellt. Der Benutzername wird unter Verwendung der Standardregeln von SQL*Plus an Oracle E-Business Suite übergeben. Wenn Sie jedoch den Fall des Kennworts beibehalten möchten oder ein Kennwort mit Sonderzeichen eingeben möchten, müssen Sie den Wert in doppelten Anführungszeichen angeben.
[SERVER_NAME] hostinfoparams Name des Servers, auf dem die Oracle E-Business Suite ausgeführt wird. Diese ist obligatorisch.
[PORT_NUMBER] hostinfoparams Der Oracle Net Listener-Port. Der Standardwert 1521.
[SERVICE_NAME] hostinfoparams Der Name des Oracle-Datenbankdiensts. Diese ist obligatorisch.
[SERVICE_TYPE] hostinfoparams Der Typ des Oracle-Diensts. Die möglichen Werte sind Dedicated oder Shared. Ein dedizierter Dienst verwendet einen dedizierten Serverprozess, um nur einen Benutzerprozess zu bedienen. Ein gemeinsam genutzter Dienst verwendet einen freigegebenen Serverprozess, der mehrere Benutzerprozesse bedienen kann. Der Standardwert ist Dediziert.

Oracle-Anmeldeinformationen und der Verbindungs-URI

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

Wichtig

Aufgrund der Sicherheitsrisiken, die durch die Übergabe von Anmeldeinformationen in Zeichenfolgen als Nur-Text entstehen, sollten Sie die Angabe von Oracle-Datenbankverbindungsanmeldeinformationen im Verbindungs-URI vermeiden. Weitere Informationen zum sichereren Bereitstellen von Anmeldeinformationen für die Oracle-Datenbank finden Sie unter Schützen Ihrer Oracle EBS-Anwendungen.

Sie können auch die Datenbankanmeldeinformationen oder die Oracle E-Business Suite-Anmeldeinformationen angeben, um eine Verbindung mit Oracle E-Business Suite herzustellen. Der Adapter macht drei Bindungseigenschaften verfügbar, um dieses Verhalten zu aktivieren: ClientCredentialType, OracleUserName, OraclePassword.

Die möglichen Werte für die ClientCredentialType-Bindungseigenschaft sind Database und EBusiness.

  • Wenn die ClientCredentialType-Eigenschaft auf Database festgelegt ist, müssen die Clients die Datenbankanmeldeinformationen angeben.

  • Wenn die ClientCredentialType-Eigenschaft auf EBusiness festgelegt ist, müssen die Clients die Oracle E-Business Suite-Anmeldeinformationen angeben. In diesem Fall müssen die Adapterclients auch die Datenbankanmeldeinformationen für die Bindungseigenschaften OracleUserName und OraclePassword angeben.

Wichtig

In Szenarien, in denen die Adapterclients die Datenbankanmeldeinformationen angeben, um eine Verbindung mit Oracle E-Business Suite herzustellen, indem sie die ClientCredentialType-Bindungseigenschaft auf Database festlegen, aber ein Oracle E-Business Suite-Artefakt aufrufen, werden die für die Bindungseigenschaften OracleUserName und OraclePassword angegebenen Werte zum Festlegen des Anwendungskontexts verwendet. Das Festlegen des Anwendungskontexts ist für das Aufrufen von Artefakten in Oracle E-Business Suite obligatorisch. Weitere Informationen zum Festlegen des Anwendungskontexts finden Sie unter Festlegen des Anwendungskontexts.

Verwenden reservierter Zeichen im Verbindungs-URI

Der Oracle E-Business-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 Oracle E-Business Suite

Es folgt ein Beispiel für einen Verbindungs-URI für den Oracle E-Business-Adapter mit tnsnames.ora.

oracleebs://ADAPTER

In diesem Beispiel ist ADAPTER ein Netzdienstname, der dem DIENSTNAMEN und den Verbindungsinformationen für die Oracle-Zieldatenbank in tnsnames.ora zugeordnet ist.

Im Folgenden ist ein Beispiel für einen Verbindungs-URI für den Oracle E-Business-Adapter ohne Verwendung von tnsnames.ora aufgeführt.

oracleebs://yourOracleServer:1521/yourOracleDatabaseServiceName/Dedicated

In diesem Beispiel lautet der Servername "yourOracleServer" und der Dienstname "yourOracleDatabaseServiceName".

Informationen dazu, wie Sie eine Verbindung mit Oracle E-Business Suite herstellen, wenn Sie:

Weitere Informationen

Konfigurieren des Oracle-Clients für den E-Business Suite-Adapter
Herstellen einer Verbindung mit Oracle E-Business Suite mithilfe der Windows-Authentifizierung
Erstellen einer Verbindung mit Oracle E-Business Suite