アプリケーションのコンテキストを設定する

Microsoft BizTalk Adapter for Oracle E-Business Suite では、一部の Oracle E-Business Suite 成果物 (インターフェイス テーブル、インターフェイス ビュー、同時実行プログラム、および要求セット) で操作を実行する前に、アプリケーション コンテキストの設定が必須です。 Oracle E-Business アダプターでは、アプリケーション コンテキストを設定するまで、これらの成果物に対する操作を実行できません。 ただし、基になる Oracle データベース内の成果物の場合、アプリケーション コンテキストを設定するかどうかはユーザーの責任です。

アプリケーション コンテキストとは

アプリケーション コンテキストは、成果物に対するユーザー設定とアクセス制御を実装する Oracle E-Business Suite の成果物に関連付けられた一連の要素です。 アプリケーション コンテキストは、次の要素で構成されます。

• ユーザー名: Oracle E-Business Suite に接続できるユーザー。

• 責任: 責任とは、ユーザーがorganizationの役割に適したデータと機能にのみアクセスできる Oracle E-Business Suite のアクセス レベルです。 責任により、特定のアプリケーション、運用単位、書籍のセット、およびウィンドウ、機能、およびその他の責任の制限されたリストにアクセスできます。 ユーザーに責任を割り当てることにより、Oracle E-Business Suite でユーザーのアクセスを許可または制限できます。

• 組織 ID: Oracle E-Business Suite では、複数の組織の設定がサポートされています。 これらの異なる組織は、これらの組織に関する情報を格納する Oracle E-Business Suite のテーブルのOrg_ID列にある値 Organization ID によって一意に識別されます。 organizationに責任を割り当てるか、organizationを明示的に選択することで、ユーザーのアクセスをorganizationに許可または制限できます。

  Oracle E-Business Suite の責任、複数の組織、組織 ID の詳細については、 Oracle ヘルプ センターを検索してください。

アプリケーション コンテキストの設定

Oracle E-Business アダプターが Oracle E-Business Suite の基になるデータベースに接続するため、Oracle E-Business Suite 成果物のアプリケーション コンテキストはアダプターで確立または初期化されません。 次のいずれかを使用して、Oracle E-Business アダプターでこれらの成果物のアプリケーション コンテキストを初期化または設定できます。

• バインド プロパティ: Oracle E-Business アダプターは、アプリケーション コンテキストを設定するためのバインディング プロパティとして、 OracleEBSOrganizationId、 OracleUserName、 OraclePassword、 OracleEBSResponsibilityKey、 OracleEBSResponsibilityName、 ApplicationShortName を公開します。 さまざまな成果物のアプリケーション コンテキストを設定するために、これらすべてのバインド プロパティの値を指定する必要はありません。 成果物のアプリケーション コンテキストを設定するために必要なバインド プロパティの詳細については、このトピックで後述する「 さまざまな成果物のアプリケーション コンテキストを設定するためのバインド プロパティ 」を参照してください。

• メッセージ コンテキスト プロパティ: Oracle E-Business アダプターは、アプリケーション コンテキストを設定するためのメッセージ コンテキスト プロパティ ApplicationShortName、 OrganizationID、 ResponsibilityKey、 および ResponsibilityName を公開します。 ユーザー名とパスワードを指定するには、バインド プロパティを使用する必要があります。 メッセージ コンテキスト プロパティを使用してアプリケーション コンテキストを設定する方法については、「メッセージ コンテキスト プロパティを 使用してアプリケーション コンテキストを構成する」を参照してください。

重要

OracleEBSResponsibilityKey バインディング プロパティに指定された値は、OracleEBSResponsibilityName バインディング プロパティの値をオーバーライドします。 同様に、 ResponsibilityKey メッセージ コンテキスト プロパティに指定された値は、 ResponsibilityName メッセージ コンテキスト プロパティに指定された値よりも優先されます。

優先順位 (バインディング プロパティとメッセージ コンテキスト プロパティ)

バインド プロパティとメッセージ コンテキスト プロパティの両方を使用してアプリケーション コンテキストを設定した場合、メッセージ コンテキスト プロパティに指定された値が優先され、バインド プロパティに指定された値がオーバーライドされます。 ただし、たとえば、アプリケーションの短い名前をメッセージ コンテキスト プロパティとして指定し、その他をバインド プロパティとして指定した場合、アプリケーションの短い名前の値のみがメッセージ コンテキスト プロパティから取得され、残りの値は関連するバインド プロパティから取得されます。

