Oracle® Fusion Middleware

Oracle Business Intelligence Enterprise Edition開発者ガイド

12c (12.2.1)

E70041-01(原本部品番号:E57382-01)

2015年10月

Oracle Business Intelligence Enterprise Editionの機能を、Oracle JDeveloper、Oracle Application Development Framework (ADF)およびOracle WebCenterを使用して構築されたアプリケーションに取り込む方法について説明します。

Oracle Fusion Middleware Oracle Business Intelligence Enterprise Edition開発者ガイド, 12c(12.2.1)

E70041-01

Copyright © 2010, 2015, Oracle and/or its affiliatesAll rights reserved.

原本著者: Guriqpal Gill

原本協力著者: Stefanie Rhone

原本協力者: Oracle Business Intelligence development, product management, and quality assurance teams

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、このソフトウェアまたはハードウェアを安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracleおよびその関連企業の登録商標です。その他の名称は、他社の商標の可能性があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXはThe Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメントとその他のリソース

- システム要件と動作要件

- 表記規則

Oracle Business Intelligence Developerの新機能

- Oracle BI EE 12c(12.2.1)の新機能

1 ADFアプリケーションへのビジネス・インテリジェンス・オブジェクトの埋込み

- 1.1 アプリケーションへのビジネス・インテリジェンス・オブジェクトの埋込みの概要

- 1.2 ADFページに追加できるビジネス・インテリジェンス・オブジェクト

- 1.3 埋込みビジネス・インテリジェンス・オブジェクトのユース・ケース

- 1.4 ビジネス・インテリジェンス・オブジェクトを受け入れるためのADFプロジェクトの準備

- 1.4.1 ADFプロジェクトの準備方法

- 1.4.1.1 インストールされているJDeveloper拡張機能の確認

- 1.4.1.2 必要なJDeveloper拡張機能のインストール

- 1.4.1.3 ADFアプリケーションでのOracle BI EEのパーソナライズについて

- 1.4.1.4 MDSライブラリの追加およびMDSカスタマイズの有効化

- 1.4.1.5 ADFテクノロジ・スコープの追加

- 1.5 Oracle BI EEプレゼンテーション・サービス接続の作成

- 1.5.1 SSLを構成してOracle BI EEプレゼンテーション・サービス接続を作成する方法

- 1.5.1.1 SSLの構成

- 1.5.1.2 クライアント証明書のエクスポートとインポート

- 1.5.1.3 接続の作成

- 1.6 ADFページへのOracle Business Intelligenceオブジェクトの追加

- 1.6.1 ADFページへのビジネス・インテリジェンス・オブジェクトの追加方法

- 1.7 Oracle BI EEコンテキスト・イベント・アクションでのビジネス・インテリジェンス・コンテンツの引渡し

- 1.7.1 QDRの定義とは

- 1.7.2 QDRのシグネチャとは

- 1.7.3 Oracle BI EE ADFコンテキスト・イベントの検出方法

- 1.7.3.1 ADFコンテキスト・イベントの検出

- 1.8 デプロイメント後のプレゼンテーション・サービス接続の追加または変更

- 1.8.1 プレゼンテーション・サービス接続を追加または変更する方法

- 1.8.1.1 プレゼンテーション・サービス接続の追加または変更

- 1.9 Oracle BIプレゼンテーション・カタログに接続するための資格証明

- 1.9.1 偽装ユーザーの作成および使用方法

- 1.9.1.1 BIImpersonateUserの作成

- 1.9.1.2 BIImpersonateUserへの権限の付与

- 1.9.1.3 サーバーの再起動

- 1.10 スタンドアロンWebLogic Serverへの資格証明のデプロイ

- 1.10.1 資格証明の移行

2 Oracle BI EEオブジェクトを含むADFアプリケーションのパフォーマンスの向上

- 2.1 Oracle BIサーバーのタイムアウトの設定

- 2.1.1 Oracle BIサーバーのタイムアウトの設定方法

- 2.1.2 タイムアウト設定の例

- 2.2 セッション・タイムアウトの追加

- 2.2.1 セッション・タイムアウトの追加方法

- 2.3 静的リソースの使用

- 2.3.1 静的リソースのプリファレンスの設定方法

- 2.3.2 静的リソースの場所のテスト

3 ADFアプリケーションへのBIコンポーザの追加

- 3.1 ADFアプリケーションでのBIコンポーザの使用の概要

- 3.2 ADFアプリケーションへのBIコンポーザの追加

- 3.2.1 インストールされているJDeveloper拡張機能の確認

- 3.2.2 必要なJDeveloper拡張機能のインストール

- 3.2.3 BIコンポーザ・ライブラリ・リファレンスの追加方法

- 3.2.4 ドメインの拡張方法

- 3.2.5 タスク・フロー・パラメータおよびイベントの追加方法

- 3.2.5.1 BIコンポーザ・ウィザードのエディタ・タスク・フロー

- 3.2.5.2 BIコンポーザ・ウィザードの編集イベント

- 3.2.5.3 BIコンポーザ・ウィザードのビューア・タスク・フロー・パラメータ

4 Oracle BI EE論理SQLビュー・オブジェクトの使用

- 4.1 Oracle BI EE論理SQLビュー・オブジェクトの概要

- 4.2 Oracle Business Intelligence論理SQLビュー・オブジェクトのユース・ケース

- 4.2.1 論理SQLからのデータをADFリッチ・ユーザー・インタフェース・コンポーネントで表示

- 4.2.2 論理SQLからのデータの表示およびランタイム・パラメータの引渡し

- 4.2.3 オンライン・トランザクション処理スキーマからのデータと論理SQLからのデータのADFリッチ・コンポーネントでの表示

- 4.2.4 Oracle Business Intelligenceビュー・オブジェクトとオンライン・トランザクション処理ビュー・オブジェクト間のマスター/ディテール関係の作成

- 4.3 Oracle Business Intelligence論理SQLビュー・オブジェクトの作成

- 4.3.1 Oracle Business Intelligence論理SQLビュー・オブジェクトの作成方法

- 4.3.1.1 インストールされているJDeveloper拡張機能の確認

- 4.3.1.2 必要なBusiness Intelligence JDeveloper拡張機能のインストール

- 4.3.1.3 BI JDBC接続の作成

- 4.3.1.4 ADFプロジェクトの初期化

- 4.3.1.5 ビジネス・インテリジェンス・ビュー・オブジェクトの作成

- 4.3.1.6 Oracle Business Intelligence論理SQLビュー・オブジェクトの動作の変更

- 4.4 BI JDBCデータ・ソースの作成

- 4.4.1 Oracle WebLogicでのBI JDBCデータ・ソースの作成方法

- 4.4.2 BI JDBCデータ・ソースに対する偽装の構成

- 4.5 Oracle Business Intelligence論理SQLビュー・オブジェクトの拡張

- 4.5.1 BI JDBCをサポートするWebLogicドメインの設定方法

- 4.5.2 Oracle Business Intelligence論理SQLビュー・オブジェクトの準備方法およびアプリケーションのデプロイ方法

- 4.5.2.1 ターゲット・アプリケーション・サーバーへの接続の作成

- 4.5.2.2 EARファイルのデプロイメント・プロファイルの作成

- 4.5.2.3 アプリケーションのデプロイ

5 Oracle Business Intelligenceプレゼンテーション・サービスとOracle WebCenterポータル・アプリケーションの統合

- 5.1 Oracle BIプレゼンテーション・サービスとWebCenterポータル・アプリケーションの統合の概要

- 5.2 Oracle BIプレゼンテーション・サービスと統合するWebCenterポータル・アプリケーションの作成

- 5.3 BIコンポーザをWebCenterポータル・アプリケーションまたはWebCenter Portal: Spacesに追加できるか

- 5.4 WebCenterポータル・アプリケーションまたはWebCenter Portal: SpacesへのBIコンポーザの追加

- 5.4.1 インストールされているJDeveloper拡張機能の確認

- 5.4.2 必要なJDeveloper拡張機能のインストール

- 5.4.3 WebCenterポータル・ドメインの拡張方法

- 5.4.4 BIコンポーザ・ライブラリ・リファレンスの追加方法

- 5.4.5 タスク・フロー権限セキュリティを追加する方法

- 5.4.6 BIコンポーザWebCenterポータルのビューアおよびエディタ・コンテナ・タスク・フロー・パラメータの指定方法

はじめに

Oracle Business Intelligence Foundation Suiteは、レポート、非定型問合せ、OLAP、ダッシュボード、スコアカード、What-If分析など、すべてのエンタープライズのビジネス・インテリジェンス・ニーズを満たす、完全かつオープンな統合ソリューションです。Oracle Business Intelligence Foundation Suiteには、Oracle Business Intelligence Enterprise Editionが含まれます。

Oracle Business Intelligence Enterprise Edition (Oracle BI EE)は包括的な一連のエンタープライズ・ビジネス・インテリジェンス・ツールおよびインフラストラクチャであり、拡張性のある効率的な問合せおよび分析サーバー、非定型の問合せおよび分析ツール、インタラクティブ・ダッシュボード、プロアクティブ・インテリジェンスとアラート、エンタープライズ・レポート・エンジンなどが含まれます。

Oracle BI EEのコンポーネントは、共通のサービス指向アーキテクチャ、データ・アクセス・サービス、分析および計算インフラストラクチャ、メタデータ管理サービス、意味的ビジネス・モデル、セキュリティ・モデルやユーザー・プリファレンスおよび管理ツールを共有します。Oracle BI EEは、各データ・ソース向けに最適化されたリクエスト生成、最適化されたデータ・アクセス、高度な計算、インテリジェント・キャッシュ・サービス、クラスタリングにより、スケーラビリティとパフォーマンスを提供します。

このガイドでは、Oracle BI EEベースのアプリケーションの開発、およびOracle BI EEと他のOracleシステムとの統合について説明します。

対象読者

このドキュメントは、プログラムによってOracle BI EEコンポーネントにアクセスし、これを使用してアプリケーションの作成または他のコンポーネントとの統合を行うアプリケーション開発者、データ・サービス・プロバイダおよび中間層管理者を対象としています。

ドキュメントのアクセシビリティについて

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

サポートをご購入のOracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs (聴覚障害者向け)を参照してください。

関連ドキュメントとその他のリソース

関連するOracle Business Intelligenceのドキュメントのリストは、Oracle Business Intelligenceのドキュメント・ライブラリを参照してください。

さらに、次もあります。

- Oracle Business Intelligenceに関連するオンライン・トレーニングのリソースについては、Oracle Learning Libraryを参照してください。

