Festlegen des Anwendungskontexts

In Microsoft BizTalk Adapter for Oracle E-Business Suite ist das Festlegen des Anwendungskontexts für einige Artefakte der Oracle E-Business Suite (Schnittstellentabellen, Schnittstellenansichten, gleichzeitige Programme und Anforderungssätze) obligatorisch, bevor Sie Vorgänge für sie ausführen können. Mit dem Oracle E-Business-Adapter können Sie Erst dann Vorgänge für diese Artefakte ausführen, wenn Sie den Anwendungskontext festgelegt haben. Bei Artefakten in der zugrunde liegenden Oracle-Datenbank liegt es jedoch beim Benutzer, ob er den Anwendungskontext festlegen möchte oder nicht.

Was ist der Anwendungskontext?

Der Anwendungskontext besteht aus einer Reihe von Elementen, die einem Artefakt in Oracle E-Business Suite zugeordnet sind, das Benutzereinstellungen und Zugriffssteuerung für das Artefakt implementiert. Der Anwendungskontext besteht aus den folgenden Elementen:

• Benutzername: Ein Benutzer, der eine Verbindung mit Oracle E-Business Suite herstellen kann.

• Verantwortung: Eine Verantwortung ist eine Zugriffsebene in Oracle E-Business Suite, die es Benutzern ermöglicht, nur auf die Daten und Funktionen zuzugreifen, die für ihre Rollen in einem organization geeignet sind. Zuständigkeiten können den Zugriff auf eine bestimmte Anwendung, Betriebseinheiten, Eine Reihe von Büchern und eine eingeschränkte Liste von Fenstern, Funktionen und anderen Zuständigkeiten ermöglichen. Durch die Zuweisung von Verantwortlichkeiten zu einem Benutzer können Sie dem Benutzer den Zugriff in Oracle E-Business Suite gewähren bzw. einschränken.

• Organisations-ID: Oracle E-Business Suite unterstützt die Einrichtung mehrerer Organisationen. Diese verschiedenen Organisationen werden eindeutig durch den Wert Organisations-ID in der spalte Org_ID der Tabelle in Oracle E-Business Suite identifiziert, in der Informationen zu diesen Organisationen gespeichert sind. Wenn Sie einem organization eine Verantwortung zuweisen oder explizit eine organization auswählen, können Sie einem Benutzer den Zugriff auf einen organization gewähren bzw. einschränken.

  Weitere Informationen zur Verantwortung, zu mehreren Organisationen und zur Organisations-ID in Oracle E-Business Suite finden Sie im Oracle Help Center.

Festlegen des Anwendungskontexts

Wenn der Oracle E-Business-Adapter eine Verbindung mit der zugrunde liegenden Datenbank in der Oracle E-Business Suite herstellt, wird der Anwendungskontext für die Oracle E-Business Suite-Artefakte nicht im Adapter eingerichtet oder initialisiert. Sie können den Anwendungskontext für diese Artefakte im Oracle E-Business-Adapter initialisieren oder festlegen, indem Sie eine der folgenden Aktionen verwenden:

• Bindungseigenschaften: Der Oracle E-Business-Adapter macht die folgenden Bindungseigenschaften zum Festlegen des Anwendungskontexts verfügbar: OracleEBSOrganizationId, OracleUserName, OraclePassword, OracleEBSResponsibilityKey, OracleEBSResponsibilityName und ApplicationShortName. Sie müssen keine Werte für alle diese Bindungseigenschaften angeben, um den Anwendungskontext für verschiedene Artefakte festzulegen. Informationen zu den Bindungseigenschaften, die zum Festlegen des Anwendungskontexts für ein Artefakt erforderlich sind, finden Sie weiter unten in diesem Thema unter Bindungseigenschaften für das Festlegen des Anwendungskontexts für verschiedene Artefakte .

• Nachrichtenkontexteigenschaften: Der Oracle E-Business-Adapter macht die folgenden Nachrichtenkontexteigenschaften zum Festlegen des Anwendungskontexts verfügbar: ApplicationShortName, OrganizationID, ResponsibilityKey und ResponsibilityName. Zum Angeben des Benutzernamens und des Kennworts müssen Sie die Bindungseigenschaften verwenden. Informationen zum Festlegen des Anwendungskontexts mithilfe von Nachrichtenkontexteigenschaften finden Sie unter Konfigurieren des Anwendungskontexts mithilfe von Nachrichtenkontexteigenschaften.

