20 マッピングおよび空間情報の高度なオプションの構成

この章では、Oracle Business Intelligenceでマップ・ビューに対して設定できる高度な構成オプションについて説明します。

この章の内容は次のとおりです。

「マッピングおよび空間情報の構成」を参照してください。マップ・ビューを構成する前に、次のガイドの情報を理解しておく必要があります。

『マップ・ビジュアライゼーション開発者ガイド』(Oracle Fusion Middlewareドキュメント・ライブラリの一部)。
Oracle Spatial開発者ガイド(Oracle Databaseドキュメント・ライブラリの一部)

MapViewerでのマップ・ビューのサポートの構成

Oracle Fusion Middleware MapViewerは、Oracle BI Enterprise Editionの一部としてインストールされ、Webアプリケーション・サーバー上でOracle BI EEと同じドメインにデプロイされます。

アプリケーション・サーバーでのMapViewerのデフォルトのコンテキスト・パスは、/mapviewerです。MapViewerの管理コンソールを使用して、MapViewerでマップ・ビューを使用できるように構成する必要があります。『マップ・ビジュアライゼーション開発者ガイド』のMapViewerの構成に関する項を参照してください。

MapViewer専用のリモート・インスタンスを別に構成して、マップで必要となる重い処理負荷をサポートするプロキシとしてそのインスタンスを機能させることができます。パフォーマンスがそれほど重要ではない場合は、Oracle BI EEと同じ場所に配置されている(コロケート) MapViewerインスタンスをレンダリング・エンジンとして使用できます。

MapViewerエンジンは、次の役割で使用できます。

コロケートMapViewer - 非プロキシ・モードとも呼ばれます。MapViewerをOracle BI EEと同じドメインに配置し、レンダリング・エンジンとして使用した場合、すべてのマップ・リソース(JavaScriptファイルやイメージなど)がそのMapViewerインスタンスからダウンロードされます。
リモートMapViewer - プロキシ・モードとも呼ばれます。MapViewerの独立したリモート・インタンスをレンダリング・エンジンとして構成した場合、ブラウザはそのリモート・インスタンスと通信してリソースを要求できません。セキュリティ上の理由から、ブラウザではドメイン間のAJAX呼出しは実行できません。この制限に対処するため、すべてのリクエストがまずコロケートMapViewerに転送され、その後このMapViewerと実際のリモート・インスタンスとの通信が行われます。

リモートMapViewerを構成するステップは次のとおりです。
- 「マップ・ビューの手動による構成」で説明している手順に従って、instanceconfig.xmlファイルのRemoteOracleMapViewerAbsoluteURL要素を編集します。
- MapViewerの構成ファイルmapViewerConfig.xmlのproxy_enabled_hosts要素を編集して、リモート・サーバー上のMapViewerを指すように設定します。次に例を示します。
```
  <security_config>
    <proxy_enabled_hosts>http://remoteserver:9704/mapviewer</proxy_enabled_hosts>
  </security_config>
```
  mapViewerConfig.xmlファイルは次のディレクトリにあります。
  
  ORACLE_BI1\bifoundation\jee\mapviewer.ear\web.war\WEB_INF\conf
注意:
mapViewerConfig.xmlファイルを編集した場合、その編集結果は、Oracle Business Intelligenceのアップグレードまたはパッチ適用時に上書きされます。アップグレードまたはパッチの適用を行う前には、必ずmapViewerConfig.xmlファイルのバックアップ・コピーを作成してください。アップグレードまたはパッチ適用操作が完了したら、バックアップされたファイルを元の場所にコピーします。ファイルをコピーしたら、マップ・ビューがOracle Business Intelligenceの分析およびダッシュボードで適切に表示されるようMapViewerのサーバーを再起動してください。

次の図は、マップ・ビューの優先アーキテクチャを示しています。プロキシを使用したこのアーキテクチャでは、次の表で示しているデフォルトのアーキテクチャよりもパフォーマンスが向上します。Oracle Database、またはOracle BI EEがサポートするその他のデータベースにデータを格納できます。

GUID-0E139C81-CB5A-48CC-85D6-5A3AC92C6CE3-default.gifの説明

マップ・ビューの手動による構成

マップ・ビューの構成には、instanceconfig.xmlファイルの様々な要素を使用します。