アプリケーションの短い名前の優先順位

アプリケーション コンテキストの設定中に、アプリケーションの短い名前が次の優先順位 (最高から最低) で使用されます。

• ApplicationShortName メッセージ コンテキスト プロパティで指定されたアプリケーションの短い名前。

• SOAP アクションで指定されたアプリケーションの短い名前 (インターフェイス テーブル、インターフェイス ビュー、同時実行プログラム、および要求セットの場合のみ)。

• ApplicationShortName バインド プロパティで指定されたアプリケーションの短い名前。

  ただし、インターフェイス テーブル、インターフェイス ビュー、同時実行プログラム、および要求セットの場合、この優先順位はアプリケーション コンテキストの設定中にのみ適用されます。 インターフェイス テーブル、インターフェイス ビュー、同時実行プログラム、および要求セットを識別するために、SOAP アクションのアプリケーションの短い名前が使用されます。

  責任キーと責任名の優先順位

  アプリケーション コンテキストの設定中に、責任キーと責任名は次の優先順位 (最高から最低) で使用されます。

• ResponsibilityKey メッセージ コンテキスト プロパティで指定された責任キー。

• ResponsibilityName メッセージ コンテキスト プロパティで指定された責任名。

• OracleEBSResponsibilityKey バインディング プロパティで指定された責任キー。

• OracleEBSResponsibilityName バインディング プロパティで指定された責任名。

ヒント

バインド プロパティに対してメッセージ コンテキスト プロパティを使用してアプリケーション コンテキストを設定する理由 バインド プロパティを使用してアプリケーション コンテキストを設定した場合、Oracle E-Business アダプターの WCF-Custom 送信ポートは、バインド プロパティに指定した特定のorganization ID、責任、およびアプリケーションにのみ使用できます。 逆に、メッセージ コンテキスト プロパティを使用する場合は、送信ポート WCF-Custom "汎用" を構成し、メッセージ レベルでアプリケーション コンテキストを設定できます。

インターフェイス テーブル、インターフェイス ビュー、同時実行プログラム、および要求セットのアプリケーション コンテキストの設定 (必須)

Oracle E-Business アダプターでインターフェイス テーブル、インターフェイス ビュー、同時実行プログラム、および要求セットに対して操作を実行する前に、アプリケーション コンテキストを設定する必要があります。 これを行うには、前に指定したバインディング プロパティまたはメッセージ コンテキスト プロパティに適切な値を指定する必要があります。

重要

必要なバインディング プロパティまたはメッセージ コンテキスト プロパティに適切な値を設定していない限り、インターフェイス テーブル、インターフェイス ビュー、同時実行プログラム、および要求セットに対して操作を実行することはできません。

PL/SQL API、プロシージャ、関数、テーブル、ビューのアプリケーション コンテキストの設定

• PL/SQL API: Oracle E-Business アダプターは、Oracle データベースと Oracle E-Business Suite アプリケーションに関連付けられている PL/SQL API を公開します。 Oracle データベースに関連付けられている PL/SQL API のアプリケーション コンテキストを設定することは省略可能ですが、Oracle E-Business Suite アプリケーションに関連付けられている PL/SQL API のアプリケーション コンテキストを設定することが必須です。

• プロシージャと関数: Oracle データベース内のプロシージャと関数に対して操作を実行するようにアプリケーション コンテキストを設定することは必須ではありません。

• テーブルとビュー: Oracle データベースのテーブルとビューに対して操作を実行するようにアプリケーション コンテキストを設定することは必須ではありません。 ただし、カスタム Oracle E-Business Suite アプリケーションの場合、ユーザーはベース データベース テーブルをインターフェイス テーブルとして登録する場合と登録しない場合があります。 データベース テーブルがインターフェイス テーブルとして登録されていない場合は、Oracle E-Business アダプターのデータベース テーブルと共に表示されます。 これらのテーブルは Oracle E-Business アプリケーションに関連付けられているため、これらのテーブルに対する操作の場合は、アプリケーション コンテキストを設定する必要があります。

  これらの成果物のアプリケーション コンテキストを設定するには、前に指定したバインディング プロパティまたはメッセージ コンテキスト プロパティに適切な値を指定する必要があります。

ポーリング、ExecuteNonQuery、ExecuteReader、ExecuteScalar、および複合操作のアプリケーション コンテキストの設定