Wichtig

Der für die OracleEBSResponsibilityKey-Bindungseigenschaft angegebene Wert überschreibt den Wert der OracleEBSResponsibilityName-Bindungseigenschaft . Auf ähnliche Weise überschreibt der für die Eigenschaft "ResponsibilityKey-Nachrichtenkontext " angegebene Wert den wert, der für die Eigenschaft "ResponsibilityName "-Nachrichtenkontext angegeben wurde.

Rangfolge (Bindungseigenschaften im Vergleich zu Nachrichtenkontexteigenschaften)

Wenn Sie den Anwendungskontext sowohl mithilfe der Bindungseigenschaften als auch der Nachrichtenkontexteigenschaften festlegen, haben die für Nachrichtenkontexteigenschaften angegebenen Werte Vorrang und überschreiben die für die Bindungseigenschaften angegebenen Werte. Wenn Sie jedoch beispielsweise den Kurznamen der Anwendung als Nachrichtenkontexteigenschaft und die anderen als Bindungseigenschaften angeben, wird nur der Wert für den Kurznamen der Anwendung aus der Nachrichtenkontexteigenschaft übernommen, und der Rest wird aus den relevanten Bindungseigenschaften ausgewählt.

Rangfolge für den Kurznamen der Anwendung

Beim Festlegen des Anwendungskontexts wird der Kurzname der Anwendung in der folgenden Rangfolge verwendet (höchste bis niedrigste):

• Der in der ApplicationShortName-Nachrichtenkontexteigenschaft angegebene Kurzname der Anwendung.

• Der in der SOAP-Aktion angegebene Kurzname der Anwendung (nur für Schnittstellentabellen, Schnittstellenansichten, gleichzeitige Programme und Anforderungssätze).

• Der in der ApplicationShortName-Bindungseigenschaft angegebene Kurzname der Anwendung.

  Für Schnittstellentabellen, Schnittstellenansichten, gleichzeitige Programme und Anforderungssätze gilt diese Rangfolge jedoch nur beim Festlegen des Anwendungskontexts. Zum Identifizieren der Schnittstellentabellen, Schnittstellenansichten, gleichzeitigen Programme und Anforderungssätze wird der Kurzname der Anwendung in der SOAP-Aktion verwendet.

  Rangfolge für Verantwortungsschlüssel und Verantwortungsname

  Beim Festlegen des Anwendungskontexts werden der Verantwortungsschlüssel und der Verantwortungsname in der folgenden Rangfolge verwendet (höchste bis niedrigste):

• Der in der Eigenschaft "ResponsibilityKey "-Nachrichtenkontext angegebene Verantwortungsschlüssel.The responsibility key specified in the ResponsibilityKey message context property.

• Der in der Eigenschaft "ResponsibilityName "-Nachrichtenkontext angegebene Verantwortungsname.

• Der in der OracleEBSResponsibilityKey-Bindungseigenschaft angegebene Verantwortungsschlüssel.

• Der in der OracleEBSResponsibilityName-Bindungseigenschaft angegebene Verantwortungsname .

Tipp

Gründe für die Verwendung von Nachrichtenkontexteigenschaften gegenüber Bindungseigenschaften, um den Anwendungskontext festzulegen? Wenn Sie den Anwendungskontext mithilfe von Bindungseigenschaften festlegen, kann der WCF-Custom Sendeport für den Oracle E-Business-Adapter nur für die spezifische organization ID, Verantwortung und Anwendung verwendet werden, die Sie für die Bindungseigenschaften angegeben haben. Im Gegenteil, wenn Sie die Nachrichtenkontexteigenschaft verwenden, können Sie einen "generischen" WCF-Custom Sendeport konfigurieren und den Anwendungskontext auf Nachrichtenebene festlegen.

Festlegen des Anwendungskontexts für Schnittstellentabellen, Schnittstellensichten, gleichzeitige Programme und Anforderungssätze (obligatorisch)