次のinstanceconfig.xmlファイルを開いて編集します。
BI_DOMAIN/config/fmwconfig/biconfig/OBIPS
SpatialMapsセクションを見つけ、このセクションに次の用語を追加する必要があります。
- ColocatedOracleMapViewerContextPath - Oracle BI EEと同じ場所にある(コロケート)MapViewerインスタンスのコンテキスト・パスを指定します。デフォルト値は/mapviewerです。
- RemoteOracleMapViewerAbsoluteURL - リモートのMapViewerインスタンスのURLを指定します。この要素にはデフォルト値はありません。
  
  この要素に値が指定されていない場合、マップ・レンダリング・エンジンはコロケートMapViewerインスタンス(/mapviewerなど)であるとみなされます。この要素に値が指定されている場合は、コロケートMapViewerがリモート・サーバーに対するすべてのリクエストのプロキシとして機能します。次の例は値のサンプルです。
```
<RemoteOracleMapViewerAbsoluteURL>http://remoteserver:9704/mapviewer </RemoteOracleMapViewerAbsoluteURL>
```
- MaxRecords - マップ上の個々のレイヤーに含めることができる最大レコード数を指定します。この設定はマップ上のすべてのレイヤーに適用されるとともに、この設定によって、データ・キューブに適用されるMaxVisibleRows要素がオーバーライドされます。デフォルト値は500です。レイヤーの形式が原因でこの値を超える場合は、警告メッセージが表示されます。親要素はLayerDataLayoutです。
- SyndicatedOracleMapViewerContextPath — マップを外部ページに埋め込む場合に使用するMapViewerインスタンスのURLを指定します。詳細と例は、「マップを外部で使用するための構成」を参照してください。

次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
   <SpatialMaps>
      <ColocatedOracleMapViewerContextPath>/mapviewer</ColocatedOracleMapViewerContextPath>
      <RemoteOracleMapViewerAbsoluteURL></RemoteOracleMapViewerAbsoluteURL>
      <LayerDataLayout>
        <MaxRecords>600</MaxRecords>
      </LayerDataLayout>
   </SpatialMaps>
</ServerInstance>

変更内容を保存し、ファイルを閉じます。
Oracle Business Intelligenceを再起動します。

マップ上へのテキストの挿入

マップのタイル・レイヤー定義に、著作権の文字列などの任意のテキストを追加できます。

タイル・レイヤーが追加または削除されたときや、タイル・レイヤーが非表示になったときには、Oracle BI EEでマップ上のテキストが自動的に更新されます。また、ユーザーが概要マップを最小化したり、元のサイズに戻したり、削除したりしたときには、テキストの位置が自動的に調整されます。

次の図は、マップ上の著作権文字列の例を示しています。文字列は画面の右下にあります。

GUID-56423F47-D2FD-49DC-8ECE-79E371CA17B6-default.gifの説明

タイル・レイヤーを作成します。
『マップ・ビジュアライゼーション開発者ガイド』を参照してください。
タイル・レイヤー定義を選択し、詳細の編集/表示をクリックして定義を編集します。
「送信」をクリックして変更を保存します。
更新されたテキストがマップに表示されない場合は、ブラウザの「最新の情報に更新」ボタンをクリックして、マップの表示を更新します。

マップを外部で使用するための構成

対応する構成オプションを設定することによって、Oracle WebCenter Portalのページなどの外部ページにマップ・ビューを埋め込むことができます。

独立したWebアプリケーション・サーバーにホストされているビューを埋め込むには、前の項で概説しているプロキシ・ルールに従ってください。ブラウザの制限があるため、外部ページまたはポータルと同じアプリケーション・サーバーにMapViewerインスタンスをインストールします。外部ページをホストしているWebアプリケーション・サーバーにインストールされているMapViewerインスタンスのプロキシ・コンテキスト・パスが、Oracle BI EEのコンテンツをホストしているアプリケーション・サーバーと異なる場合があります。その場合は、SyndicatedOracleMapViewerContextPath要素を設定します。Oracle BIプレゼンテーション・サービスのサーバーは、サード・パーティ・ページから送信されたリクエストを識別すると、この要素の値をチェックしてプロキシ・リクエストをどこに渡すかを判断します。

次の例では、この要素のサンプル値を示しています。

<ServerInstance>
   <SpatialMaps>
      <SyndicatedOracleMapViewerContextPath>/mapviewer</SyndicatedOracleMapViewerContextPath>
      <RemoteOracleMapViewerAbsoluteURL>http://myserver:9704/mapviewer</RemoteOracleMapViewerAbsoluteURL>
   </SpatialMaps>
</ServerInstance>