※ 本記事は、Kornana Shanmukhによる”Oracle APEX 26.2: Simplifying ADF and BOSS Integration with the Fusion Starter Application“を翻訳したものです。

2026年11月9日

Oracle APEXでは、シングルサインオンとIDの引き継ぎに対応するFusion ApplicationsのREST APIを使い、Oracle Fusionアプリケーションを拡張できます。Oracle APEXのFusionスターターアプリケーションには、認証スキーム、Web Credential、RESTデータソースのサンプルを設定済みで用意しており、開発の出発点として利用できます。設定手順は、APEXとFusion Applicationsの連携に関するOracle APEXドキュメントで説明しています。

Fusion Applicationsでは、Oracle Application Development Framework（ADF）に基づくRESTエンドポイントと、Business Object Spectra Service（BOSS）のエンドポイントを公開しています。通常、ADFはURLに/resources/、BOSSは/api/boss/を含みます。どちらも、作成、取得、更新、削除などの類似した操作に対応していますが、パラメーター名ややり取りの方法など、リクエストの構造は異なります。APEXでは、それぞれに適したRESTデータソース型を用意し、扱いやすくしています。

Oracle APEX 26.2では、1回のサインインで、同じアプリケーションからADFとBOSSのサービスへアクセスする設定を簡素化しました。拡張されたFusion連携スターターアプリケーションでは、利用可能なADF／BOSSリソースの認証を設定し、対応するスコープを使うRESTデータソースを作成します。BOSSのデータを表示するサンプルページも含みます。両方を利用する拡張アプリケーションを作る際、認証を手動で設定する作業を減らせます。

Oracle APEX 26.2の新機能

APEX 24.2では、Fusion ApplicationsのBOSS RESTサービスに接続するRESTデータソースに対応しました。ただし、26.2より前のFusion連携スターターアプリケーションで生成する設定は、主にADF RESTサービス向けでした。同じアプリケーションでADFとBOSSを併用するには、認証やスコープを追加で設定する必要がありました。

APEX 26.2では、その設定作業を減らします。連携に両方のリソースを設定すると、生成するスターターアプリケーションで次を行います。

  • 認証スキームに、ADFとBOSSのスコープ、およびurn:opc:resource:multiresourcescopeという名前付きスコープを含めます。
  • Database ToolsのFusion連携ウィザードからAUTHENTICATION_SUBSTITUTIONSインスタンスパラメーターで渡すADF／BOSSの設定を使い、認証とリソースのスコープを設定します。
  • Web Credentialに、ADF用のOAUTHとBOSS用のBOSSという、2つの名前付きスコープを設定します。
  • ADFとBOSSのRESTデータソースの例に、それぞれ適した名前付きスコープを設定します。
  • 対応する名前付きスコープごとに、アクセストークンとリフレッシュトークンをキャッシュします。

これにより、利用者は1回サインインすれば、自分の権限の範囲で、設定したADFまたはBOSSのサービスにアクセスできます。アクセス時には、それぞれのリソース用アクセストークンを自動的に使います。

Fusion連携を設定する

スターターアプリケーションを作る前に、Database Tools Fusion Integration Wizardを使い、Fusion Applications環境と、APEXを配置したデータベースとの接続を設定してください。

本記事の手順では、連携にADFとBOSSの両方のリソーススコープを含める必要があります。生成するアプリケーションには、連携設定で利用可能なスコープを反映します。

連携の設定情報は、AUTHENTICATION_SUBSTITUTIONSインスタンスパラメーターを通じてAPEXに渡します。スターターアプリケーションの生成時に、この情報で認証とサンプルのRESTデータソースを設定します。

スターターアプリケーションを作成する

APEXワークスペースで、次の操作を行います。

  1. App Builderを開き、Createをクリックします。
  2. Create Fusion Integrationを選択します。
  3. Configuration OptionsのFusion Instance Nameで、設定済みのインスタンスを選びます。
  4. Base URL for REST APIsを確認し、API Statusを調べます。
  5. Advanced Settingsで、Application Name、Application Alias、Application IDを確認します。
  6. Create Applicationをクリックします。

ウィザードでアプリケーションと連携用コンポーネントを生成します。リモートサーバー、Web Credential、認証スキーム、サンプルのRESTデータソースが含まれます。

図1：設定済みのFusion Applications環境を選択したCreate Fusion Integration画面

FusionスターターアプリケーションでADFとBOSSを試す

生成したアプリケーションを実行し、Fusion Applications環境に関連付けたIDドメインを通じてサインインします。次に、2つのサンプルページを確認します。

Self Details：ADFからユーザー情報を取得する