成果物とは別に、これらの成果物に対して実行されるさまざまな操作のアプリケーション コンテキストを設定することもできます。

• Poll 操作のアプリケーション コンテキストを設定するには、前に指定したバインディング プロパティのみを使用できます。 アプリケーション コンテキストを設定するには、Poll 操作が実行される成果物に適用できるバインディング プロパティに適切な値を指定する必要があります。 たとえば、インターフェイス テーブルに対して Poll 操作を実行する場合は、インターフェイス テーブルのバインド プロパティの値を指定する必要があります。

• ExecuteNonQuery、ExecuteReader、ExecuteScalar 操作のアプリケーション コンテキストを設定するには、前に指定したバインディング プロパティまたはメッセージ コンテキスト プロパティに適切な値を指定する必要があります。 これらの操作のアプリケーション コンテキストを設定するには、バインド プロパティまたは操作を実行する成果物に適用できるメッセージ コンテキスト プロパティに適切な値を指定する必要があります。

• 複合操作のアプリケーション コンテキストを設定するには、前に指定したバインディング プロパティまたはメッセージ コンテキスト プロパティに適切な値を指定する必要があります。 複合操作のアプリケーション コンテキストを設定するには、バインド プロパティまたは個々の操作に適用できるメッセージ コンテキスト プロパティに適切な値を指定する必要があります。 たとえば、複合操作にインターフェイス テーブルとデータベース テーブルの 2 つの操作が含まれている場合は、バインディング プロパティまたはインターフェイス テーブルのメッセージ コンテキスト プロパティ、およびデータベース テーブルのバインド プロパティまたはメッセージ コンテキスト プロパティの値を指定する必要があります。

  重要

  これらのすべての操作について、操作が Oracle E-Business Suite の成果物 (インターフェイス テーブル、インターフェイス ビュー、同時実行プログラム、または要求セット) に対して実行される場合は、アプリケーション コンテキストを設定する必要があります。 操作が基になるデータベースの成果物に対して実行される場合、アプリケーション コンテキストを設定することは必須ではありません。 たとえば、インターフェイス テーブルで Poll 操作を実行する場合は、アプリケーション コンテキストを設定する必要があります。一方、Poll 操作がテーブルに対して実行される場合、アプリケーション コンテキストを設定することは必須ではありません。

操作を実行するための言語の設定

Oracle E-Business アダプターは、Oracle E-Business Suite の多言語サポート (MLS) 機能をサポートしており、操作の実行中に言語を指定できます。 アダプターは、MlsSettings バインド プロパティと Language メッセージ コンテキスト プロパティの下に Language バインディング プロパティを公開して、操作を実行する言語を指定します。

Language メッセージ コンテキスト プロパティに指定された値は、MlsSettings バインド プロパティの Language バインディング プロパティの値をオーバーライドします。 MlsSettings バインド プロパティの詳細については、「BizTalk Adapter for Oracle E-Business Suite Binding Properties」を参照してください。

さまざまな成果物のアプリケーション コンテキストを設定するためのバインド プロパティ

次の表に、さまざまな成果物のアプリケーション コンテキストを設定するために適切な値を指定する必要があるバインディング プロパティに関する情報を示します。

Artifacts	OracleEBSOrganizationId	OracleUserName	OraclePassword	OracleEBSResponsibilityKey または OracleEBSResponsibilityName	ApplicationShortName
インターフェイス テーブルとインターフェイス ビュー	√*	√	√	√
同時実行プログラム	√*	√	√	√
要求セット	√*	√	√	√
PL/SQL API	√*	√	√	√	√
プロシージャと関数	√*	√	√	√	√
[テーブルとビュー]	√*	√	√	√	√

√* = 省略可能

重要

• OracleEBSOrganizationId バインディング プロパティの既定値 (省略可能) は null です。 OracleEBSOrganizationId バインド プロパティの値を指定した場合、Oracle E-Business アダプターは、アプリケーション コンテキストの設定中にセッションのORG_IDをこの値に設定します。
  • OracleEBSResponsibilityKey バインド プロパティに指定された値は、OracleEBSResponsibilityName バインド プロパティに指定された値をオーバーライドします。

これらのバインド プロパティの詳細については、「 BizTalk Adapter for Oracle E-Business Suite Binding Properties」を参照してください。

参照

アダプターを使用して実行できる操作