Sie müssen den Anwendungskontext festlegen, bevor Sie Vorgänge für Schnittstellentabellen, Schnittstellenansichten, gleichzeitige Programme und Anforderungssätze im Oracle E-Business-Adapter ausführen. Dazu müssen Sie die entsprechenden Werte für die Bindungseigenschaften oder die Nachrichtenkontexteigenschaften angeben, wie zuvor angegeben.

Wichtig

Sie können keine Vorgänge für Schnittstellentabellen, Schnittstellenansichten, gleichzeitige Programme und Anforderungssätze ausführen, es sei denn, Sie haben geeignete Werte für die erforderlichen Bindungseigenschaften oder die Nachrichtenkontexteigenschaften festgelegt.

Festlegen des Anwendungskontexts für PL/SQL-APIs, Prozeduren, Funktionen, Tabellen und Sichten

• PL/SQL-APIs: Der Oracle E-Business-Adapter macht PL/SQL-APIs verfügbar, die der Oracle-Datenbank sowie der Oracle E-Business Suite-Anwendung zugeordnet sind. Obwohl es optional ist, den Anwendungskontext für die PL/SQL-APIs festzulegen, die der Oracle-Datenbank zugeordnet sind, ist es obligatorisch, den Anwendungskontext für die PL/SQL-APIs festzulegen, die der Oracle E-Business Suite-Anwendung zugeordnet sind.

• Prozeduren und Funktionen: Es ist nicht zwingend erforderlich, den Anwendungskontext so festzulegen, dass Vorgänge für Prozeduren und Funktionen in der Oracle-Datenbank ausgeführt werden.

• Tabellen und Sichten: Es ist nicht zwingend erforderlich, den Anwendungskontext festzulegen, um Vorgänge für Tabellen und Sichten in der Oracle-Datenbank auszuführen. Bei einer benutzerdefinierten Oracle E-Business Suite-Anwendung können Benutzer die Basisdatenbanktabellen jedoch als Schnittstellentabellen registrieren. Wenn eine Datenbanktabelle nicht als Schnittstellentabelle registriert ist, wird sie zusammen mit den Datenbanktabellen im Oracle E-Business-Adapter angezeigt. Da diese Tabellen einer Oracle E-Business-Anwendung zugeordnet sind, müssen Sie für jeden Vorgang in diesen Tabellen den Anwendungskontext festlegen.

  Um den Anwendungskontext für diese Artefakte festzulegen, müssen Sie die entsprechenden Werte für die Bindungseigenschaften oder die Nachrichtenkontexteigenschaften angeben, wie zuvor angegeben.

Festlegen des Anwendungskontexts für Poll-, ExecuteNonQuery-, ExecuteReader-, ExecuteScalar- und Zusammengesetzte Vorgänge

Abgesehen von den Artefakten können Sie auch den Anwendungskontext für verschiedene Vorgänge festlegen, die für diese Artefakte ausgeführt werden.

• Um den Anwendungskontext für den Abfragevorgang festzulegen, können Sie nur die Bindungseigenschaften wie zuvor angegeben verwenden. Zum Festlegen des Anwendungskontexts müssen Sie geeignete Werte für die Bindungseigenschaften angeben, die für das Artefakt gelten, für das der Abfragevorgang ausgeführt wird. Wenn beispielsweise der Poll-Vorgang für eine Schnittstellentabelle ausgeführt wird, müssen Sie Werte für die Bindungseigenschaften für die Schnittstellentabelle angeben.

• Um den Anwendungskontext für die Vorgänge ExecuteNonQuery, ExecuteReader und ExecuteScalar festzulegen, müssen Sie die entsprechenden Werte für die Bindungseigenschaften oder die Zuvor angegebenen Nachrichtenkontexteigenschaften angeben. Zum Festlegen des Anwendungskontexts für diese Vorgänge müssen Sie geeignete Werte für die Bindungseigenschaften oder die Nachrichtenkontexteigenschaften angeben, die für das Artefakt gelten, für das die Vorgänge ausgeführt werden.