- 製品情報センターに関するサポート・ノート(記事ID: 1267009.1)をMy Oracle Support(https://support.oracle.com">>https://support.oracle.com)でアクセスしてください。

システム要件と動作要件

ハードウェアとソフトウェアの要件、プラットフォーム、データベースおよびその他の情報の詳細は、システム要件と動作要件のドキュメントを参照してください。いずれのドキュメントもOracle Technology Network (OTN)から入手できます。

システム要件のドキュメントには、ハードウェアとソフトウェアの要件、ディスク領域とメモリーの最小要件、必要なシステム・ライブラリ、パッケージまたはパッチなどの情報が記載されています。

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-requirements-100147.html

動作要件のドキュメントには、サポートされているインストール・タイプ、プラットフォーム、オペレーティング・システム、データベース、JDKおよびサードパーティ製品が記載されています。

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

表記規則

このドキュメントでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

Oracle Business Intelligence Developerの新機能

この序章では、Oracle Business Intelligence Enterprise Edition 12c(12.2.1)の新機能およびアップグレードの考慮事項について説明します。

この序章には、次のトピックが含まれています。

- 「Oracle BI EE 12c(12.2.1)の新機能」

Oracle BI EE 12c(12.2.1)の新機能

Oracle BI EE 12c(12.1.1)の新機能はありません。

1 ADFアプリケーションへのビジネス・インテリジェンス・オブジェクトの埋込み

この章では、分析、ダッシュボードおよびスコアカード・コンポーネントなどのOracle BI EEオブジェクトを、Oracle ADFアプリケーションに追加する方法について説明します。また、オブジェクトを受け入れるためのADFプロジェクトの準備方法、ADFへのオブジェクトの連結、およびアプリケーション保護のための偽装ユーザーの使用について説明します。

この章では次の項について説明します。

- アプリケーションへのビジネス・インテリジェンス・オブジェクトの埋込みの概要

- ADFページに追加できるビジネス・インテリジェンス・オブジェクト

- 埋込みビジネス・インテリジェンス・オブジェクトのユース・ケース

- ビジネス・インテリジェンス・オブジェクトを受け入れるためのADFプロジェクトの準備

- Oracle BI EEプレゼンテーション・サービス接続の作成

- ADFページへのOracle Business Intelligenceオブジェクトの追加

- Oracle BI EEコンテキスト・イベント・アクションでのビジネス・インテリジェンス・コンテンツの引渡し

- デプロイメント後のプレゼンテーション・サービス接続の追加または変更

- Oracle BIプレゼンテーション・カタログに接続するための資格証明

- スタンドアロンWebLogic Serverへの資格証明のデプロイ

1.1 アプリケーションへのビジネス・インテリジェンス・オブジェクトの埋込みの概要

ビジネス・インテリジェンス・オブジェクトを埋め込むことで、Oracle BIプレゼンテーション・カタログにアクセスし、分析やダッシュボードなどのOracle BI EEオブジェクトを選択して、ADFページに追加することができます。多くの場合、ADFページに追加するオブジェクトは、ADFページおよびアプリケーションのテーマにあわせて作成されます。ADFページにオブジェクトを追加する場合、ページにはオブジェクトへの参照が含められ、オブジェクトのコピーは含められません。オブジェクトが変更され、Oracle BIプレゼンテーション・カタログに保存されると、フォームの実行時に、変更内容がすべてADFアプリケーションに表示されます。

ビジネス・インテリジェンス・オブジェクトをADFページに追加した後、それをADFページの他のリージョンに連結できます。オブジェクトのフィルタまたはプロンプト・パラメータを設定することもできます。アプリケーションのデプロイ後、セキュリティを設定して、プレゼンテーション・サービス接続を変更することもできます。

ビジネス・インテリジェンス論理SQLビュー・オブジェクトを使用すると、Oracle Business Intelligenceサーバーにアクセスして、ネイティブのADFコンポーネントをOracle BI EEデータにバインドするADFアプリケーションを作成できます。この方法によるADFページへのビジネス・インテリジェンス・データの追加の詳細は、第4章「Oracle BI EE論理SQLビュー・オブジェクトの使用」を参照してください。

1.2 ADFページに追加できるビジネス・インテリジェンス・オブジェクト

ADFアプリケーションに追加できるビジネス・インテリジェンス・オブジェクトは、Oracle BIプレゼンテーション・カタログのフォルダに格納されています。ADFアプリケーションに追加できるのは、次のタイプのビジネス・インテリジェンス・オブジェクトです。

- 分析(フォルダを開いて参照し、分析のサブコンポーネントを表示できます。カタログには、次のビュー・タイプが表示されます: 表、ピボット表、チャート、ファンネル・チャート、ゲージ、ナレーティブ、ティッカおよびタイトル)。

- ダッシュボード(ダッシュボード・フォルダ内を参照して、ダッシュボードに関連付けられているページを検索できます)。

- ダッシュボード・ページ(ダッシュボード・ページを参照してもコンポーネントを確認できないことに注意してください。これには、ダッシュボードに埋め込まれた任意の分析などがあります。)

- スコアカード・コンポーネント(スコアカード全体を含めることはできず、コンポーネントのみ含めることができます。コンポーネントには、戦略マップ、戦略ツリー、KPI監視リスト、原因と結果マップ、カスタム・ビューなどがあります)。

1.3 埋込みビジネス・インテリジェンス・オブジェクトのユース・ケース

ADFアプリケーションにビジネス・インテリジェンス・オブジェクトを埋め込む理由をよりよく理解するために、次のユース・ケースを使用します。ビジネス・インテリジェンス・オブジェクトの作成およびそれらのADFアプリケーションへの追加に関する具体的な情報は、この章の手順についてのトピックおよび『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』およびOracle Fusion Middleware Oracle Application Development FrameworkのためのFusion開発者ガイドを参照してください。

- サプライ・チェーン・マネージャは、様々な部門の注文ステータス、倉庫内のアイテムの利用可能性、および他の取引データを要約した分析の表示を必要としています。

- オンライン・ショッピング・サイトのマーケティング・マネージャは、年齢グループ、地域分布、個人の興味など、購入者のトレンド情報をダッシュボードに表示して、ユーザー・データを分析し、将来のマーケティング戦略を決定したいと考えています。

- 販売マネージャは、条件付き書式設定が使用された様々な地域の販売分析を確認し、売上が最小しきい値を下回っている場合、対策を講じたいと考えています。この分析をアクション・リンク付きでOracle BI EEアプリケーション内に作成し、ADFアプリケーションに埋め込むことができます。

1.4 ビジネス・インテリジェンス・オブジェクトを受け入れるためのADFプロジェクトの準備

ビジネス・インテリジェンス・オブジェクトを追加するためにADFプロジェクトを適切に準備するには、必要なMDSライブラリ(MDSランタイムおよびMDSランタイム依存性)をADFプロジェクトに追加し、BI ADFコンポーネント・テクノロジ・スコープをADFプロジェクトに追加する必要があります。

1.4.1 ADFプロジェクトの準備方法

ビジネス・インテリジェンス・コンテンツを受け入れるためにADFプロジェクトを準備するには、次の手順を実行します。次のタスクを実行する前に、ビジネス・インテリジェンス・コンテンツを追加するADFプロジェクトを作成しておく必要があります。

このトピックの手順の完了後、Oracle BI Enterprise Editionプレゼンテーション・サービス接続を作成して、アプリケーションに埋め込むビジネス・インテリジェンス・オブジェクトを選択するカタログにアクセスできます。詳細は、「Oracle BI EEプレゼンテーション・サービス接続の作成」を参照してください。

1.4.1.1 インストールされているJDeveloper拡張機能の確認

Oracle JDeveloperでは、次のOracle BI EE拡張機能を提供します。

- ビジネス・インテリジェンスADFタスク・フロー

- ビジネス・インテリジェンスADFビュー・リージョン

- ビジネス・インテリジェンス・コンポーザ

- ビジネス・インテリジェンス論理SQLビュー・オブジェクト

- ビジネス・インテリジェンスSOAP接続

必要なOracle JDeveloper 11g拡張機能およびOracle BI EE拡張機能があるかどうか不明な場合は、この手順を実行します。

1. JDeveloperで「ヘルプ」メニューをクリックし、「バージョン情報」をクリックします。表示される「Oracle JDeveloper 11gのバージョン情報」ダイアログ・ボックスで、リリース番号を確認できます。

2. 「拡張機能」タブをクリックして、インストールされている拡張機能のリストを表示します。リストをソートするには、「名前」または「識別子」列ヘッダーをクリックします。
Oracle BI EE拡張機能にはすべて、「bi-」接頭辞が付いています。「bi-」接頭辞で始まる拡張子がない場合、必要な拡張機能はありません。

1.4.1.2 必要なJDeveloper拡張機能のインストール

必要な拡張機能をインストールするには、次の手順を実行します。

1. JDeveloperの「ヘルプ」メニューから、「更新の確認」を選択します。

2. ウィザードの手順に従って、Oracle BI EE拡張機能を検索、ダウンロードおよびインストールします。Oracle BI EEと統合するWebCenterポータル・アプリケーションを作成する場合は、WebCenterポータル・フレームワークもインストールする必要があります。
使用可能なOracle BI EE拡張機能のリストは、「インストールされているJDeveloper拡張機能の確認」を参照してください。

1.4.1.3 ADFアプリケーションでのOracle BI EEのパーソナライズについて

ADFアプリケーションでパーソナライズが構成されている場合、ダッシュボード、ダッシュボード・ページ、分析およびビューのパーソナライズは自動的に保存されます。パーソナライズは、ユーザー・レベルまたはグループ・レベルで保存できます。

次のアイテムがADFページのダッシュボード・リージョンに存在する場合、パーソナライズできます。

- ダッシュボード・プロンプトの値

- プレゼンテーション変数の値(これらの変数は通常、プロンプトにより設定されます)

- 列セレクタの値

- ビューのドリル、ソートおよびピボット/入替え

次のビジネス・インテリジェンス・コンテンツ・タイプはパーソナライズできません。

- ダッシュボード・ページ

- スタンドアロン・スコアカード・コンポーネント

1.4.1.4 MDSライブラリの追加およびMDSカスタマイズの有効化

プロンプト値などのサイトおよびユーザー・アプリケーション・パーソナライズを保存するには、次のライブラリをADFプロジェクトに追加し、MDSカスタマイズが適切に有効化されていることを確認する必要があります。MDSはアプリケーション・メタデータを格納し、ADFアプリケーション内の様々なレベルでカスタマイズを格納および取得します。

MDSライブラリをADFプロジェクトに追加するには:

1. JDeveloperで「プロジェクト」ペインに移動し、MDSライブラリを追加するプロジェクトを右クリックして「プロジェクト・プロパティ」を選択します。

2. 「ライブラリとクラスパス」を選択します。

3. 「ライブラリの追加」ボタンをクリックし、MDSランタイムおよびMDSランタイム依存を強調表示して「OK」をクリックします。

4. 「プロジェクト・プロパティ」ダイアログの左ペインで、「ADFビュー」を選択します。

5. 次のオプションが選択されていることを確認します。

- ユーザー・カスタマイズの有効化

- MDSを使用したセッション間

- シード・カスタマイズの有効化

6. 「プロジェクト・プロパティ」画面で、「OK」をクリックします。

1.4.1.5 ADFテクノロジ・スコープの追加

ADFプロジェクトに適切なテクノロジ・スコープを追加するには、この手順を実行します。

テクノロジ・スコープは、プロジェクトに使用される様々なテクノロジを識別するための、ADFプロジェクトの属性です。BI ADFコンポーネント・テクノロジ・スコープを選択すると、ADF Faces、Java、JSF、JSPおよびサーブレット・テクノロジ・スコープがADFプロジェクトに追加されます。

ADFプロジェクトにADFテクノロジ・スコープを追加するには:

1. JDeveloperで「プロジェクト」ペインに移動し、テクノロジ・スコープを追加するプロジェクトを右クリックして「プロジェクト・プロパティ」を選択します。

2. 「テクノロジ・スコープ」を選択します。

3. 「使用可能なテクノロジ」リストで「BI ADFコンポーネント」を選択し、「追加」ボタンをクリックします。JDeveloperにより、必要なBIテクノロジが「選択済のテクノロジ」リストに追加されます。

4. 「OK」をクリックします。

1.5 Oracle BI EEプレゼンテーション・サービス接続の作成

ADFアプリケーションにビジネス・インテリジェンス・オブジェクトを追加する前に、SSLを構成し、証明書をエクスポートおよびインポートし、Oracle BI EEプレゼンテーション・サービスへのデータ接続を作成する必要があります。

1.5.1 SSLを構成してOracle BI EEプレゼンテーション・サービス接続を作成する方法

SSLを構成し、証明書をエクスポートおよびインポートし、Oracle BI EEプレゼンテーション・サービスへの接続を作成するには、次の手順を実行します。次のタスクを実行する前に、まずADFプロジェクトを作成し、ビジネス・インテリジェンス・コンテンツを受け入れるための準備を行う必要があります。プロジェクトの準備の詳細は、「ビジネス・インテリジェンス・オブジェクトを受け入れるためのADFプロジェクトの準備」を参照してください。

注意:
アプリケーションの使用時に証明書エラーが表示された場合、ブラウザへのクライアント証明書のインポートが必要になる場合があります。

1.5.1.1 SSLの構成

セキュアな通信を可能にするには、SSLを介して通信するようにOracle BI EEプレゼンテーション・サービスを構成する必要があります。

SSLの詳細およびOracle Business Intelligenceでの構成方法については、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』を参照してください。

1.5.1.2 クライアント証明書のエクスポートとインポート

SSLの構成後、キーストアからWebアプリケーション・クライアント証明書をエクスポートして、JDeveloperにインポートする必要があります。

クライアント証明書をエクスポートおよびインポートするには:

1. サーバーのキーストアの場所を識別します。このパスは通常、ORACLE_HOME/oraclebi/wlserver_10.3/server/lib/DemoIdentity.jksです。

2. サーバーのキーストアの場所を使用して、次のコマンドを実行します。
cd %ORACLE_HOME%/oraclebi/wlserver_10.3/server/lib/

%JAVA_HOME%\bin\keytool -export -alias wlscertgencab -file my.crt -keystore DemoTrust.jks -storepass DemoTrustKeyStorePassPhrase

3. クライアント証明書をJDeveloperにインポートします。この手順により、Oracle Business Intelligenceプレゼンテーション・サービス接続の作成時にSOAPエラーの発生を防ぐことができます。

1. 証明書をJDeveloperのJREにコピーします。場所は、jdev\jdk\jre\lib\securityまたはoracle\jdk\jre\lib\securityです。

2. 次のコマンドを実行して、証明書をインポートします。Javaデフォルト・キーストア・ファイル$JAVA_HOME/lib/security/cacertsのデフォルト・パスワードは、changeitです。
keytool -v -import -file my.crt -keystore cacerts

4. クライアント証明書をJDeveloperのJREにインポートします。この手順により、https://server:port/analytics/saw.dll?privateWSDLのSOAPリクエストをSSLモードで送信する際に、エラーの発生を防ぐことができます。

1. JDeveloperを起動して-Djavax.net.ssl.trustStoreパラメータを探します。たとえば、-Djavax.net.ssl.trustStore= C:\ADE\jdevmain3\oracle\wlserver_10.3\server\lib\DemoTrust.jksなどです。
このパラメータには、クライアントのトラストストアの場所が含まれており、クライアントがサーバーの証明書の検証に使用するキーと証明書が格納されています。

2. 次のコマンドを実行して、証明書をこのクライアント・トラストストアにインポートします。
%ORACLE_HOME%\oracle\jdk\bin\keytool -import -alias test -file <client_cert_filename> -keystore <keystorefile> -keypass <key_password>

1.5.1.3 接続の作成

プレゼンテーション・サービスの1つ以上のインストールに、接続を追加できます。接続を作成および保存した場所によって、接続名はリソース・パレットの「IDE接続」パネル内またはアプリケーション・ナビゲータの「アプリケーション・リソース」パネル内に表示されます。

接続名を開くと、JDeveloperによりOracle BIプレゼンテーション・カタログのフォルダおよびフォルダに格納されているオブジェクトが表示されます。フォルダでは、リソース・パレットからADFページにビジネス・インテリジェンス・オブジェクトをドラッグ・アンド・ドロップできます。

この接続は、カタログごとに1度だけ作成する必要があります。ただし、接続の作成後は、設計時にJDeveloper内でパラメータを編集できます。

注意:
ADFアプリケーションのデプロイ時またはデプロイ後に、プレゼンテーション・サービス接続を追加または変更できます。詳細は、「デプロイメント後のプレゼンテーション・サービス接続の追加または変更」を参照してください。

接続を作成するには:

1. JDeveloperで、接続を使用する場所を選択します。すべてのJDeveloperアプリケーションで使用可能な接続を作成するには、次のサブステップを実行します。

1. リソース・パレットに移動して、「新規」ボタンをクリックします。

2. リストから、「BIプレゼンテーション・サービス」を選択します。「BIプレゼンテーション・サービス接続の作成」ウィザードが表示されます。

注意:
JDeveloperでは、保存されている接続をリソース・パレットから「アプリケーション・リソース」ペインにドラッグ・アンド・ドロップできます。

2. 現在のアプリケーションで使用可能な接続を作成するには、次のサブステップを実行します。

1. 「アプリケーション・ナビゲータ」タブ→「アプリケーション・リソース」ペインに移動し、「接続」フォルダを右クリックして「接続の作成」を選択し、「BIプレゼンテーション・サービス」を選択します。「BIプレゼンテーション・サービス接続の作成」ウィザードが表示されます。

2. 「接続」フォルダを右クリックして、「接続の作成」を選択します。

3. 「BIプレゼンテーション・サービス」を選択します。「BIプレゼンテーション・サービス接続の作成」ウィザードが表示されます。

3. カタログ接続を識別する、一意のわかりやすい名前を入力します。接続作成の終了後に、この名前を変更することはできません。

4. 「次へ」をクリックします。

5. Oracle Business Intelligenceプレゼンテーション・サービスの場所を入力し、次のアイテムを選択します。

- プロトコル- ドロップダウン・リストから「http」または「https」を選択します。

- BIプレゼンテーション・サービス・ホスト- Oracle Business Intelligenceがインストールされているサーバーの場所を入力します(abc12345.mycompany.comなど)。

- BIプレゼンテーション・サービス・ポート- ホストのポート番号を入力します。通常は、9704です。

- BIプレゼンテーション・サービスの仮想ディレクトリ- analyticsと小文字で入力します。

- WSDLコンテキスト- WSDLアプリケーションをデプロイするコンテキストを入力します。システム管理者がデフォルトのコンテキストを「analytics-ws」から別の値に変更した場合にのみ、このフィールドを変更します。たとえば、mycompanyname-wsに変更できます。このフィールドに指定されたコンテキストはSOAP接続で使用されます。

- 静的リソースのモード- 静的リソースの取得元を指定します。
すべてのリクエストをOracle BIプロキシではなくOracle BIプレゼンテーション・サービスに送るには、「自動」を選択します。「自動」を選択すると、パフォーマンスが著しく向上します。「自動」モードで最もよいパフォーマンスが得られるのは、Oracle WebLogic ServerがOracle HTTP ServerまたはApache HTTP Serverの内側にあり、Oracle WebLogic Serverをバイパスして静的ファイルを提供する場合です。

リクエストを別の場所に送るには、「手動」を選択します。「手動」を選択する場合、「静的リソースの場所」フィールドでURLを指定する必要があります。

- 静的リソースの場所- (オプション)「静的リソースのモード」フィールドで「手動」を選択した場合、デプロイした静的リソースの場所を入力します(Oracle BIインストール内に配置されていない場合)。URLの書式はhttp://host:port/analyticsにします。静的リソースの例としては、.cssや.javascripなどがあります。Oracle BIがファイアウォールの内側にあり、ADFインスタンスへのポートがファイアウォールの外側にある場合、このフィールドは空白のままにします。静的リソースの設定の詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド』のOracle BI Webクライアントのパフォーマンスの向上に関する項を参照してください。

6. 「次へ」をクリックします。

7. プレゼンテーション・サービス接続のユーザー名とパスワードを指定します。

注意:
アプリケーションでADFセキュリティが有効化されている場合、アプリケーションをデプロイする前に、ユーザー名とパスワードを偽装ユーザーの資格証明に変更する必要があります。詳細は、「偽装ユーザーの作成および使用方法」を参照してください。

注意:
次のいずれかのシナリオを構成します。共有LDAPを使用しているか、または非中心アイデンティティ・ストアを使用しているかにより、使用するシナリオが異なります。

- 共有LDAPアイデンティティ・ストア(OIMなど)
JDeveloper WebLogicサーバー(JDeveloper's integrated Oracle WebLogic Serverを使用している場合)または使用するアプリケーションのWebLogic Serverと、Oracle BIサーバーとの間に設定します。

- 非中央アイデンティティ・ストア(BIインスタンスのローカルWebLogicアイデンティティ・ストアなど)
アプリケーションにログインする各ユーザーは、BIプレゼンテーション・サーバー内の適切なグループに、対応する一意のユーザー設定を持つ必要があります。

8. アプリケーションでADFセキュリティが有効化されていて、偽装ユーザーの資格証明を使用する場合は、このフィールドを「True」に設定したままにします。
アプリケーションでADFセキュリティが有効化されていて、偽装ユーザーの資格証明の使用を望まない場合は、「セキュリティが有効な場合に偽装を実行」フィールドを「False」に設定して、偽装ユーザーの資格証明を無効にします。このフィールドを「False」に設定した場合は、この画面の「ユーザー名」および「パスワード」フィールドで必要な資格証明を指定する必要があります(SSOユーザーのかわりに使用します)。資格証明の詳細は、「Oracle BIプレゼンテーション・カタログに接続するための資格証明」を参照してください。この設定は非推奨です。

アプリケーションでADFセキュリティが有効化されていない場合、このフィールドを変更する必要はありません。このフィールドは、ADFセキュリティが有効化されているアプリケーションでのみ使用します。

9. 「次へ」をクリックします。

10. 「接続のテスト」をクリックして、接続情報が正しいことを確認します。テスト接続に失敗した場合、問題のトラブルシューティングに役立つエラー・メッセージがJDeveloperで表示されます。

11. 「終了」をクリックして、接続を作成します。

1.6 ADFページへのOracle Business Intelligenceオブジェクトの追加

フィルタまたはパラメータを含むビジネス・インテリジェンス・オブジェクトをJSPXページにドラッグ・アンド・ドロップすると、JDeveloperにより<adfbi:content>要素が挿入されます。このタグは、次のEL式を使用して、ページ定義ファイルのbiContent要素を参照します。

<adfbi:content id="myBIRegion" value="#{bindings.biContent}"/>

実行時、この要素は選択したビジネス・インテリジェンス・コンポーネントのマークアップを返し、リージョンが入力として受け入れることのできるパラメータを定義します。基礎となる分析のプロンプトごとに1つのパラメータが存在するか、基礎となるダッシュボードの基礎となるフィルタまたはプロンプトごとに1つのパラメータが存在します。biContent要素にはデフォルト値が含まれ、これらのパラメータの値を編集して、式言語(EL)またはリテラルに置き換えることができます。これにより、JDeveloperの式言語を使用して、パラメータをページ上の他のコンポーネントに関連付けることができます。

biContent要素はsetParameters ADFコンテキスト・イベントも受け入れます。このイベントのペイロードを、pagedefファイルのダッシュボード・リージョンで公開されるパラメータにマップできます。例:

<eventMap xmlns="http://xmlns.mycompany.com/adfm/event">
<event name="setParameters">
<producer region="doInputs">
<consumer handler="biExecBinding1">
<parameters>
<parameter name="Products.Brand" value="${payLoad.input1}"/>
<parameter name='Periods."Year"' value="${payLoad.input2}"/>
</parameters>
</consumer>
</producer>
</event>
</eventMap>

ダッシュボードまたはダッシュボード・ページにプレゼンテーション変数を使用する分析が含まれていて、ダッシュボードにこれらの変数を設定する表示プロンプトがない場合、ダッシュボード設計者は変数を設定する非表示プロンプトを追加する必要があります。ADFページにダッシュボードが含まれている場合、非表示プロンプトをコンテキストの引渡しに使用できます。

1.6.1 ADFページへのビジネス・インテリジェンス・オブジェクトの追加方法

ADFページに追加するすべてのビジネス・インテリジェンス・オブジェクトは、現在のADFスキンのスタイルを継承します。

次のタスクを実行する前に、まずADFプロジェクトを作成し、ビジネス・インテリジェンス・コンテンツを受け入れるための準備を行い、サーバー接続を作成する必要があります。これらのタスクの詳細は、「ビジネス・インテリジェンス・オブジェクトを受け入れるためのADFプロジェクトの準備」および「Oracle BI EEプレゼンテーション・サービス接続の作成」を参照してください。

ADFページにビジネス・インテリジェンス・オブジェクトを追加して、フィルタまたはプロンプト・パラメータを指定するには:

1. JDeveloperでリソース・パレットに移動して、データ接続を選択し、ADFページに追加するビジネス・インテリジェンス・コンテンツを参照します。

2. ページにアイテムをドラッグ・アンド・ドロップします。

注意:
新規または更新済のビジネス・インテリジェンス・コンテンツがOracle BIプレゼンテーション・カタログに保存されている場合、JDeveloperカタログ接続をリフレッシュして、すべての新規および更新済のビジネス・インテリジェンス・コンテンツを使用可能にします。

3. アイテムにプロンプトまたはフィルタが含まれる場合、分析またはダッシュボードのプロンプトおよびフィルタを示す「パラメータ」画面が表示されます。パラメータのオーバーライド値を指定するには、カーソルを「値」フィールドに置いて、パラメータ値を入力します。

4. 式を作成するか、コンテンツ・アイテムをマネージドbeanにバインドするには、省略記号ボタンをクリックします。ELウィンドウが表示されます。EL式の作成またはEL画面でのデータ・バインディングの詳細は、Oracle Fusion Middleware Oracle Application Development FrameworkのためのFusion開発者ガイドを参照してください。

5. JSPXページを保存します。

6. 左ペインにある「プロジェクト」エリアで、作業中のページのファイル名を検索し、右クリックして「実行」を選択します。
アプリケーションになんらかのタイプのセキュリティが設定されている場合、ユーザー名とパスワードの入力を求めるメッセージが表示されます。

1.7 Oracle BI EEコンテキスト・イベント・アクションでのビジネス・インテリジェンス・コンテンツの引渡し

Oracle BI EE ADFコンテキスト・イベント・アクションはOracle BI EEに付属しており、Oracle BI EEアクション・フレームワークを使用しています。分析設計者がこのアクション・タイプを組込み可能になる前に、管理者はADFコンテキスト・イベント・アクションを使用可能にして、プレゼンテーション・サービス内の「新しいアクション・リンク」メニューに表示されるようにする必要があります。このアクション・タイプを使用可能にするには、Oracle BI EEのinstanceconfig.xmlファイルが次のパラメータを含むよう、管理者が変更する必要があります。

<ActionLinks>
<EnableADFContextualEvent>True</EnableADFContextualEvent>
</ActionLinks>

instanceconfig.xmlの変更の詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド』のプレゼンテーション・サービスの詳細構成の変更に関する項を参照してください。

分析設計者は設計時に、Oracle BI EE ADFコンテキスト・イベント・アクションを組み込む列を決定し、「新しいアクション・リンク」メニューから、「ADFコンテキスト・イベント」を選択します。実行時に、Oracle BI EE ADFコンテキスト・イベント・アクションは、ビジネス・インテリジェンス・オブジェクト(分析)からADFページの他のリージョンまたはADFページの他のADFコンテキスト・イベントに、コンテンツを渡します。

Oracle BI EE ADFコンテキスト・イベント・アクションはパラメータをとらず、条件付きでレンダリングできます。ユーザーがADFページにアクセスして、Oracle BI EE ADFコンテキスト・イベント・アクションを含むデータ・セルをクリックするか、セルが条件に関連付けられていて、条件のしきい値が満たされている場合は、セルの修飾データ参照(QDR)をペイロードとして持つOracle BI EE ADFコンテキスト・イベント・アクションが生成されます。

ADF設計者が、以前の3つの従業員評価で「優れている」と査定されている従業員を自動的に昇進させる機能を持つビジネス・インテリジェンス・リージョンを、ADFページに作成したいと考えているとします。これを実現するために、ビジネス・インテリジェンス・コンテンツ設計者は、分析の従業員名列にOracle BI EE ADFコンテキスト・イベント・アクションを組み込み、「昇進」ラベルを追加します。

1.7.1 QDRの定義とは

次に、QDRの定義を示します。

/**
* String representation of QDR with use of internal Ids
* <pre>
*  qdr
*   : '{"_m":' memberGroups (',"_q":'  qdrQualifier)? '}'
*  memberGroups
*   : '[' memberGroup (',' memberGroup)* ']'
*  qdrQualifier
*   : '{' ('"_t":[' scalarMember ']') | ('"_p":[' ('true' | 'false') ']') '}'
*  memberGroup
*   : '"_g":{' dimensionMembers (',"_l":'  groupQualifier)? '}'
*  groupQualifier
*   : '"' ('M' | 'G') '"'
*  dimensionMembers
*   : '"' IDENT '":' ('[]' | arrayMembers | hierarchyLevelsMembers)
*  hierarchyLevelsMembers
*   : '{' hierarchyLevelMembers (, hierarchyLevelMembers)* '}'
*  hierarchyLevelMembers
*   : '"' IDENT '":' ('[]' | arrayMembers)
*  arrayMembers
*   : '[' member (',' member)* ']'
*  member
*   : scalarMember | arrayMembers | qualifiedMember
*  scalarMember
*   : string | number | datetime
*  datetime
*   : string
*  qualifiedMember
*   : '{"_v":' scalarMember ',"_s":"' ('A' | 'E' | 'T' | 'P') '"}'
*  IDENT
*   : ('a' .. 'z' | 'A'..'Z' | '0' .. '9')+
*
*  _m: member groups
*  _q: QDR qualifier; _t or _p
*  _t: target; column identifier
*  _p: measure target; true or false
*  _g: member group
*  _l: member group qualifier; 'M' or 'G'
*  _v: member value
*  _s: member special value; 'A', 'E', 'T' or 'P'
*
*  Group Qualifiers:
*  M - Measure Dimension
*  G - Selection Group Dimension
*  For such dimensions, the dimension identifier is irrelevant; we
typically make it "_"
*  For measure dimension, members are measure columns
*  For selection group dimension, members are group Id Strings
*
*  Qualified Members: Members that are qualified by a special value
qualifier such as:
*  A - All
*  E - Every
*  T - Display Total Id
*  P - Path to catalog object
*
*  Dimension identifier for hierarchical columns is of the form:
"dimensionId:hierarchyId"
*
*  <b>
*  Examples:
*  </b>
*
*  Region (id "c0") West, East
*  Year (id "c1") 2000
*  {'_m':[{'_g':{'c0':['West','East']}}, {'_g':{'c1':[2000]}}]}
*
*  Region (id "c0") West, East
*  Year (id "c1") 2000
*  Target  Region
*  {'_m':[{'_g':{'c0':['West','East']}}, {'_g':{'c1':[2000]}}], '_q':
{'_t':['c0']}}
*
*  Geog dimension (id "d1"), Default hierarchy (id "h1"), State Level
(id "l1")  CA, WA
*  {'_m':[{'_g':{'d1:h1':{'l1':['CA','WA']}}}]}
*
*  Geog dimension (id "d1"), Default hierarchy (id "h1"), State Level
(id "l1") and City Level (id "l2") CA, WA, SJC
*  {'_m':[{'_g':{'d1:h1':{'l1':['CA','WA'], 'l2':['SJC']}}}]}
*
*  Region (id "c0") West, East
*  Measures Sales (id "c3"), Profit (id "c4")
*  {'_m':[{'_g':{'c0':['West','East']}}, {'_g':{'_':['c3','c4']}, '_l':'M'}]}
*
*  Region (id "c0") West, East
*  Year (id "c1") 2007, MyFavYears
*  {'_m':[{'_g':{'c0':['West','East']}}, {'_g':{'c1':[2007,{'_v':
'MyFavYears', '_s':'P'}]}}]}
*
*  Geog dimension (id "d1"), Default hierarchy (id "h1"),
State Level (id "l1") CA, WA and City Level (id "l2") MyFavCities
*  {'_m':[{'_g':{'d1:h1':{'l1':['CA','WA'], 'l2':[{'_v':'MyFavCities',
'_s':'P'}]}}}]}
*
*  Region (id "c0") West, East
*  Measures Sales (id "c3")
*  Measure Target
*  {'_m':[{'_g':{'c0':['West','East']}}, {'_g':{'_':['c3']}, '_l':'M'}], '
_q':{'_p':true}}
*  </pre>
*
* @param propIdExprMap          Map of column expressions key'ed by column Id
*/

1.7.2 QDRのシグネチャとは

次に、QDRのシグネチャを示します。

public static QDR fromString(String qdrStr) throws BISvsException

1.7.3Oracle BI EE ADFコンテキスト・イベントの検出方法

次の手順を使用して、Oracle BI EE ADFコンテキスト・イベントを検出するADFオブジェクトを含むページ定義に、イベントの詳細を追加します。ページ定義ファイルの詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』を参照してください。

1.7.3.1 ADFコンテキスト・イベントの検出

1. JDeveloperで、<ページ名>PageDef.xmlファイルを探して開きます。

2. </pageDefinition>タグを探し、その後に次のイベント詳細を追加して、イベント名およびコンシューマ・ハンドラ名を指定します。

<eventMap xmlns="http://xmlns.mycompany.com/adfm/event">
<event name="Event Name">
<producer region="*">
<consumer handler="Handler Name">
<parameters>
<parameter name="qdr" value="${payLoad}"/>
<parameters>
</consumer>
</producer>
</event>
</eventMap>

3. </bindings>タグを探し、その前に次のメソッドのアクションの詳細を追加します。

<methodAction id="setOutput" InstanceName="Output.dataProvider"
DataControl="Output" RequiresUpdateModel="true"
Action="invokeMethod" MethodName="setOutput"
IsViewObjectMethod="false"

ReturnName="Output.methodResults.setOutput_Output_dataProvider_setOutput_result">
<NamedData NDName="output" NDType="java.lang.String"/>
</methodAction>

1.8 デプロイメント後のプレゼンテーション・サービス接続の追加または変更

Oracle BI EEには、デプロイしたBI ADFまたはWebCenter Portal: Spacesアプリケーションに新しい接続を追加するためのADF Mbeanが用意されています。デプロイしたアプリケーションの既存の接続を変更することもできます。MBeanはアプリケーションとともにデプロイされ、デプロイメント後にFusion Middleware Controlを使用してアクセスできます。

設計時にSSLを構成しなかった場合は、デプロイメント後に構成できます。詳細は、「SSLを構成してOracle BI EEプレゼンテーション・サービス接続を作成する方法」を参照してください。

1.8.1 プレゼンテーション・サービス接続を追加または変更する方法

デプロイしたアプリケーションで使用されるプレゼンテーション・サービス接続を追加または変更するには、次の手順を実行します。

1.8.1.1 プレゼンテーション・サービス接続の追加または変更

アプリケーションのデプロイ後に接続を構成するには、次の手順を実行します。

1. Fusion Middleware Controlを開き、WebLogicドメインを選択します。

2. アプリケーションがBI ADFドメインにデプロイされている場合は、アプリケーション・デプロイメント <your domain>ツリー・ノードを選択します。
アプリケーションがWebCenter Portal: Spacesドメインにデプロイされている場合は、「Web Center」ツリー・ノード→「WebCenter Spaces」ツリー・ノード→webcenter (WLS_Spaces)ツリー・ノードを選択します。

3. リストから、「システムMBeanブラウザ」を選択します。「システムMBeanブラウザ」ペインが「Fusion Middleware Control」ページに表示されます。

4. 「システムMBeanブラウザ」ペインで、次のパスをたどって「ADF接続」ツリー・ノードに移動します。

1. 「アプリケーション定義のMBean」ツリー・ノードを選択します。

2. 「oracle.adf.share.connections」ツリー・ノードを選択します。

3. 「サーバー: <サーバー名>」ツリー・ノードを選択します。たとえば、「サーバー:DefaultServer」または「サーバー:WLS_Spaces」などです。

4. 「アプリケーション:<アプリケーション名>」ツリー・ノードを選択します。たとえば、「アプリケーション:Application2」または「アプリケーション:webcenter」などです。

5. 「ADF接続」ツリー・ノードを選択します。

6. 「ADF接続」ツリー・ノードを選択します。対応するMBean情報が、「アプリケーション定義のMBean」ペインに表示されます。

5. 「アプリケーション定義のMBean」ペインで「操作」タブをクリックし、「createConnection/findOrCreateConnection」をクリックして、プレゼンテーション・サービス接続を作成します。「操作: createConnection」ダイアログが表示されます。

6. 接続に必要な値を指定します。接続タイプの「値」フィールドに、BISoapConnectionと入力します。接続名の「値」フィールドに名前を入力します。「呼出し」をクリックして、接続を作成します。

7. 「システムMBeanブラウザ」ペインで、「リフレッシュ」をクリックしてツリーをリフレッシュし、新しい接続を表示します。

8. 接続を変更するには、「システムMBeanブラウザ」ペインでこれを検索してクリックします。接続の情報が、「アプリケーション定義のMBean」ペインに表示されます。

9. 「属性」タブをクリックして、BISoap接続情報を入力します。「適用」ボタンをクリックして、変更内容を適用します。

10. 「操作」タブをクリックし、「保存」をクリックして接続を保存します。

1.9 Oracle BIプレゼンテーション・カタログに接続するための資格証明

設計時に、Oracle BIプレゼンテーション・カタログに接続するための資格証明を指定する必要があります。これらの資格証明を使用して、ビジネス・インテリジェンス・オブジェクトのリスト(分析、ダッシュボードおよびスコアカード・コンポーネントなど)をOracle BIプレゼンテーション・カタログから取得します。

このプロセスにより、プレゼンテーション・サーバーへのログインはアプリケーションの現行ユーザーと同じになり、現行ユーザーとしてアクセス・チェックが実行され、現行ユーザーとしてデータがフェッチされるようになります。ADFページにユーザーがアクセスできないビジネス・インテリジェンス・オブジェクトが含まれる場合、オブジェクトへの適切な権限を持っていないことを知らせるメッセージが返されます。

1.9.1 偽装ユーザーの作成および使用方法

BIImpersonateUserユーザーを作成および使用して、Oracle BIプレゼンテーション・サービス接続を利用し、Oracle BI EEオブジェクトを含むアプリケーションを保護するには、次の手順を実行します。偽装ユーザーの資格証明をOracle BI EEプレゼンテーション・サービス接続に適用するには、事前にアプリケーションでADFセキュリティが有効になっている必要があります。

偽装ユーザー機能は、Oracle BI EEとADFがOracle Internet Directory (OID)を共有していない場合に、Oracle BI EEオブジェクトを含むアプリケーションを保護します。偽装ユーザーの作成および使用プロセスを開始する前に、使用環境でこの機能が構成されていることを確認する必要があります。

1.9.1.1 BIImpersonateUserの作成

この手順を実行する前に、アイデンティティ・ストアでユーザーを作成し、このレルムの各ユーザーにBIConsumerロールを割り当てておく必要があります。

次の手順を使用して、アイデンティティ・ストアでBIImpersonateUserユーザーを作成します。

1. Oracle BI EEインスタンスのためにWebLogic Serverを開きます。

2. 「ドメイン構造」ペインを検索して、「セキュリティ・レルム」を選択します。「レルム」ペインが表示されます。

3. 「レルム」ペインで、「<myrealm>」を選択します。「設定」ダイアログが表示されます。

4. 「設定」ダイアログで、「ユーザーとグループ」タブを選択します。

5. 「ユーザー」タブが表示されていることを確認して、「新規」をクリックします。

6. ユーザー名にBIImpersonateUserを指定して、パスワードを入力します。

7. 「OK」をクリックします。

1.9.1.2 BIImpersonateUserへの権限の付与

Fusion Middleware Controlを使用してBIImpersonateUserユーザーに権限を付与するには、次の手順を実行します。

1. Oracle BI EEインスタンスのFusion Middleware Controlを開きます。

2. bifoundation_domainを検索して選択します。「bifoundation_domain」ペインが表示されます。

3. 「bifoundation_domain」ペインで「WebLogicドメイン」リストをクリックし、「セキュリティ」を強調表示して「アプリケーション・ポリシー」を選択します。「検索」ペインが表示されます。

4. 「アプリケーション・ストライプ」リストで、obiを選択します。

5. 「プリンシパル・タイプ」リストで、「ユーザー」を選択します。

6. 「作成」をクリックします。「アプリケーション権限の作成」ペインが表示されます。

7. 「権限」の下で、「新規権限の追加」をクリックして、「権限の追加」ペインで次のアクションを実行します。

1. 「権限クラス」リストで、「oracle.security.jps.ResourcePermission」を選択します。

2. 「リソース・タイプ」を選択します。

3. 「リソース・タイプ」リストで、「oracle.bi.user」を選択して、「続行」をクリックします。

4. 「リソース名」フィールドで、1人のユーザーまたはすべてのユーザーを偽装する権限を付与するかどうかに応じて次のアクションを実行します。

- 1人のユーザーを偽装する権限の場合、ユーザーの名前を入力します。

- すべてのユーザーを偽装する権限の場合、アスタリスク(*)を入力します。

5. 権限アクションには、「偽装」を選択して、「選択」をクリックします。

8. 「権限受領者」の下で、「ユーザーの追加」をクリックして、「プリンシパルの追加」ペインで次のアクションを実行します。

1. 「タイプ」リストで、「ユーザー」を選択します。

2. 「ロールの検索」をクリックします。

3. 「BIImpersonateUser」を選択して「OK」をクリックします。

9. 「bifoundation_domain」ペインで、「OK」をクリックします。

1.9.1.3 サーバーの再起動

変更内容が表示されない場合は、次の手順を実行します。

1. 次のサーバーを停止して再起動します。

- Oracle BI EEサーバー

- Oracle BI EEプレゼンテーション・サーバー

- WebLogic Server

1.10 スタンドアロンWebLogic Serverへの資格証明のデプロイ

OPSSを使用するJava EEアプリケーションで推奨される、手動による構成およびパッケージ化の詳細は、Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドの第21章「OPSSを使用するためのJava EEアプリケーションの構成」を参照してください。

アプリケーション・レベルでパッケージ化された資格証明は、weblogic-application.xml内のリスナーの構成の指定どおりに、ドメイン・レベルの資格証明ストアに移行されます。例:

<listener>
<listener-class>oracle.security.jps.wls.listeners.Jps
ApplicationLifecycleListener</listener-class>
</listener>

開発モードのデフォルトでは、資格証明の移行パラメータは、weblogic-application.xmlでOVERWRITEに設定されています。本番モードでは、OVERWRITEを使用できないことに注意してください。次に開発モード用の資格証明移行パラメータの設定例を示します。

<application-param>
<param-name>jps.credstore.migration</param-name>
<param-value>OVERWRITE</param-value>
</application-param>

1.10.1 資格証明の移行

この手順を使用して、アプリケーション・レベルからドメイン・レベルへ資格証明を自動的に移行することができます。

資格証明の移行パラメータの詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』の動作による資格証明パラメータの構成に関する項を参照してください。

資格証明を移行するには

動作中のモード(開発モードまたは本番モード)に応じ、次のいずれかのオプションを使用して、アプリケーション・レベルからドメイン・レベルへ資格証明を自動的に移行することができます。

- 開発モードで動作中の場合、jps.app.credential.overwriteがtrueに設定された、資格証明の上書き移行操作でWebLogic Serverが起動されていることを確認します。例:

jps.app.credential.overwrite.allowed=true

- 本番モードで動作中の場合、weblogic-application.xmlを開いてjps.credstore.migrationパラメータをMERGEに変更します。ファイルを保存してEARファイルを再パッケージ化してから、ファイルをスタンドアロンのWebLogic Serverにデプロイします。
この作業を完了しても、アプリケーション・レベルの資格証明がドメイン・レベルのストアに移行されるのは、ドメイン・レベルのストアに資格証明が存在しない場合のみであることに注意してください。たとえば、次のデータベースの資格証明を使用して、アプリケーションをパッケージ化したとします。

- ユーザー名 – User1

- パスワード – Pass1

これらの資格証明(User 1およびPass1)は、資格証明が初めて移行されるため、移行されます。

パスワードがPass1からPass2に変更された場合、jps.credstore.migrationパラメータがMERGEに設定されているため、Pass1はPass2で上書きされません。

2 Oracle BI EEオブジェクトを含むADFアプリケーションのパフォーマンスの向上

この章では、Oracle BI EEオブジェクトを含むOracle ADFアプリケーションのパフォーマンス向上のために実行できる、タイムアウトの追加および設定と静的リソースの使用などのチューニング手順について説明します。

この章では次の項について説明します。

- Oracle BIサーバーのタイムアウトの設定

- セッション・タイムアウトの追加

- 静的リソースの使用

2.1 Oracle BIサーバーのタイムアウトの設定

SOAPリクエストがOracle BIサーバーからのレスポンスをタイムアウトになるまで待機する時間を指定するプロパティをOracle WebLogic Serverに渡すことで、システム・パフォーマンスを向上させることができます。

2.1.1 Oracle BIサーバーのタイムアウトの設定方法

次のプロパティをOracle WebLogic Serverに渡して、SOAPリクエストがOracle BIサーバーからのレスポンスをタイムアウトになるまで待機する時間を調整します。初期推奨設定は、約60秒です。必ず、WebLogic Serverでスタック・スレッドの検出に構成されている値よりも小さい値を指定してください。

スタック・スレッドの検出の構成の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverパフォーマンスおよびチューニング』のスタック・スレッドの検出動作のチューニングに関する項を参照してください。

詳細は、「タイムアウト設定の例」を参照してください。

- -Dsun.net.client.defaultReadTimeout=timeout_in_milliseconds

- -Dsun.net.client.defaultConnectTimeout=timeout_in_milliseconds

2.1.2 タイムアウト設定の例

次の例は、タイムアウト値を60秒に設定する方法を示しています。

Windowsの場合:

commEnv.cmd
set CONFIG_JVM_ARGS=-Dsun.net.client.defaultReadTimeout=60000 -Dsun.net.client.defaultConnectTimeout=6000

Linuxの場合:

commEnv.s
setenv CONFIG_JVM_ARGS -Dsun.net.client.defaultReadTimeout=60000 -Dsun.net.client.defaultConnectTimeout=60

2.2 セッション・タイムアウトの追加

Oracle BI ADF統合コードは、ADF HTTPセッションがクローズまたはタイムアウトした場合のセッションの自動クローズをサポートしています。

2.2.1 セッション・タイムアウトの追加方法

アプリケーションが自動的にクローズするようにアプリケーションのweblogic.xmlを変更するには、次の手順を実行します。

1. JDeveloperで、アプリケーション・ナビゲータに移動して「プロジェクト」タブを開き、プロジェクトのWEB-INFサブディレクトリに移動してweblogic.xmlドキュメントを開きます。

2. 次の行をドキュメントに追加します。

<listener>
<listener-class>oracle.bi.presentation.listener.BIADFServletSessionListener
</listener-class>
</listener>

2.3 静的リソースの使用

Oracle BIサーバーまたは他のサーバーにある静的リソースを使用するように、Oracle BIプレゼンテーション・サービス接続を構成できます。.javascriptや.cssなどの静的リソースを指定することで、Oracle BI EEオブジェクトを含むADFアプリケーションのパフォーマンスが著しく向上します。

2.3.1 静的リソースのプリファレンスの設定方法

保存されているOracle BIプレゼンテーション・サービス接続のために静的リソースのプリファレンスを指定するには、次の手順を実行します。

Oracle BI EEでの静的リソースの設定の詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド』のOracle BI Webクライアントのパフォーマンスの向上に関する項を参照してください。

新規接続の作成および静的リソースの指定の詳細は、「Oracle BI EEプレゼンテーション・サービス接続の作成」を参照してください。

1. JDeveloperで、アプリケーション・ナビゲータの「アプリケーション・リソース」タブまたはリソース・パレットに移動して、変更するOracle BIプレゼンテーション・サービス接続を選択します。

2. 選択したデータ接続を右クリックして、「プロパティ」を選択します。「BIプレゼンテーション・サービス接続の編集」ウィザードが表示されます。

3. 「BIプレゼンテーション・サービス」ページで、静的リソースの設定を指定します。次のフィールドに注意してください。

- 静的リソースのモード– 静的リソースの取得元を指定します。
すべてのリクエストをOracle BIプロキシではなくOracle BIプレゼンテーション・サービスに送るには、「自動」を選択します。「自動」を選択すると、パフォーマンスが著しく向上します。「自動」モードで最もよいパフォーマンスが得られるのは、Oracle WebLogic ServerがOracle HTTP ServerまたはApache HTTP Serverの内側にあり、Oracle WebLogic Serverをバイパスして静的ファイルを提供する場合です。

リクエストを別の場所に送るには、「手動」を選択します。「手動」を選択する場合、「静的リソースの場所」フィールドでURLを指定する必要があります。

- 静的リソースの場所- (オプション)「静的リソースのモード」フィールドで「手動」を選択した場合、デプロイした静的リソースの場所を入力します(Oracle BIインストール内に配置されていない場合)。URLの書式はhttp://host:port/analyticsにします。たとえば、http://bips:9704/analyticsなどです。静的リソースの例としては、.cssや.javascripなどがあります。Oracle BIがファイアウォールの内側にあり、ADFインスタンスへのポートがファイアウォールの外側にある場合、このフィールドは空白のままにします。

4. 「終了」をクリックして、変更内容を保存します。

2.3.2 静的リソースの場所のテスト

静的リソースの場所の設定(URL)が有効かどうかをテストするには、次の手順を実行します。

1. 静的リソースの設定を指定したOracle BIプレゼンテーション・サービス接続を使用するアプリケーションを作成します。

2. データ接続から分析を参照し、これを.jspxページにドラッグ・アンド・ドロップします。

3. アプリケーションを保存します。

4. アプリケーションをデプロイして実行します。

5. Firebugなどのツールを使用して、.jsおよび.pngファイルに対するリクエストが、接続で指定した静的リソースのURLから直接ロードされることを検証します。404(または「Not Found」)エラー・メッセージが表示される場合は、静的リソースの設定で無効なURLが指定されています。

3 ADFアプリケーションへのBIコンポーザの追加

この章では、Oracle ADFアプリケーションにBIコンポーザ・コンポーネントを追加する方法について説明します。また、ドメインの拡張によるBIコンポーザ受け入れのためのADFプロジェクトの準備方法、パラメータおよびイベントの追加によるタスク・フローの埋込みについて説明します。

この章では次の項について説明します。

- ADFアプリケーションでのBIコンポーザの使用の概要

- ADFアプリケーションへのBIコンポーザの追加

3.1 ADFアプリケーションでのBIコンポーザの使用の概要

ADFアプリケーションにBIコンポーザ機能を追加できます。BIコンポーザは、ADFアプリケーションからOracle BI EE分析の設計を迅速かつ容易に作成、編集または表示するための、使いやすいウィザードです。

構成されている場合、BIコンポーザ・インタフェースにより、ADFアプリケーション・ユーザーはOracle BI EEカタログおよびサブジェクト・エリアの参照、分析の列の選択または変更、ビューの追加(表やグラフなど)、データのソートおよびフィルタ、表に表示されるデータへの条件付き書式設定の適用を行うことができます。BIコンポーザ・インタフェースの使用方法の詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』の分析でのBIコンポーザの使用に関する項を参照してください。

WebCenterポータル・アプリケーションまたはWebCenter Portal: SpacesへのBIコンポーザの追加には、少し異なる設定が必要です。BIコンポーザを使用するようにWebCenterポータル・アプリケーションまたはWebCenter Portal: Spacesを構成する方法については、「WebCenterポータル・アプリケーションまたはWebCenter Portal: SpacesへのBIコンポーザの追加」を参照してください。

3.2 ADFアプリケーションへのBIコンポーザの追加

ADFアプリケーションにBIコンポーザを追加するには、ADFアプリケーションにBIコンポーザ・ライブラリ・リファレンスを追加し、ドメイン拡張テンプレートを適用し、ADFアプリケーションにタスク・フロー・パラメータおよびタスク・フロー・イベントを追加する必要があります。

3.2.1 インストールされているJDeveloper拡張機能の確認

Oracle JDeveloperでは、次のOracle BI EE拡張機能を提供します。

- ビジネス・インテリジェンスADFタスク・フロー

- ビジネス・インテリジェンスADFビュー・リージョン

- ビジネス・インテリジェンス・コンポーザ

- ビジネス・インテリジェンス論理SQLビュー・オブジェクト

- ビジネス・インテリジェンスSOAP接続

必要なOracle JDeveloper 11g拡張機能およびOracle BI EE拡張機能があるかどうか不明な場合は、この手順を実行します。

1. JDeveloperで「ヘルプ」メニューをクリックし、「バージョン情報」をクリックします。表示される「Oracle JDeveloper 11gのバージョン情報」ダイアログ・ボックスで、リリース番号を確認できます。

2. 「拡張機能」タブをクリックして、インストールされている拡張機能のリストを表示します。リストをソートするには、「名前」または「識別子」列ヘッダーをクリックします。
Oracle BI EE拡張機能にはすべて、「bi-」接頭辞が付いています。「bi-」接頭辞で始まる拡張子がない場合、必要な拡張機能はありません。

3.2.2 必要なJDeveloper拡張機能のインストール

必要な拡張機能をインストールするには、次の手順を実行します。

1. JDeveloperの「ヘルプ」メニューから、「更新の確認」を選択します。

2. ウィザードの手順に従って、Oracle BI EE拡張機能を検索、ダウンロードおよびインストールします。Oracle BI EEと統合するWebCenterポータル・アプリケーションを作成する場合は、WebCenterポータル・フレームワークもインストールする必要があります。
使用可能なOracle BI EE拡張機能のリストは、「インストールされているJDeveloper拡張機能の確認」を参照してください。

3.2.3 BIコンポーザ・ライブラリ・リファレンスの追加方法

必要なライブラリ・リファレンスをアプリケーションに追加するには、次の手順を実行します。この手順を実行する前に、Oracle BI EEオブジェクトを受け入れるようにADFプロジェクトを設定しておく必要があります。詳細は、「ビジネス・インテリジェンス・オブジェクトを受け入れるためのADFプロジェクトの準備」を参照してください。

1. アプリケーションのweblogic.xmlを開きます。

2. 次のライブラリ・リファレンスを追加します。

<library-ref>
<library-name>oracle.bi.composer</library-name>
</library-ref>

3. アプリケーションのweblogicapplication.xmlドキュメントを開きます。

4. 次のライブラリ・リファレンスを追加します。

<library-ref>
<library-name>oracle.bi.jbips</library-name>
</library-ref>

3.2.4 ドメインの拡張方法

ドメイン拡張テンプレートを適用してBIコンポーザ実装ライブラリをデプロイするには、次の手順に従います。

1. Oracle BI EEのインストール・ディレクトリに移動します。

2. 次のサブステップに従って、必要な拡張テンプレートおよびライブラリをOracle BI EEのOracle_Home/からコピーして、ターゲット・アプリケーションのOracle_Home/に貼り付けます。

1. Oracle BI EEのインストールに移動して、Oracle_Home//common/templates/applications/oracle.bicomposer.slib_template_11.1.1.jarをコピーします。ターゲット・アプリケーションのインストールに移動して、ファイルをOracle_Home//common/templates/applicationsに貼り付けます。

2. Oracle BI EEのインストールに移動して、Oracle_Home//modules/oracle.bi.presentation_11.1.1/bi-composer-slib.warをコピーします。ターゲット・アプリケーションのインストールに移動して、ファイルをOracle_Home//modules/oracle.bi.presentation_11.1.1に貼り付けます。

3. Oracle BI EEのインストールに移動して、Oracle_Home//modules/oracle.bi.presentation_11.1.1/bi-jbips-slib.earをコピーします。ターゲット・アプリケーションのインストールに移動して、ファイルをOracle_Home//modules/oracle.bi.presentation_11.1.1に貼り付けます。

3. WebLogic Serverを停止します。

4. 構成ウィザードを起動します。

5. 「既存のWebLogicドメインの拡張」を選択して、「次へ」をクリックします。

6. ドメイン・フォルダ(my_home/user_projects/domains/bifoundation_domainなど)を選択して、「次へ」をクリックします。

7. 拡張テンプレートを使用した拡張を選択し、「参照」を使用して次のテンプレートを選択します。
ORACLE_HOME//common/templates/applications/oracle.bicomposer.slib_template_11.1.1.jar

インストールしたテンプレートのオーバーライドを求めるプロンプトが表示されたら、「はい」をクリックします。

8. 「次へ」をクリックし、必要に応じて設定を変更します。

9. 「拡張」をクリックし、「完了」をクリックします。

10. WebLogic Serverを起動します。

3.2.5タスク・フロー・パラメータおよびイベントの追加方法

このトピックの手順を使用して、アプリケーション・ページにタスク・フローを埋め込みます。

このトピックの内容は次のとおりです。

- 「BIコンポーザ・ウィザードのエディタ・タスク・フロー」

- 「BIコンポーザ・ウィザードの編集イベント」

- 「BIコンポーザ・ウィザードのビューア・タスク・フロー・パラメータ」

3.2.5.1 BIコンポーザ・ウィザードのエディタ・タスク・フロー

次の情報を使用し、ページの他の要素に基づいたパラメータ値で、タスク・フローを初期化します。たとえば、ユーザーがページの分析リストから選択した分析を編集するために、選択した分析をパラメータとしてウィザードに渡す必要がある場合に、これらのパラメータを使用します。

タスク・フロー・ドキュメントの場所は次のとおりです。

WEB-INF/oracle/bi/adf/apps/answers/flow/BIReportWizardTF.xml

タスク・フローのIDは次のとおりです。

id: BIReportWizardTF

タスク・フローへのパラメータの追加の詳細は、Oracle Fusion Middleware Oracle Application Development FrameworkのためのFusion開発者ガイドの第16章「タスク・フローでのパラメータの使用」を参照してください。

表3-1は、各タスク・フロー・パラメータ、その説明、型、デフォルト値および必須かどうかを示しています。

表3-1 BIコンポーザ・レポート・ウィザードのエディタ・タスク・フロー・パラメータ

名前

説明

型

必須か

デフォルト値

biReportPath

編集する分析のカタログ・パス。

String

いいえ

NULL

biReportContainerPath

編集する分析のカタログ親フォルダ・パス。

このパラメータは、ショートカットの分析を選択する際に使用されます。

String

いいえ

NULL

biSubjectArea

新しい分析を作成するサブジェクト・エリア。

String

いいえ

NULL

biConnectionId

デプロイされているOracle BI EEプレゼンテーション・サービス接続のID。

String

いいえ

bi-default

biCatalogOverwriteAllowed

このフラグは、カタログ内の既存の分析を上書きできるかどうかを示します。

Boolean

いいえ

false

biReportXML

編集に使用する分析のXML。

String

いいえ

NULL

biReportHeight

レポートのレンダリングで使用するダッシュボードの高さです。たとえば、1024x768ピクセル解像度には、biReportHeightを768pxに指定します。

String

いいえ

NULL

biReportWidth

レポートのレンダリングで使用するダッシュボードの幅です。たとえば、1024x768ピクセル解像度には、biReportWidthを1024pxに指定します。

String

いいえ

NULL

biTenantId

未使用

N/A

N/A

N/A

biShowPreviewDefault

このフラグは、プレビューがデフォルトでオンになっているかどうかを示します。

Boolean

いいえ

false

biShowIncompatibilityMessages

このフラグは、BIコンポーザと互換性のない分析を開いたときに、警告メッセージを表示する必要があるかどうかを示します。

Boolean

いいえ

true

biReportViewName

未使用

N/A

N/A

N/A

biPromptFilterXML

未使用

N/A

N/A

N/A

biDebugMode

このフラグは、デバッグ分析XMLを生成するアイコンがデフォルトで表示されるかどうかを示します。

Boolean

いいえ

false

biReportLinks

このカンマ区切りの値は、インタラクティブ・プレビューに表示されるレポート・リンクを示します。

String

いいえ

NULL

有効な値は次のとおりです。

- r
リフレッシュ。「リフレッシュ」リンクを表示します。

- f
印刷。「印刷」リンクを表示します。

- d
ダウンロード。「エクスポート」リンクを表示します。

- -
なし。リンクを表示しません。

たとえば、f,r,dを使用して、サポートされているすべてのリンクを表示します。

Nullは、表示しない場合のデフォルトとして扱われます。

biViewReportLinks

このパラメータは、リンクが分析と共に表示されるかを指定します。

String

いいえ

なし

有効な値は次のとおりです。

- r
「リフレッシュ」リンクを表示します。

- f
「印刷」リンクを表示します。

- d
「エクスポート」リンクを表示します。

- -
なし。リンクを表示しません。

biInteractivePreview

このフラグは、レンダリング・フラグがインタラクティブ・モードかどうかを示します。

Boolean

いいえ

false

3.2.5.2 BIコンポーザ・ウィザードの編集イベント

次の情報を使用して、BIコンポーザ・ウィザードから特定の処理を実行するイベントを追加します。たとえば、BIコンポーザ・ウィザードで分析が編集された後に、ウィザードのタスク・フローで開始される保存イベントを追加できます。このイベントは、アプリケーションのカタログ・フリーをリフレッシュします。

タスク・フロー・ドキュメントの場所は次のとおりです。

WEB-INF/oracle/bi/adf/apps/answers/flow/BIReportWizardTF.xml

タスク・フローのIDは次のとおりです。

BIReportWizardTF

タスク・フローへのパラメータの追加の詳細は、Oracle Fusion Middleware Oracle Application Development FrameworkのためのFusion開発者ガイドの第16章「タスク・フローでのパラメータの使用」を参照してください。

表3-2は、各イベント、その説明およびペイロードを示しています。

表3-2 BIコンポーザ・レポート・ウィザードのエディタ・タスク・フロー・イベント

イベント名

説明

ペイロード

biAnsReportWizardCancelEvent

ウィザードの「取消」ボタンをクリックすると、トリガーされます。

なし

biAnsReportWizardSaveEvent

分析をカタログに保存すると、トリガーされます。

カタログに保存された分析へのパス。

biAnsReportWizardRefreshCatalogEvent

名前の変更や削除など、外部コンシューマによるカタログ・ツリーのリフレッシュを必要とするアクションを実行すると、トリガーされます。

カタログのリフレッシュを必要とするアクションのソースであった、カタログ内の分析へのパス。

3.2.5.3 BIコンポーザ・ウィザードのビューア・タスク・フロー・パラメータ

次の情報を使用し、ページの他の要素に基づいたパラメータ値で、タスク・フローを初期化します。たとえば、分析をレンダリングするために、ページの分析リストから選択した分析をパラメータとしてビューアに渡す必要がある場合に、これらのパラメータを使用します。

タスク・フロー・ドキュメントの場所は次のとおりです。

WEB-INF/oracle/bi/adf/apps/answers/flow/BIReportViewerTF.xml

タスク・フローのIDは次のとおりです。

id: BIReportViewerTF

タスク・フローへのパラメータの追加の詳細は、Oracle Fusion Middleware Oracle Application Development FrameworkのためのFusion開発者ガイドの第16章「タスク・フローでのパラメータの使用」を参照してください。

表3-3は、各タスク・フロー・パラメータ、その説明、型、デフォルト値および必須かどうかを示しています。

表3-3 BIコンポーザ・レポート・ウィザードのビューア・タスク・フロー・パラメータ

パラメータ名

説明

型

必須か

デフォルト値

biReportPath

表示する分析のカタログ・パス。

String

いいえ

NULL

biConnectionId

デプロイされているOracle BI EEプレゼンテーション・サービス接続のID。

String

いいえ

bi-default

biReportXML

編集に使用する分析のXML。

String

いいえ

NULL

biTenantId

未使用

N/A

N/A

N/A

biContentType

表示するコンテンツのタイプ: 分析の場合は「biReportContent」、ダッシュボードの場合は「biDashboardContent」。

String

いいえ

NULL

biReportViewName

未使用

N/A

N/A

N/A

biReportLinks

このカンマ区切りの値は、インタラクティブ・プレビューに表示されるレポート・リンクを示します。

String

いいえ

NULL

有効な値は次のとおりです。

- r
リフレッシュ。「リフレッシュ」リンクを表示します。

- f
印刷。「印刷」リンクを表示します。

- d
ダウンロード。「エクスポート」リンクを表示します。

- -
なし。リンクを表示しません。

たとえば、f,r,dを使用して、サポートされているすべてのリンクを表示します。

Nullは、表示しない場合のデフォルトとして扱われます。

biReportSizing

このパラメータをstretchに設定すると、レポートまたはダッシュボード・コンテンツをbiReportHeightおよびbiReportWidthの設定とは無関係に引き伸ばします。

このパラメータをsizeに設定すると、レポートまたはダッシュボード・コンテンツをbiReportHeightおよびbiReportWidthの設定に基づいて引き伸ばします。

String

いいえ

Size

4 Oracle BI EE論理SQLビュー・オブジェクトの使用

この章では、Oracle Business Intelligence論理SQLビュー・オブジェクトを作成および追加して、Oracle BI EEデータをADFアプリケーションのコンポーネントにバインドする方法について説明します。また、必要なBI JDBCデータ・ソースおよびJDBC接続の作成方法、偽装用のBI JDBCデータ・ソースの構成方法およびOracle Business Intelligence SQLビュー・オブジェクトの拡張方法について説明します。

この章では次の項について説明します。

- Oracle BI EE論理SQLビュー・オブジェクトの概要

- Oracle Business Intelligence論理SQLビュー・オブジェクトのユース・ケース

- Oracle Business Intelligence論理SQLビュー・オブジェクトの作成

- BI JDBCデータ・ソースの作成

- Oracle Business Intelligence論理SQLビュー・オブジェクトの拡張

4.1 Oracle BI EE論理SQLビュー・オブジェクトの概要

ビジネス・インテリジェンス論理SQLビュー・オブジェクトにより、Oracle Business Intelligenceサーバーにアクセスして、ネイティブのADFコンポーネントをOracle BI EEデータにバインドするADFアプリケーションを作成できます。

Oracle Business Intelligenceビュー・オブジェクトは、select句内のアイテムを属性として公開します。ビジネス・インテリジェンス論理ビュー・オブジェクトの設定の完了後は、ADFアプリケーションで他のビュー・オブジェクトを使用できる任意の場所で、Oracle Business Intelligence論理SQLビュー・オブジェクトを使用できます。たとえば、Oracle Business Intelligenceビュー・オブジェクトの属性を操作スキーマからデータを返す別のビュー・オブジェクトの属性と結合するためのビュー・リンクを作成できます。Oracle Business Intelligenceビュー・オブジェクトのデータ、またはビュー・リンクを使用して作成した結合されたデータを、JDeveloperで自動的に生成されるデータ・コントロールを使用して、任意のADFリッチ/Facesコンポーネントで容易に表示できます。

ADFページに分析、ダッシュボード、スコアカード・コンポーネントなどのビジネス・インテリジェンス・オブジェクトを追加することで、Oracle BIプレゼンテーション・カタログにアクセスし、カタログを参照し、ADFページに追加するOracle BI EEオブジェクトを選択できます。この方法によるADFページへのビジネス・インテリジェンス・データの追加の詳細は、第1章「ADFアプリケーションへのビジネス・インテリジェンス・オブジェクトの埋込み」を参照してください。

4.2 Oracle Business Intelligence論理SQLビュー・オブジェクトのユース・ケース

次のユース・ケース・シナリオは、Oracle Business Intelligence論理SQLビュー・オブジェクトを使用して堅牢なADFページを作成する方法をわかりやすく説明するために作成されました。各ユース・ケースは、シナリオと一般的な手順で構成されています。

4.2.1 論理SQLからのデータをADFリッチ・ユーザー・インタフェース・コンポーネントで表示

このユース・ケースでは、論理SQL文から返されたデータをADF Facesまたはリッチ・ユーザー・インタフェース・コンポーネントで表示する方法について説明します。このユース・ケースでは、地域および地区別収益データを読取り専用のリッチ・テーブル・フォーマットで表示します。

ヒント:
このユース・ケースでは、データをリッチ・テーブルで表示する1つの方法について説明しています。一般に、分析をADFページに埋め込む方が簡単です。

論理SQLからのデータをADFリッチ・ユーザー・インタフェース・コンポーネントで表示するには:

1. ADFページで表示するデータを含むOracle BI EEサーバーへのJDBC接続を作成します。詳細は、「BI JDBC接続の作成」を参照してください。

2. 標準JDBC接続を使用するアプリケーション・モジュールを作成します。詳細は、「ADFプロジェクトの初期化」を参照してください。

3. JDBC接続をポイントし、次の論理SQLを使用する、Oracle Business Intelligenceビュー・オブジェクトを作成します。地域、地区、ドルはビュー・オブジェクトの属性として自動的に追加されます。
"Select Markets.Region, Markets.District, Sales Measures.Dollars from Paint"

4. 「ビュー・オブジェクトの作成」ウィザードの「アプリケーション・モデル」ページに移動し、アプリケーション・モジュールに作成したビュー・オブジェクトのインスタンスを追加します。このユース・ケースでは、アプリケーション・モジュールの名前は「BIVO_AppModule」であるとします。
JDeveloperで、BIVO_AppModuleDataControlが自動的に作成されます。このデータ・コントロールの下に、ビュー・オブジェクトがすべての属性とともにコレクションとして表示されます。

5. ビュー・オブジェクト・コレクションをデータ・コントロールからJSPXページの適切な場所にドラッグ・アンド・ドロップします。ショートカット・メニューが表示されたら、ビュー・オブジェクトの表示に使用する適切なADFリッチUIコンポーネントを選択します。

6. 表示に使用する読取り専用のリッチ・テーブルを選択します。

4.2.2 論理SQLからのデータの表示およびランタイム・パラメータの引渡し

このユース・ケースは、「論理SQLからのデータをADFリッチ・ユーザー・インタフェース・コンポーネントで表示」ユース・ケースを拡張したものです。ただし、このユース・ケースでは、収益がユーザー入力値よりも大きい場合にのみ、地域および地区別収益データを論理SQLから表示します。これは、ランタイム・パラメータを渡すことで実行できます。

論理SQLからのデータを表示し、ランタイム・パラメータを引き渡すには:

1. ADFページで表示するデータを含むOracle BI EEサーバーへのJDBC接続を作成します。詳細は、「BI JDBC接続の作成」を参照してください。

2. 標準JDBC接続を使用するアプリケーション・モジュールを作成します。詳細は、「ADFプロジェクトの初期化」を参照してください。

3. JDBC接続をポイントし、次の論理SQLを使用する、Oracle Business Intelligenceビュー・オブジェクトを作成します。地域、地区、ドルはビュー・オブジェクトの属性として自動的に追加されます。
"Select Markets.Region, Markets.District, Sales Measures.Dollars from Paint"

4. ドル属性にマップされるバインド変数を追加します。

5. 「ビュー・オブジェクトの作成」ウィザードの「アプリケーション・モデル」ページに移動し、アプリケーション・モジュールに作成したビュー・オブジェクトのインスタンスを追加します。このユース・ケースでは、アプリケーション・モジュールの名前は「BIVO_AppModule」であるとします。
JDeveloperで、BIVO_AppModuleDataControlが自動的に作成されます。このデータ・コントロールの下に、ビュー・オブジェクトがすべての属性とともにコレクションとして表示されます。DataControlには、ドル・パラメータをとるExecuteWithParam操作も表示されます。

6. ビュー・オブジェクト・コレクションをデータ・コントロールからJSPXページの適切な場所にドラッグ・アンド・ドロップします。ショートカット・メニューが表示されたら、ビュー・オブジェクトの表示に使用する適切なADFリッチUIコンポーネントを選択します。

7. 表示に使用する読取り専用のリッチ・テーブルを選択します。

8. 収益のしきい値の入力を求めるための、適切な入力コンポーネントを作成します。

9. ユーザーが書式を送信し、前に作成したリッチ・テーブルをリフレッシュするときに、ExecuteWithParam操作を起動して、収益のしきい値を渡します。

4.2.3 オンライン・トランザクション処理スキーマからのデータと論理SQLからのデータのADFリッチ・コンポーネントでの表示

このユース・ケースでは、次の列を含むADFリッチ・テーブルを表示する方法を説明します。

- 顧客

- 買掛/未払金回転日数

- 残存期間値

- 年度累計収益別顧客ランク

「買掛/未払金回転日数」値はオンライン・トランザクション処理(OLTP)システムから取得し、「残存期間値」と「顧客ランク」はOracle Business Intelligenceサーバーから取得します。「顧客」は両方のシステムで共通です。

オンライン・トランザクション処理スキーマからのデータと論理SQLからのデータをADFリッチ・コンポーネントで表示するには:

1. ADFページで表示するデータを含むOracle BI EEサーバーへのJDBC接続を作成します。詳細は、「BI JDBC接続の作成」を参照してください。

2. 標準JDBC接続を使用するアプリケーション・モジュールを作成します。詳細は、「ADFプロジェクトの初期化」を参照してください。

3. OLTPシステム内で標準のビュー・オブジェクトを作成し、適切なSQL/エンティティ・オブジェクトを使用して「顧客」属性と「買掛/未払金回転日数」属性を公開します。このユース・ケースでは、ビュー・オブジェクトの名前をOLTP_VOとします。

4. ステップ1で作成したOracle BI EEサーバーへのJDBC接続を使用し、次の論理SQLを使用して、Oracle Business Intelligenceビュー・オブジェクトを作成します。
"Select Customer, Lifetime_Value, Rank (YTD Revenue) from CustomerSubjectArea"

「顧客」、「残存期間値」、「年度累計別顧客ランク」が、このビュー・オブジェクトの属性として自動的に追加されます。このユース・ケースでは、ビューの名前をBI_VOとします。

5. OLTP_VOの顧客属性をソース属性とし、BI_VOの顧客属性を宛先属性として、ビュー・リンクを作成します。

6. OLTP_VOのJava手順に移動して、ビュー・オブジェクトのJavaクラスを生成します。また、OLTP_VOにLifetime_ValueおよびRankByRevenueの属性を追加します。

7. OLTP_VO (OLTP_VOViewImpl)のJavaクラスを編集します。前の手順で追加した属性には、それぞれアクセッサ・メソッドがあります。Oracle Business Intelligenceビュー・オブジェクトから対応する値を返すように、アクセッサの実装を編集します。ビジネス・インテリジェンス・ビュー・オブジェクトは、getViewObjectメソッドを介してOLTP_VOビュー・オブジェクトで使用可能になります。たとえば、Lifetime_Valueアクセッサのコードは、次のようになります。
getViewObject().getCurrentRow().getAttribute("Lifetime_Value")

8. OLTP_VOがApplicationModuleの一部であることを確認します。OLTP_VOには、すべての属性(顧客、買掛/未払金回転日数、残存期間値、年度累計別顧客ランク)のコレクションが含まれます。

9. ビュー・オブジェクト・コレクションをデータ・コントロールからJSPXページの適切な場所にドラッグ・アンド・ドロップします。ショートカット・メニューが表示されたら、ビュー・オブジェクトの表示に使用する適切なADFリッチUIコンポーネントを選択します。

10. 表示に使用する読取り専用のリッチ・テーブルを選択します。

4.2.4 Oracle Business Intelligenceビュー・オブジェクトとオンライン・トランザクション処理ビュー・オブジェクト間のマスター/ディテール関係の作成

このユース・ケースでは、2つのOLTPビュー・オブジェクト間のマスター/ディテール関係を作成する場合と同じ方法で、マスター/ディテール関係を作成します。次に示す手順は、概略的な手順です。マスター/ディテール関係の作成の詳細は、Oracle Fusion Middleware Oracle Application Development FrameworkのためのFusion開発者ガイドを参照してください。

Oracle Business Intelligenceビュー・オブジェクトとオンライン・トランザクション処理ビュー・オブジェクト間のマスター/ディテール関係を作成するには:

1. OLTPビュー・オブジェクトを作成します。

2. Oracle Business Intelligenceビュー・オブジェクトを作成します。

3. OLTPビュー・オブジェクトとOracle Business Intelligenceビュー・オブジェクト間のビュー・リンクを作成します。

4. ソースおよび宛先ビュー・オブジェクトに対応するソースおよび宛先データ・コントロールの、適切なADFビュー・オブジェクトを作成します。

4.3 Oracle Business Intelligence論理SQLビュー・オブジェクトの作成

Oracle BI Enterprise Edition論理SQLビュー・オブジェクトを作成する前に、BI JDBC接続の作成およびJDBC接続でのADFプロジェクトの初期化、という2つの準備手順を実行する必要があります。

Oracle BI Enterprise Edition論理SQLビュー・オブジェクトを作成して保存した後、ADFアプリケーションの他のビュー・オブジェクトと特定の方法で相互作用するように、ビュー・オブジェクトの動作を変更できます。

4.3.1 Oracle Business Intelligence論理SQLビュー・オブジェクトの作成方法

次の手順を使用して、Oracle Business Intelligence論理SQLビュー・オブジェクトを準備および作成します。このオブジェクトはOracle BI EEとADFコンポーネントのバインドに使用できます。

4.3.1.1 インストールされているJDeveloper拡張機能の確認

Oracle JDeveloperでは、次のOracle BI EE拡張機能を提供します。

- ビジネス・インテリジェンスADFタスク・フロー

- ビジネス・インテリジェンスADFビュー・リージョン

- ビジネス・インテリジェンス・コンポーザ

- ビジネス・インテリジェンス論理SQLビュー・オブジェクト

- ビジネス・インテリジェンスSOAP接続

必要なOracle JDeveloper 11g拡張機能およびOracle BI EE拡張機能があるかどうか不明な場合は、この手順を実行します。

インストールされている拡張機能を確認するには:

1. JDeveloperで「ヘルプ」メニューをクリックし、「バージョン情報」をクリックします。表示される「Oracle JDeveloper 11gのバージョン情報」ダイアログ・ボックスで、リリース番号を確認できます。

2. 「拡張機能」タブをクリックして、インストールされている拡張機能のリストを表示します。リストをソートするには、「名前」または「識別子」列ヘッダーをクリックします。
Oracle BI EE拡張機能にはすべて、「bi-」接頭辞が付いています。「bi-」接頭辞で始まる拡張子がない場合、必要な拡張機能はありません。

4.3.1.2 必要なBusiness Intelligence JDeveloper拡張機能のインストール

JDeveloperの「更新の確認」ウィザードを使用し、必要なOracle BI EE拡張機能を検索してインストールします。

Oracle BI EE拡張機能をインストールするには:

1. JDeveloperの「ヘルプ」メニューから「更新の確認」を選択します。

2. ウィザードの手順に従って、Oracle BI EE拡張機能を検索、ダウンロードおよびインストールします。
使用可能なOracle BI EE拡張機能のリストは、「インストールされているJDeveloper拡張機能の確認」を参照してください。

4.3.1.3 BI JDBC接続の作成

Oracle BIサーバーへのBI JDBC接続を作成する必要があります。この接続を介して、ビュー・オブジェクトは論理SQL文をOracle BIサーバーに渡し、Oracle BIサーバーはデータをADFアプリケーションのビュー・オブジェクトに戻します。

BI JDBC接続は、すべてのADFアプリケーションで使用可能なように、または特定のADFアプリケーションのコンテキストで作成できます。

BI JDBCデータ・ソースの作成方法は、「BI JDBCデータ・ソースの作成」を参照してください。

BI JDBC接続を作成するには:

1. BI JDBC接続を、すべてのADFアプリケーションで使用するように作成するのか、または現在のADFアプリケーションで使用するように作成するのかを決定します。ADFアプリケーションでの接続を作成するには、次の手順を実行します。

1. ADFプロジェクトを開き、アプリケーション・ナビゲータに移動します。

2. 「アプリケーション・リソース」パネルに移動します。

3. 「接続」ノードを右クリックし、「接続の作成」を選択します。

4. 「データベース」を選択します。「データベース接続の作成」ダイアログが表示されます。

5. 「接続の作成場所」フィールドで「アプリケーション・リソース」が選択されていることを確認します。

2. すべてのADFアプリケーションで使用可能な接続を作成するには、次の手順を実行します。

1. リソース・パレットに移動して、「新規」アイコンをクリックします。

2. 「新しい接続」を選択します。

3. 「データベース」を選択します。「データベース接続の作成」ダイアログが表示されます。

4. 「接続の作成場所」フィールドで「IDE接続」が選択されていることを確認します。

3. 「接続タイプ」フィールドでBI (JDBC)を選択し、適切な接続情報を入力します。詳細は、[F1]キーを押すか、「データベース接続の作成」ダイアログから「ヘルプ」をクリックします。

4. 「接続のテスト」をクリックします。

- テストに成功すると、ステータス・テキスト・エリアに「成功」というメッセージが表示されます。

- テストに失敗した場合、エラーが表示されます。必要に応じてダイアログに入力した情報を変更してエラーを修正するか、エラーの内容を確認して考えられる他のエラー要因を特定します。

アプリケーション・ナビゲータまたはリソース・パレットの該当するノードの下に、新しい接続名が表示されます。

4.3.1.4 ADFプロジェクトの初期化

作成しているOracle Business Intelligenceビュー・オブジェクトが、ADFアプリケーションに追加される最初のビジネス・コンポーネントの場合、標準のJDBC接続でプロジェクトを初期化する必要があります。BI JDBC接続でプロジェクトを初期化することはできません。BI JDBC接続は、後でOracle Business Intelligenceビュー・オブジェクトを作成する際に指定します。

注意:
ビジネス・コンポーネント・プロジェクトを初期化する必要はありません。ビジネス・コンポーネント・プロジェクトは、作成時に初期化されます。

ADFプロジェクトを初期化するには:

1. ADFプロジェクトを開いて「ファイル」をクリックし、「新規」を選択します。「新規ギャラリ」ダイアログが表示されます。

2. 「すべてのテクノロジ」タブを選択し、「カテゴリ」エリアで「ビジネス層」を選択して、「ビジネス・インテリジェンス」を選択します。

3. 「アイテム」エリアで「ビュー・オブジェクト(ビジネス・インテリジェンス論理SQLビュー・オブジェクト)」が強調表示されていることを確認して、「OK」をクリックします。「ビジネス・コンポーネント・プロジェクトの初期化」ダイアログが表示されます。

4. 初期ビジネス・コンポーネント・プロジェクトを作成する場合、またはプロジェクト・プロパティを設定する場合に、コンポーネントで使用するデータベース接続およびSQLスタイルを指定します。詳細は、[F1]キーを押すか、「データベース接続の作成」ダイアログから「ヘルプ」をクリックします。

5. 「OK」をクリックします。「ビュー・オブジェクトの作成」ウィザードが表示されます。

4.3.1.5 ビジネス・インテリジェンス・ビュー・オブジェクトの作成

「ビュー・オブジェクトの作成」ウィザードを使用してOracle Business Intelligence論理SQLビュー・オブジェクトを作成および保存するには、次の手順を実行します。「ビュー・オブジェクトの作成」ウィザードの特定のダイアログの詳細は、[F1]キーを押すか、作業中のダイアログから「ヘルプ」をクリックします。

ビュー・オブジェクトを作成して保存した後、保存したビュー・オブジェクトにアクセスして次のアイテムを追加できます。

- 代替キー

- クライアント・インタフェースの仕様

- クライアント行インタフェースの仕様

- ビュー・アクセッサ

- ユーザー・インタフェースのヒント

ビュー・オブジェクトを作成するには:

1. ADFプロジェクトを開いて「ファイル」をクリックし、「新規」を選択します。「新規ギャラリ」ダイアログが表示されます。

注意:
まだADFプロジェクトを初期化していない場合、JDeveloperではOracle Business Intelligenceビュー・オブジェクトを作成する前に初期化が必要になります。詳細は、「ADFプロジェクトの初期化」を参照してください。

2. 「すべてのテクノロジ」タブを選択し、「カテゴリ」エリアで「ビジネス層」を選択して、「ビジネス・インテリジェンス」を選択します。「アイテム」エリアで「ビュー・オブジェクト(ビジネス・インテリジェンス論理SQLビュー・オブジェクト)」が強調表示されていることを確認してください。「OK」をクリックします。

3. 「名前」画面で、ビュー・オブジェクトの名前を入力してビュー・オブジェクトを配置するパッケージを指定します。「プロパティ・セット」フィールドを使用して、ビュー・オブジェクトの既存のプロパティ・セットを選択できます。「次へ」をクリックします。「接続」画面が表示されます。

注意:
ビュー・オブジェクトの保存後は、名前を変更できません。

4. 論理SQLを実行するBI JDBC接続を選択して、ビジネス・インテリジェンス・データを取得します。プロジェクトに対して初期化されたJDBC接続は、デフォルトでこの接続になりますが、プロジェクトのBI JDBC接続を作成するには、使用可能な接続のリストからBI JDBC接続を選択するか、「追加」ボタンをクリックする必要があります。

5. 「次へ」をクリックします。「論理SQL」画面が表示されます。

6. Oracle BI EEサーバーに対して実行する論理SQLを入力します。Oracle BI EEプレゼンテーション・サーバーでサポートされているほとんどの論理SQL select文を使用できます。選択リストのアイテムは、自動的にOracle Business Intelligenceビュー・オブジェクトの属性として使用可能になります。たとえば、論理SQLが"Select Markets.Region saw_0, Measures.Dollars saw_1 from Paint"の場合、対応するビュー・オブジェクトは「地域」と「ドル」という2つの属性を持ちます。

注意:
Oracle Business Intelligenceビュー・オブジェクトでは、Insert、UpdateおよびDelete論理SQL文はサポートされていません。詳細およびOracle Business Intelligenceビュー・オブジェクトで使用可能な論理SQL文のリストは、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』を参照してください。

7. 「次へ」をクリックします。「バインド変数」画面が表示されます。
BI論理SQLビュー・オブジェクトは、JDBC位置バインド変数のみをサポートしています。

8. 必要な変数を追加または作成します。作成したバインド変数は、このビュー・オブジェクトを含むデータ・コントロールでパラメータとして使用できます。バインド変数の詳細は、[F1]キーを押すか、ダイアログから「ヘルプ」をクリックします。

9. 「次へ」をクリックします。「Java」画面が表示されます。

10. 必要なJavaファイルを生成して、Oracle Business Intelligenceビュー・オブジェクトにより提供される機能を拡張またはカスタマイズし、「次へ」をクリックします。「アプリケーション・モデル」画面が表示されます。
ビュー・オブジェクトのカスタムJavaクラスの生成の詳細は、[F1]キーを押すか、ダイアログから「ヘルプ」をクリックします。

11. Oracle Business Intelligenceビュー・オブジェクトのインスタンスを、新規または保存されているアプリケーション・モジュールに追加します。アプリケーション・モジュールを追加しない場合、ビュー・オブジェクトのデータ・コントロールは自動的に生成されません。

12. 「次へ」をクリックします。「サマリー」画面が表示されます。

13. サマリーをレビューして、選択内容を確認します。選択内容が正しいことを確認して「終了」をクリックすると、JDeveloperでOracle Business Intelligenceビュー・オブジェクトが作成されます。

4.3.1.6 Oracle Business Intelligence論理SQLビュー・オブジェクトの動作の変更

ビュー・オブジェクトの動作を変更し、クライアント・インタフェースの仕様、クライアント行インタフェースの仕様、ビュー・アクセッサ、ユーザー・インタフェースのヒントなどの追加動作を定義するには、次の手順を実行します。指定する動作により、Oracle Business Intelligence論理SQLビュー・オブジェクトがアプリケーションの他のADFビュー・オブジェクトとどのように相互作用するかが決まります。

ビュー・オブジェクト・エディタ内の特定のダイアログの詳細は、[F1]キーを押すか、エディタから「ヘルプ」をクリックします。

ビュー・オブジェクトの動作を変更するには:

1. ビュー・オブジェクトを検索して開くには、「ファイル」→「開く」をクリックします。「開く」ダイアログが表示され、ここでビュー・オブジェクトを参照して選択できます。「概要エディタ」が表示されます。

2. 「接続」ノードをクリックして、ビュー・オブジェクトのBI JDBC接続情報を変更するか、他のBI JDBC接続に切り替えます。

3. 「論理SQL」ノードをクリックして、ビュー・オブジェクトの論理SQLを変更し、SQL問合せに名前付きバインド変数を追加します。

4. 「Java」ノードをクリックして、ビュー・オブジェクトのJavaファイルとそのビュー行セットを生成します。生成されたファイルにより、クライアントはオブジェクトのメソッドをリモートでコールし、ビュー行をラップするサービス・データ・オブジェクトを生成し、これによりビュー・オブジェクトをWebサービス・インタフェースで公開できます。

5. 「ビュー・アクセッサ」ノードをクリックして、ベース・エンティティ・オブジェクト属性またはビュー・オブジェクト属性からソース・ビュー行セットをポイントするビュー・アクセッサを定義します。

6. 他のビュー・オブジェクトの値リスト(LOV)対応属性に現在のビュー・オブジェクトのリストUIヒントを継承させる場合は、「リストUIヒント」ノードをクリックして、デフォルトのLOVのヒントを指定します。

4.4 BI JDBCデータ・ソースの作成

BI JDBCデータ・ソースへの接続を作成するには、BI JDBCデータ・ソースが存在している必要があります。このデータ・ソースおよび接続により、Oracle BIサーバーにアクセスして論理SQL文を渡し、ADFアプリケーションのビュー・オブジェクトのデータをリクエストできます。

BI JDBC接続の作成の詳細は、「Oracle Business Intelligence論理SQLビュー・オブジェクトの作成」を参照してください。

4.4.1 Oracle WebLogicでのBI JDBCデータ・ソースの作成方法

Oracle WebLogic Server管理コンソールにアクセスしてBI JDBCデータ・ソースを作成するには、次の手順に従います。開始する前に、Oracle WebLogicが起動していることを確認してください。

WebLogicでデータ・ソースを作成するには:

1. Oracle BI EEがデプロイされているWebLogicドメインの、WebLogic Server管理コンソールにアクセスしてログインします。

2. 左ペインの「ドメイン構造」ツリーで「サービス」を開き、「データ・ソース」を選択します。

3. 「新規」をクリックします。最初に「ロックして編集」をクリックして、「新規」ボタンを有効にする必要がある場合もあります。
「新しいJDBCデータ・ソースの作成」ウィザードが表示されます。

4. 「JDBCデータ・ソースのプロパティ」ページで、次の手順に従います。

1. 「名前」に、JDeveloperアプリケーションのOracle Business Intelligenceビュー・オブジェクトのデータベース名を入力します。たとえば、ApplicationOBISと入力します。

2. 「JNDI名」に、「名前」に指定した値と同じ値を入力します。JNDI名の形式は、jdbc/(「名前」フィールドの名前)DSであることに注意してください。たとえば、jdbc/ApplicationOBISDSと入力します。

3. 「データベース・タイプ」を「その他」に設定します。
「次へ」をクリックします。

4. 「データベース・ドライバ」を「その他」に設定します。

5. 「次へ」をクリックします。

5. 「トランザクション・オプション」ページで「グローバル・トランザクションのサポート」を選択し、「1フェーズ・コミット」を選択します。「次へ」をクリックします。

6. 「接続プロパティ」ページで、次の手順に従います。

1. 「データベース名」に、任意のテキスト文字列を入力します。このフィールドで指定した名前は、Oracle BI EEには使用されません。

2. 「ホスト名」に、Oracle BIサーバーの名前を入力します。たとえば、sr7619.us.mycompany.comと入力します。

3. 「ポート」に、9703と入力します。

4. 「データベース・ユーザー名」に、oracle.bi.server.impersonateUser権限が割り当てられた有効なOracle BI EEユーザー名を入力します。

5. 「パスワード」と「パスワードの確認」に、指定したユーザー名のパスワードを入力および再入力します。「 次へ」をクリックします。

7. 「データベース接続のテスト」ページで、次の手順に従います。

1. 「ドライバ・クラス名」に、oracle.bi.jdbc.AnaJdbcDriverと入力します。

2. 「URL」に、jdbc:oraclebi://ホスト名:9703/と入力します。たとえば、jdbc:oraclebi://sr7619.us.mycompany.com:9703/と入力します。

3. 「プロパティ」に、user=(前述の「データベース・ユーザー名」フィールドのユーザー)と入力します。たとえば、user=BIImpersonatorUserと入力します。

4. 「テスト対象の表名」に、SQL {call NQSGetSQLCatalogs()}と入力します。

8. 「構成のテスト」をクリックします。テストに失敗した場合は、戻って設定を確認します。テストに成功した場合は、「次へ」をクリックします。

9. データ・ソースをデプロイするサーバーまたはクラスタを選択します。この手順は、データ・ソースの構成を完了する前に行う必要があります。

10. 「終了」をクリックします。

11. 「変更のアクティブ化」をクリックします。

4.4.2 BI JDBCデータ・ソースに対する偽装の構成

BI JDBCデータ・ソースに接続文字列プロパティを追加するには、次の手順に従います。この手順を実行すると、偽装を有効化できます。接続で現在ログインしているユーザーを使用しない場合は、この手順をスキップできます。

BI JDBCデータ・ソースを偽装用に構成するには:

1. WebLogic Server管理コンソールにアクセスして、偽装を構成するBI JDBCデータ・ソースを検索します。「設定」ページが表示されます。

2. 「接続プール」タブをクリックします。データ・ソースを構成する前に、「ロックして編集」をクリックする必要がある場合もあります。

3. 「プロパティ」フィールドで行を作成し、IMPERSONATE=を追加します。

4. 「接続数の初期値」フィールドに、1と入力します。

5. 「保存」をクリックします。

4.5 Oracle Business Intelligence論理SQLビュー・オブジェクトの拡張

Oracle Business Intelligence論理SQLビュー・オブジェクトをスタンドアロンのWebLogic Serverから実行する場合は、ビュー・オブジェクトをスタンドアロンのWebLogic Serverにデプロイする必要があります。

Oracle Business Intelligence論理SQLビュー・オブジェクトを拡張するには、BI JDBCをサポートするWebLogicドメインの設定、ビュー・オブジェクトの準備およびアプリケーションのデプロイを行う必要があります。

4.5.1 BI JDBCをサポートするWebLogicドメインの設定方法

次の手順を使用して、BI JDBCをサポートするWebLogicドメインを設定します。

Fusion Middleware構成ウィザードを使用したWebLogicドメインの作成または拡張の詳細は、Oracle Fusion Middleware構成ウィザードによるドメインの作成を参照してください。

WebLogicドメインを作成するには、次のようにします。

1. 「スタート」をクリックし、「プログラム」、「Oracle Fusion Middleware」、WebLogic Server 11gR1、「ツール」、「構成ウィザード」を順に選択して構成ウィザードにアクセスします。「Fusion Middleware構成ウィザード」が表示されます。

2. ウィザードを使用して、BI JDBCをサポートするWebLogicドメインを作成します。表4-1に、「Fusion Middleware構成ウィザード」ページおよびそれに対応して選択する必要がある選択内容またはBI JDBC用にWebLogicドメインを正しく設定するために指定する必要がある値の一覧を示します。

表4-1 WebLogicドメインの設定

ウィザードのページ

選択する必要がある値

ドメイン・ソースの選択

次を選択します。

Oracle BI JDBC - <バージョン番号> (oracle_common)

すべてのOracle JRFオプションを選択します。例:

- Oracle JRF WebServices Asynchronous services - 11.1.1.0 [oracle_common]

- Oracle JRF - 11.1.1.0 [oracle_common]

オプションの構成を選択

「デプロイメントとサービス」を選択してから、「次へ」を使用して必要なアプリケーションの選択を確定します。

デプロイメントのクラスタまたはサーバーへのターゲット設定

次のアプリケーションが選択されていることを確認します。

- oracle.bi.adf.model.slib

- bijdbc

ドメインの作成中

「管理サーバーの起動」を選択します。

または、WebLogic serverの設定完了後、user_projects/domains/ドメイン名/binの下のStartWebLogic.sh/cmdを実行することにより、サーバーを起動できます。

4.5.2 Oracle Business Intelligence論理SQLビュー・オブジェクトの準備方法およびアプリケーションのデプロイ方法

この手順を使用して、ターゲット・アプリケーション・サーバーへの接続の作成、デプロイメント・プロファイルの作成、およびスタンドアロンのWebLogic serverへのアプリケーションのデプロイを行います。次の作業で使用されている個々のページの詳細は、そのページの「ヘルプ」ボタンをクリックしてください。

4.5.2.1 ターゲット・アプリケーション・サーバーへの接続の作成

次の作業を行い、ターゲット・アプリケーション・サーバーへの接続を作成します。

ターゲット・アプリケーション・サーバーへの接続を作成するには:

1. JDeveloperで「表示」メニューをクリックし、「アプリケーション・サーバー・ナビゲータ」を選択して「アプリケーション・サーバー」タブを表示します。「アプリケーション・サーバー」タブが表示されます。

2. 「アプリケーション・サーバー」タブで、「アプリケーション・サーバー」を右クリックし、「新規アプリケーション・サーバー」を選択します。アプリケーション・サーバー接続の作成ウィザード - 「使用方法」ページが表示されます。

3. 「使用方法」ページで「スタンドアロン・サーバー」を選択して、「次へ」をクリックします。

4. ウィザードのページを完了してアプリケーション・サーバーの設定、テストおよび保存を行います。個々のページの詳細は、そのページの「ヘルプ」ボタンをクリックしてください。
「アプリケーション・サーバー」タブに、アプリケーション・サーバーが表示されます。

4.5.2.2 EARファイルのデプロイメント・プロファイルの作成

次の作業を行い、EARファイルのデプロイメント・プロファイルを作成します。

EARファイルのデプロイメント・プロファイルを作成するには:

1. 「アプリケーション」メニューをクリックして「アプリケーションのプロパティ」を選択し、「デプロイメント・プロファイルの作成」ページにアクセスします。「アプリケーション: プロパティ」ページが表示されます。

2. 「アプリケーションのプロパティ」ページの左ペインから、「デプロイメント」を選択します。デプロイメントのプロファイルおよびオプションが表示されます。

3. 「新規」をクリックします。「デプロイメント・プロファイルの作成」ページが表示されます。

4. デプロイメント・プロファイル名をそのまま使用して、「OK」をクリックします。「一般」ページが表示されます。

5. 「一般」ページの値をそのまま使用して、「OK」をクリックします。先ほど作成したデプロイメント・プロファイルを含む、デプロイメントのプロファイルおよびオプションが表示されます。

6. 「デプロイメント」ページで、デプロイメント・プロファイルを次のように定義します。

- 「デプロイ中にweblogic-jdbc.xmlディスクリプタを自動生成および同期化」オプションを選択します。

- 「アプリケーション・ポリシー」および「資格証明」の各オプションの選択を解除します。

- 「ユーザーとグループ」オプションを選択します。

7. 「デプロイメント・プロファイル」リストから、作成したデプロイメント・プロファイルを選択し、「編集」をクリックします。「EARデプロイメント・プロファイルのプロパティの編集」ページが表示されます。

8. 左ペインで「アプリケーション・アセンブリ」を選択します。「アプリケーション・アセンブリ」ページが表示されます。

9. 「Java EEモジュール」領域でModel.jprモジュールを探し、このモジュール内にリストされている項目が正しいことを確認します。「OK」をクリックします。「アプリケーション: プロパティ」ページが表示されます。

10. 「OK」をクリックして、「アプリケーションのプロパティ」ページを閉じます。

4.5.2.3 アプリケーションのデプロイ

次の作業を行い、アプリケーションをデプロイします。

アプリケーションをデプロイする手順は、次のとおりです。

- 「アプリケーション」メニューをクリックし、「デプロイ」を強調表示してから、アプリケーションを選択してデプロイメントのプロセスを開始します。

5 Oracle Business Intelligenceプレゼンテーション・サービスとOracle WebCenterポータル・アプリケーションの統合

この章では、Oracle BIプレゼンテーション・カタログとWebCenterポータル・アプリケーションの統合方法、およびWebCenterポータル・アプリケーションまたはWebCenter Portal: SpacesへのOracle BIコンポーザ機能の追加方法について説明します。

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

- Oracle BIプレゼンテーション・サービスとWebCenterポータル・アプリケーションの統合の概要

- Oracle BIプレゼンテーション・サービスと統合するWebCenterポータル・アプリケーションの作成

- BIコンポーザをWebCenterポータル・アプリケーションまたはWebCenter Portal: Spacesに追加できるか

- WebCenterポータル・アプリケーションまたはWebCenter Portal: SpacesへのBIコンポーザの追加

5.1 Oracle BIプレゼンテーション・サービスとWebCenterポータル・アプリケーションの統合の概要

JDeveloperを使用して、Oracle Business Intelligenceプレゼンテーション・サービスと統合するWebCenterポータル・アプリケーションを作成できます。実行時に、これらのアプリケーションでは、WebCenterポータル・リソース・カタログにOracle BIプレゼンテーション・カタログが含められます。これにより、ユーザーはビジネス・インテリジェンス分析、ダッシュボード・ページ、ダッシュボードまたはスコアカード・コンポーネント(戦略マップ、戦略ツリー、KPI監視リスト、原因と結果マップおよびカスタム・ビュー)を参照し、WebCenterポータル・アプリケーションのページに追加できます。ビジネス・インテリジェンス・オブジェクトに含まれるフィルタ、プロンプトおよびアクション・リンクは、WebCenterポータル・ページ内で動作します。

実行時に、WebCenterポータル・ユーザーはOracle BIプレゼンテーション・カタログのフォルダを開いて参照し、分析のビューを表示できます。Oracle BIプレゼンテーション・カタログには、次のビュー・タイプが表示されます: 表、ピボット表、チャート、ファンネル・チャート、ゲージ、ナレーティブ、ティッカおよびタイトル。次のビュー・タイプはOracle BIプレゼンテーション・カタログに表示されません: ビュー・セレクタ、列セレクタ、論理SQLおよび結果なしビュー。

ダッシュボードに関連付けられているページをダッシュボード・フォルダから参照することもできますが、ダッシュボード・ページ内を参照してそれらのコンポーネントを確認することはできません(ダッシュボードに埋め込まれた任意の分析など)。スコアカード全体(スコアカードのコンポーネントのみ)をWebCenterポータル・アプリケーションのページに含めることはできません。

詳細は、「Oracle BIプレゼンテーション・サービスと統合するWebCenterポータル・アプリケーションの作成」を参照してください。

5.2 Oracle BIプレゼンテーション・サービスと統合するWebCenterポータル・アプリケーションの作成

Oracle BIプレゼンテーション・サービスと統合するWebCenterポータル・アプリケーションを適切に作成するには、アプリケーションのライブラリ設定を構成し、web.xmlファイルおよびdefault-catalog.xmlファイルを更新し、セキュリティを適切に構成する必要があります。

Oracle Business Intelligenceプレゼンテーション・サービスと統合するWebCenterポータル・アプリケーションの構成方法については、Oracle Fusion Middleware Oracle WebCenterポータル開発者ガイドのOracle Business Intelligenceプレゼンテーション・サービスの統合に関する項を参照してください。

5.3 BIコンポーザをWebCenterポータル・アプリケーションまたはWebCenter Portal: Spacesに追加できるか

BIコンポーザは、WebCenterポータル・アプリケーションまたはWebCenter Portal: Spacesで迅速かつ容易にOracle BI EE分析の設計を編集または表示するための、使いやすいウィザードです。

構成されている場合、BIコンポーザ・インタフェースにより、WebCenterポータル・ユーザーは分析列の選択または変更による分析の編集、ビューの追加(表やグラフなど)、データのソートおよびフィルタ、表に表示されるデータへの条件付き書式設定の適用を行うことができます。

この統合の設定の詳細は、「WebCenterポータル・アプリケーションまたはWebCenter Portal: SpacesへのBIコンポーザの追加」を参照してください。

BIコンポーザ・インタフェースの使用については、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』の第14章「分析でのBIコンポーザの使用」を参照してください。

5.4 WebCenterポータル・アプリケーションまたはWebCenter Portal: SpacesへのBIコンポーザの追加

WebCenterポータル・アプリケーションまたはWebCenter Portal: SpacesにBIコンポーザを追加するには、BIコンポーザ実装ライブラリを含めるようにWebCenterポータル・ドメインを拡張し、ライブラリ・リファレンスをWebCenterポータル・アプリケーションに追加し、WebCenterポータルBIコンポーザのビューアよおびエディタ・コンテナ・タスク・フロー・パラメータを指定する必要があります。WebCenter Portal: Spacesの場合はさらに、タスク・フロー権限セキュリティを追加し、ドメイン拡張テンプレートを適用してBIコンポーザ・ライブラリをデプロイする必要があります。

5.4.1 インストールされているJDeveloper拡張機能の確認

Oracle JDeveloperでは、次のOracle BI EE拡張機能を提供します。

- ビジネス・インテリジェンスADFタスク・フロー

- ビジネス・インテリジェンスADFビュー・リージョン

- ビジネス・インテリジェンス・コンポーザ

- ビジネス・インテリジェンス論理SQLビュー・オブジェクト

- ビジネス・インテリジェンスSOAP接続

必要なOracle JDeveloper 11g拡張機能およびOracle BI EE拡張機能があるかどうか不明な場合は、この手順を実行します。

1. JDeveloperで「ヘルプ」メニューをクリックし、「バージョン情報」をクリックします。表示される「Oracle JDeveloper 11gのバージョン情報」ダイアログ・ボックスで、リリース番号を確認できます。

2. 「拡張機能」タブをクリックして、インストールされている拡張機能のリストを表示します。リストをソートするには、「名前」または「識別子」列ヘッダーをクリックします。
Oracle BI EE拡張機能にはすべて、「bi-」接頭辞が付いています。「bi-」接頭辞で始まる拡張子がない場合、必要な拡張機能はありません。

5.4.2 必要なJDeveloper拡張機能のインストール

必要な拡張機能をインストールするには、次の手順を実行します。

1. JDeveloperの「ヘルプ」メニューから、「更新の確認」を選択します。

2. ウィザードの手順に従って、Oracle BI EE拡張機能を検索、ダウンロードおよびインストールします。Oracle BI EEと統合するWebCenterポータル・アプリケーションを作成する場合は、WebCenterポータル・フレームワークもインストールする必要があります。
使用可能なOracle BI EE拡張機能のリストは、「インストールされているJDeveloper拡張機能の確認」を参照してください。

5.4.3 WebCenterポータル・ドメインの拡張方法

BIコンポーザ実装ライブラリを含めるようにWebCenterポータル・ドメインを拡張するには、この手順を実行します。この手順は、WebCenterポータル・アプリケーションおよびWebCenter Portal: Spacesに対して実行します。

この手順の実行方法については、「ドメインの拡張方法」を参照してください。

5.4.4 BIコンポーザ・ライブラリ・リファレンスの追加方法

必要なライブラリ・リファレンスをWebCenterポータル・アプリケーションに追加するには、次の手順を実行します。WebCenter Portal: Spacesの場合、この手順を行う必要はありません。

1. JDeveloperで、アプリケーション・ナビゲータに移動して「プロジェクト」タブを開き、プロジェクトのWEB-INFサブディレクトリに移動してweblogic.xmlドキュメントを開きます。

2. 次のライブラリ・リファレンスを追加します。

<library-ref>
<library-name>oracle.bi.composer</library-name>
</library-ref>

3. アプリケーションのweblogic-application.xmlドキュメントを開きます。この手順を実行するには、アプリケーション・ナビゲータに移動して「アプリケーション・リソース」タブを開き、weblogic-application.xmlドキュメントが格納されているディスクリプタのサブディレクトリに移動します。

4. 次のライブラリ・リファレンスを追加します。

<library-ref>
<library-name>oracle.bi.jbips</library-name>
</library-ref>

5.4.5 タスク・フロー権限セキュリティを追加する方法

WebCenter Portal: SpacesでBIコンポーザを構成する場合、次の手順に従って、BIコンポーザ・タスク・フローの権限セキュリティ・エントリを作成します。WebCenterポータル・アプリケーションの場合、この手順を行う必要はありません。

1. Fusion Middleware Controlで、「WebCenter」ノードを開きます。

2. WebCenter Spacesを選択し、右クリックして「セキュリティ」を選択し、「アプリケーション・ポリシー」を選択します。「アプリケーション・ポリシー」ダイアログが表示されます。

3. 「検索」ペインで、「検索するアプリケーション・ストライプの選択」ボックスをクリックします。

4. リストをクリックして「Web Center」を選択し、「アプリケーション・セキュリティ権限の検索」ボタンをクリックします。検索結果が表示されます。

5. 検索結果から、権限を追加するプリンシパルを選択します。「編集」をクリックします。「アプリケーション権限の編集」ダイアログが表示されます。

6. 「権限」ペインで、「追加」を選択します。「権限の追加」ダイアログが表示されます。

7. 「カスタマイズ」ペインで、権限情報を指定します。次の事項に留意してください。

- 「権限クラス」フィールドに、oracle.adf.controller.security.TaskFlowPermissionと入力します。

- 「リソース名」フィールドに、/WEB-INF/oracle/bi/adf/apps/answers/webcenter/flow/BIWebCenterTF.xml#BIWebCenterTFと入力します。

- 「権限アクション」フィールドに、customize,personalize,viewと入力します。

8. 「OK」をクリックします。

5.4.6 BIコンポーザWebCenterポータルのビューアおよびエディタ・コンテナ・タスク・フロー・パラメータの指定方法

次の情報を使用し、ページの他の要素に基づいたパラメータ値で、タスク・フローを初期化します。

コンテナ・タスク・フローはエディタ・タスク・フローおよびビューア・タスク・フローを集約し、ユーザーが実行時にエディタ・モードとビューア・モードを切り替えられるようにします。WebCenterポータル・アプリケーションまたはWebCenter Portal: SpacesでBIコンポーザ・ライブラリが使用できない場合、BIコンポーザのビューアのみが公開され、編集機能は無効になります。しかし、BIコンポーザ・ライブラリが使用できる場合は、コンテナ・タスク・フローを使用してBIコンポーザのビューア機能とエディタ機能が公開されます。

タスク・フロー・ドキュメントの場所は次のとおりです。

WEB-INF/oracle/bi/adf/apps/answers/webcenter/flow/BIWebCenterTF.xml

タスク・フローのIDは次のとおりです。

BIWebCenterTF

タスク・フローへのパラメータの追加の詳細は、Oracle Fusion Middleware Oracle Application Development FrameworkのためのFusion開発者ガイドの第16章「タスク・フローでのパラメータの使用」を参照してください。

表5-1は、各タスク・フロー・パラメータ、その説明、型、デフォルト値および必須かどうかを示しています。

表5-1 BIコンポーザWebCenterポータルのビューアおよびエディタ・タスク・フロー・パラメータ

名前

説明

型

必須か

デフォルト値

biCatalogPath

表示または編集する分析のカタログ・パス。

String

いいえ

NULL

connectionId

デプロイされているOracle BI EEプレゼンテーション・サービス接続のID。

String

いいえ

NULL

obipsType

表示または編集するコンテンツのタイプ。分析の場合は「biReportContent」、ダッシュボードの場合は「biDashboardContent」、スコアカードの場合は「biScorecardContent」を使用します。

String

いいえ

NULL

subItem

Oracle BIコンテンツのサブアイテム名(分析ビューまたはダッシュボード・ページなど)。このパラメータは、ビューアにのみ適用されます。

String

いいえ

NULL

promptfilterxml

プロンプトまたはフィルタのXML。このパラメータは、ビューアにのみ適用されます。

String

いいえ

NULL

width

Oracle BIオブジェクトの幅。このパラメータは、ビューアにのみ適用されます。

String

いいえ

NULL

height

Oracle BIオブジェクトのコンテンツの高さ。このパラメータは、ビューアにのみ適用されます。

String

いいえ

NULL

viewReportLinks

このカンマ区切りの値は、レポートに表示されるレポート・リンクを示します。

String

いいえ

NULL

有効な値は次のとおりです。

- r
リフレッシュ。「リフレッシュ」リンクを表示します。

- f
印刷。「印刷」リンクを表示します。

- d
ダウンロード。「エクスポート」リンクを表示します。

- -
なし。リンクを表示しません。

たとえば、f,r,dを使用して、サポートされているすべてのリンクを表示します。

Nullは、表示しない場合のデフォルトとして扱われます。

オラクルの法律上の注意点について

コピーライトについて

Copyright © 1994-2016, Oracle and/or its affiliates.All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクルまでご連絡ください。

制限付権利について

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

アルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のアルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが非公開の試作版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のベータ・トライアル契約のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle PartnerNetwork Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

ドキュメントのアクセシビリティについて

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。