17.5.1 リモート・サーバーの理解

RESTデータ・ソース・サーバー情報を格納するリモート・サーバー・オブジェクトを作成します。

17.5.1.1 リモート・サーバーについて

RESTデータ・ソース・サーバー情報を格納するリモート・サーバー・オブジェクトを作成します。

Oracle APEXでは、RESTデータ・ソース・サーバー情報(REST APIなど)をリモート・サーバー・オブジェクトとして格納します。リモート・サーバーは複数のRESTデータ・ソース間で共有できます。リモート・サーバー・プロパティを変更すると、そのオブジェクトを参照するすべてのRESTソースに影響します。たとえば、リモート・サーバーのベースURLを変更して、関連付けられているすべてのRESTソースをテストから本番システムに移動できます。リモート・サーバーはワークスペースレベルで格納されるため、リモート・サーバーはワークスペース内のすべてのアプリケーションに表示されます。

リモート・サーバーを作成する場合、次のいずれかのタイプを選択します。

  • RESTデータ・ソース - リモートREST APIを使用するためのリモート・サーバー。

  • 認証 - 認証用のリモート・サーバー。

  • プリント・サーバー - 外部プリント・サーバー用のリモート・サーバー。

17.5.1.2 APEXによるRESTデータ・ソース情報の格納方法

Oracle APEXでRESTデータ・ソース情報を格納する方法について説明します。

Oracle APEXでは、RESTデータ・ソースのエンドポイントURLが2つの部分に分割されます。最初の部分はサーバー固有の部分で、リモート・サーバーと呼ばれる別個のエンティティとして格納されます。それぞれが使用するサーバー、ポートおよびURLパス接頭辞(コンテキスト・ルート)が同じである場合は、複数のRESTデータ・ソースを持つ1つのリモート・サーバーを再利用できます。リモート・サーバーはワークスペースレベルで格納され、すべてのアプリケーションに表示されます。

エンドポイントURLの2番目の部分は、RESTデータ・ソースに固有です。複数のRESTデータ・ソースが1つのリモート・サーバーを共有できることから、ベースURL、認証などの情報を共有します。リモート・サーバーの属性を変更すると、その変更はリモート・サーバーを使用しているすべてのRESTデータ・ソースに影響を与えます。リモート・サーバーにより、RESTデータ・ソースのコレクションを移動することが容易になります。たとえば、リモート・サーバー・オブジェクト内のURLを変更することで、テスト・システムから本番システムに移行できます。

17.5.1.3 リモート・サーバー情報のエクスポートおよびインポート

リモート・サーバー情報のエクスポートおよびインポートについて説明します。

アプリケーションをエクスポートする際に、参照されているリモート・サーバーがエクスポート・ファイルに追加されます。アプリケーションを別のワークスペースにインポートすると、APEXは、ターゲット・ワークスペースにすでに同じ静的IDのリモート・サーバーが含まれているかどうかをチェックします。リモート・サーバーがすでに存在する場合、アプリケーションはこれを使用します。そうでない場合は、インポート・ファイルからのリモート・サーバーが、ターゲット・ワークスペースに作成されます。