• Um den Anwendungskontext für zusammengesetzte Vorgänge festzulegen, müssen Sie die entsprechenden Werte für die Bindungseigenschaften oder die Zuvor angegebenen Nachrichtenkontexteigenschaften angeben. Zum Festlegen des Anwendungskontexts für zusammengesetzte Vorgänge müssen Sie geeignete Werte für die Bindungseigenschaften oder die Nachrichtenkontexteigenschaften angeben, die für die einzelnen Vorgänge gelten. Wenn ein zusammengesetzter Vorgang beispielsweise zwei Vorgänge enthält: einen für die Schnittstellentabelle und den anderen für die Datenbanktabelle, dann müssen Sie Werte für die Bindungseigenschaften oder die Nachrichtenkontexteigenschaften für die Schnittstellentabelle sowie die Bindungseigenschaften oder die Nachrichtenkontexteigenschaften für die Datenbanktabelle angeben.

  Wichtig

  Für alle diese Vorgänge ist es obligatorisch, den Anwendungskontext festzulegen, wenn der Vorgang für ein Artefakt in Oracle E-Business Suite (Schnittstellentabelle, Schnittstellenansicht, gleichzeitige Programme oder Anforderungssätze) ausgeführt wird. Wenn der Vorgang für ein Artefakt in der zugrunde liegenden Datenbank ausgeführt wird, ist es nicht zwingend erforderlich, den Anwendungskontext festzulegen. Wenn Sie beispielsweise den Poll-Vorgang für eine Schnittstellentabelle ausführen, ist es obligatorisch, den Anwendungskontext festzulegen. Wenn der Abfragevorgang für eine Tabelle ausgeführt wird, ist es nicht zwingend erforderlich, den Anwendungskontext festzulegen.

Festlegen der Sprache für die Ausführung von Vorgängen

Der Oracle E-Business-Adapter unterstützt die MlS-Funktion (Multi-Language Support) der Oracle E-Business Suite und ermöglicht es Ihnen, eine Sprache während der Ausführung von Vorgängen anzugeben. Der Adapter macht die Language-Bindungseigenschaft unter der MlsSettings-Bindungseigenschaft und die Sprachnachrichtenkontexteigenschaft verfügbar, um eine Sprache für die Ausführung von Vorgängen anzugeben.

Der für die Sprachnachrichtenkontexteigenschaft angegebene Wert überschreibt den Wert der Language-Bindungseigenschaft unter der MlsSettings-Bindungseigenschaft . Weitere Informationen zur MlsSettings-Bindungseigenschaft finden Sie unter Informationen zu Den Bindungseigenschaften des BizTalk-Adapters für Oracle E-Business Suite.

Bindungseigenschaften zum Festlegen des Anwendungskontexts für verschiedene Artefakte

Die folgende Tabelle enthält Informationen zu den Bindungseigenschaften, für die Sie geeignete Werte angeben müssen, um den Anwendungskontext für verschiedene Artefakte festzulegen:

Artifacts	OracleEBSOrganizationId	OracleUserName	OraclePassword	OracleEBSResponsibilityKey oder OracleEBSResponsibilityName	ApplicationShortName
Schnittstellentabellen und Schnittstellensichten	√*	√	√	√
Gleichzeitige Programme	√*	√	√	√
Anforderungssätze	√*	√	√	√
PL/SQL-APIs	√*	√	√	√	√
Prozeduren und Funktionen	√*	√	√	√	√
Tabellen und Sichten	√*	√	√	√	√

√* = Optional

Wichtig

• Der Standardwert der Bindungseigenschaft OracleEBSOrganizationId (optional) ist NULL. Wenn Sie einen Wert für die Bindungseigenschaft OracleEBSOrganizationId angeben, legt der Oracle E-Business-Adapter die ORG_ID der Sitzung auf diesen Wert fest, während der Anwendungskontext festgelegt wird.
  • Der für die OracleEBSResponsibilityKey-Bindungseigenschaft angegebene Wert überschreibt den für die Bindungseigenschaft OracleEBSResponsibilityName angegebenen Wert.

Ausführliche Informationen zu den einzelnen Bindungseigenschaften finden Sie unter Informationen zum BizTalk-Adapter für Oracle E-Business Suite-Bindungseigenschaften.

Weitere Informationen

Welche Vorgänge können mit dem Adapter ausgeführt werden?