Self Detailsを開きます。このページでは、HCM Self DetailsというRESTデータソースを使い、ADF RESTサービスから、現在サインインしているユーザーの情報を取得します。言語、日付形式、タイムゾーンなどの情報が返されます。

図2：サインイン中のユーザー情報を表示するSelf Details

Service Tags：BOSSからサービスのデータを取得する

次に、Service Tagsを開きます。このページでは、CX Common Service TagsというRESTデータソースを使い、BOSSエンドポイントからタグを取得します。

レポートには、タグの値、作成日時、作成者などを表示します。Fusionのサービスでは、タグでサービス要求を説明・分類できます。

注： CXのBOSSエンドポイントにアクセスするには、サインインしたユーザーに、必要なFusion Applicationsのロールと権限が必要です。アクセスエラーが出る場合は、Fusion Applicationsの管理者に権限の確認を依頼してください。

図3：BOSSエンドポイントから取得したデータを表示するService Tags

RESTデータソースごとのスコープ選択を確認する

BOSSの例を調べるには、App Builderでアプリケーションを開き、Shared Components → REST Data Sources → CX Common Service Tagsへ進みます。

次の設定を確認してください。

設定値
REST Data Source Type（RESTデータソース型）Oracle Cloud Applications (BOSS) REST Service
URL Path Prefix（URLパスの接頭辞）api/boss/data/objects/ora/cxServiceCore/common/v1/tags
Credentials（認証情報）生成されたFusion連携用Web Credential
Invocation Scope Type（呼び出しスコープの種類）Static（静的）
Static Value（静的な値）BOSS

Static Valueには、Web Credentialの名前付きスコープを指定します。APEXでは、この対応付けを基に、エンドポイントの呼び出しに使うリソース別のトークンを選びます。

HCM Self DetailsのRESTデータソースでは、呼び出しスコープにOAUTHを使います。

アプリケーションのページRESTデータソース呼び出しスコープ使うトークン
Self DetailsHCM Self DetailsOAUTHADFリソース用アクセストークン
Service TagsCX Common Service TagsBOSSBOSSリソース用アクセストークン

図4：静的な呼び出しスコープにBOSSを設定したCX Common Service Tags

認証設定を理解する

Shared Components → Authentication Schemesへ進み、生成された認証スキームを開きます。

スコープには、設定したADFとBOSSのスコープに加え、urn:opc:resource:multiresourcescopeを含めています。

この特別なスコープを使うことで、認証時に、複数のリソース用のアクセストークンを別々に取得できます。APEXで複数トークンの応答を処理し、アクセストークンと、返された場合はリフレッシュトークンを、対応する名前付きスコープごとにキャッシュします。RESTデータソースを実行する際は、その呼び出しスコープで使うトークンを識別します。

対応付けを確認するには、生成されたWeb Credentialを開き、名前付きスコープを調べます。この例では、OAUTHとBOSSです。これらの名前は、設定したOAuthスコープの別名として使います。

図5：OAUTHとBOSSの名前付きスコープを持つ、生成されたWeb Credential

動的グループ：Fusion Applicationsのロールに基づく認可

スターターアプリケーションには、IT Security Manager Roleという認可スキームの例も含みます。Fusion Applicationsのロールを使い、APEXのコンポーネントの表示を制御する方法を示しています。動的グループとロールベースの認可は、以前からスターターアプリケーションにある機能であり、ADF／BOSSの連携を補います。

図6：動的グループ

既存のアプリケーションにBOSSへのアクセスを追加する

26.2より前にFusion Integration Wizardで生成した、ADFベースのAPEXアプリケーションは、APEX 26.2への更新後も、既存の認証設定を引き続き使えます。更新するだけでは、BOSSのスコープやサンプルページは自動で追加されません。

BOSSへのアクセスを追加するには、次の設定を行います。

  • IDCSの機密アプリケーションに、BOSSリソースのスコープを追加します。次に、アプリケーションの認証スキームに、置換変数ではなく実際のBOSSスコープ値を、urn:opc:resource:multiresourcescopeと併せて手動で追加し、Web Credentialに対応するBOSSの名前付きスコープを設定します。
  • アプリケーションの認証スキームと、Web Credentialの名前付きスコープを調整します。
  • RESTデータソースで、アクセス先のリソースに応じた呼び出しスコープを設定します。

動作する設定例として、新しくFusion連携スターターアプリケーションを生成するとよいでしょう。参考用のアプリケーションを作成しても、既存のアプリケーションは変更しません。

まずは、Self DetailsとService Tagsを実行し、呼び出しスコープの設定を確認してください。これらの例から、1回のサインインでADFとBOSSの両サービスを使う、Fusion Applicationsの拡張方法を学べます。