Oracle BI Publisher 11g スタート･ガイド

Oracle BI Publisher 11gにアクセスできること。または、Oracle BI Publisher 11gをスタンドアロンとして、またはOracle BI Enterprise Edition 11gの一部としてインストールしていること。

また、次のバージョンのブラウザの使用を推奨します。 Internet Explorer 7.0以上、Mozilla Firefox 3.6.3以上。

サンプル・スキーマHRおよびOEがインストール済みでロック解除されているOracle Database11g（または10g）にアクセスできること。

このチュートリアルの演習では、Oracle Databaseに含まれるHRスキーマおよびOEスキーマを使用します。

Oracle Database 11gのRepository Creation Utility（RCU）スクリプトを実行済みであること。 これは、Oracle BI EEをインストールする前に実行する必要があります。 RCUは、Oracle BI Publisherのスケジューラ・リポジトリを作成します。

注：Oracle BI Enterprise Editionインストーラには、このRCUスクリプトが標準で付属しており、これによってOracle BI Publisherを含むOracle BI EEのさまざまなコンポーネント向けのOracle Databaseにリポジトリや必要なスキーマが作成されます。 これらのRCUスクリプトを実行するには、Oracle 11g Databaseが必要です。

ただし、10gおよび11gのOracle Databaseを使用することで、Oracle BI Publisherを介して、JDBC接続を確立し、データ・モデルおよびレポートを作成できます。

ブラウザ・ウィンドウにOracle BI PublisherのURLを入力します。URL形式は次のとおりです。
http://<hostname>: <port >/xmlpserver/ （例：http:/localhost:9704/xmlpserver/）

これにより、Oracle BI Publisher Enterpriseのログイン・ページが開きます。

Oracle BIのAdministrator権限を持つユーザーとしてログインします。

Oracle BI Publisherにログインすると、Homeページが表示されます。

Homeページは、グローバル・ヘッダーと組み合わされたタスク指向の一元化されたワークスペースです。ここから、Oracle BI Publisherオブジェクト、それらの各エディタ、およびヘルプ・ドキュメントへアクセスできます。

Homeページの多様なセクションを確認してください（11gリリースでは、ユーザーが迅速にOracle BI Publisherを開始できるように大幅に拡張されています）。

たとえば、以下のような内容があります。

• 左側のCreateセクションには、レポート、データ・モデル、他のオブジェクトなどの作成に役立つオプションがあります。
• 左側のBrowse/Manageセクションでは、カタログ、ジョブおよびジョブ履歴を参照し、管理できます。
• 左側のGet Startedセクションには、Oracle BI Publisherの開始に役立つ、さまざまなOracle BI Publisherツール、オンライン・ヘルプおよびOracle Technology Networkへのリンクがあります。
• 右側のRecentセクションは、ユーザーが最近アクセスしたレポートを開き、参照できるように、各ユーザー向けにパーソナライズされています（最初のログイン時は、Recentセクションにはいずれのオブジェクトも表示されません）。

また、オブジェクトをタイプ別に検索できる拡張された検索機能も試してください。

右上には、Homeページ、Catalog、Newドロップダウン・リスト、およびOpenドロップダウン・リストのリンクが表示されます。

注：これらのすべての機能により、レポート開発者およびユーザーにとってOracle BI Publisher内のナビゲーションが容易になります。

以下の手順に従ってカタログを参照し、サンプル・レポート（事前定義済み）を開きます。

Browse/ Manageセクションの「Catalog」リンクをクリックします（または、Homeページの右側の「Catalog」リンクをクリックします）。

Catalogページが表示され、ページの左側にツリー構造、右側に詳細が表示されます。

レポート、データ・モデルなどのオブジェクトがフォルダにまとめられている点に注目してください。

注：Shared Folders内のSamplesフォルダには、事前定義された一連のサンプル・レポートが含まれます。 これらのレポートのうちの1つを開きます。

Newドロップダウン・メニューがあるツールバーでは、新規のレポート、スケジューリングされたジョブ、データ・モデルなどを作成できます。

このツールバーには他に、コピー、切取り、貼付けなどのオプションや、データ・モデルやレポートなどのカタログ・オブジェクトの作成や管理の際に使用できるオプションもあることに注意してください。

Samples内のHuman Resourcesフォルダに移動します。（ここでは、Human Resourcesフォルダ内のすべてのオブジェクトが表示されます。）

あるキーワードを使用して、レポート（または他のオブジェクト）を検索し、表示することもできます。 たとえば、CatalogページでSearchドロップダウン・リストから「Reports」チェック・ボックスを選択し、隣のTextフィールドにキーワードを入力します。 以下の例では、検索結果は"Sales"の名前を持つレポートのリストです。

Salary Reportの下の「Open」リンクをクリックします。

Salary Reportが表示モードで開きます。 レポート・データは、Defaultレイアウトを使用して表示されます。 事前定義されたレポートのレイアウトはすべて、別のタブで表示されます。

サポートされている形式のいずれかを使用してレポートを表示することもできます。 レポート・ビューアの上の右側に表示されるViewアイコンをクリックします（以下のスクリーンショットでは赤線で囲まれています）。

また、レポートで定義されているパラメータに注意してください。DepartmentおよびEmployeeには、部門名と、対応する部門で働いている従業員のためのドロップダウン・リストが表示されます。

たとえば、DepartmentでFinanceを選択すると、EmployeeリストにはFinance部門で働いている従業員が表示されます。

「Financial Style」タブおよび「Pivot Table」タブをクリックすることにより、これらの事前定義済みレイアウトを使用したレポートでデータを表示できます。

以下の画面では、Financial Styleレイアウトを使用してFinance部門のデータを表示しています。

以下の画面では、Pivot Tableレイアウトを使用してSales部門のデータを表示しています。

プリファレンスを設定するには、「Signed in as <user>」リンクをクリックし、ドロップダウン・リストから「My Account」を選択します。

すると、以下の画面のようにGeneralおよびMy Groupタブ/リンクとともにPreferences画面が表示されます。

General Preferencesセクションでは、Report Locale、UI Language、Time Zone、およびAccessibility Modeを設定できます。

• Report Locale- ロケールは、言語と地域の組み合わせです（たとえば、英語（アメリカ合衆国）やフランス語（カナダ）など）。 Oracle BI Publisherでは、 レポート・ロケールの選択を使用して、適用するテンプレート変換、レポート・データに適用する数値の書式設定および日付の書式設定を決定します。
• UI Language- UI言語は、ユーザー・インタフェースが表示される言語です。ログイン時に選択した言語が、デフォルトとして選択されます。 ただし、このオプションによって、使用しているインストールで利用可能な言語から選択できます。
• Time Zone- レポートに適用するタイムゾーンを選択します。 ユーザーによって実行されたレポートは、ここで選択したタイムゾーン・プリファレンスに従って時間を表示します。
• Accessibility Mode- これを"On"に設定するとレポート・カタログがツリー構造で表示され、これにはキーボードからアクセスできます。

注： 実行中のOracle BI PublisherがOracle BI Publisher以外のセキュリティ・モデルと統合されている場合、これらのプリファレンスは他のセキュリティ・モデルから継承されることになり、これらの値の変更はできません。

「My Groups」タブをクリックし、ユーザーが割り当てられているアプリケーション・ロールのリストを表示させます。 このリストは変更できません。

パスワードを変更するには、My Accountダイアログの「Password」タブをクリックします。

注： Passwordタブは、Oracle BI Publisher Securityを使用している場合にのみ表示されます。

JDBC接続を定義するには、Oracle BI Publisherページの右側にある 「Administration」リンクをクリックします。

すると、以下のようにOracle BI Publisher Administrationページが表示されます（以下の画面のData Sourcesセクションを参照します）。

AdministrationページのData Sourcesセクションの 「JDBC Connection」リンクを クリックします。

すると、Data Sourcesページが表示されます。 JDBCセクションで、「Add Data Source」をクリックし、 データベースにJDBC接続を作成します。

表示されたAdd Data Sourceページで、以下のように 詳細を入力します。

• Data Source Name - OE
• Driver Type - データベースに適合する ドライバ・タイプを選択します（たとえば、手元のデータベースに合わせてOracle 10gまたはOracle 11gを選択できます）。
• Database Driver Class - oracle.jdbc.driver.OracleDriver （データベースに適合するドライバ・クラスを定義します）
• Connection String - データベース接続の詳細を 入力します （例：hostname:port:sid）。
• User name - OE（データベースのユーザー名）
• Password - OE（データベースのユーザーのパスワード）

上記の詳細を定義した後に、ApplyまたはCancelを クリックしないでください。 「Test Connection」をクリックします。

注：このチュートリアルの演習を 継続するには、前提条件で説明したように、サンプル・スキーマOEおよびHRが Oracle Databaseにインストールされている必要があります。 そうしないと、 このJDBC接続を定義できません。

データベースへの接続が確立された場合は、 成功を示す確認メッセージが表示されます。

（以下の画面を参照）。

次に、「Apply」をクリックします。

JDBC Data Sourcesのリストに この新しく定義された接続（OE）が表示されます。

Oracle BI Publisherには、さまざまなサンプル・ファイルおよびレポートのリポジトリが 同梱されています。 これらは、Oracle BI Publisherホームで入手できます。

Fileデータソースを定義するには、Oracle BI Publisher Administrationページの 「File」タブをクリックします。

「demo files」リンクをクリックして、 ファイル・ロケーションを更新します。

（Fileデータソースを別の名前で作成したい場合は、 「Add Data Source」をクリックします。）

すべてのサンプル・ファイル（リポジトリ）を含む最上位レベルのディレクトリを 定義します。

（このデモ・ファイルのデータソースを使用して、ユーザーは 最上位ディレクトリまたはそのサブディレクトリのすべてのファイルにアクセスできます）。

注： データ・モデルの作成を開始する前に、 レポート、データ・モデルなどのオブジェクトすべてを保存するフォルダを 作成します。

Homeページで、Browse/Manageセクションの下の 「Catalog」リンクをクリックします。
表示されたCatalogページで、「My Folders」ノードを選択し、ツールバーのNewアイコンを クリックします。

ドロップダウン・メニューから「Folder」を選択し、 新しいフォルダを作成します。

フォルダ名にLearnと入力して、 説明（オプション）を入力し、「Create」をクリックします。

My Foldersにフォルダが表示されるように なります。

これで、Data Model Editorを起動できます。 これには、次のいずれかの方法を使用します。

• HomeページのCreateセクションから、 「Data Model」を選択します。
• CatalogページでNewアイコンをクリックし、 ドロップダウン・メニューから「Data Model」を選択します。

右側に表示されるData Model Propertiesページに 注目します。
「Default Data Source」を選択します（手元のデータベースではOEスキーマを指します）。 データ・モデルに説明を追加します（オプション）。

注：

• XML Output Optionで、 Include Parameter Tagsがチェックされ、Include Empty Tags for Null ElementsおよびInclude Group List Tagチェック・ボックスが チェックされていないことを確認してください。
  
  
  
• Default Data Sourceを定義するためには、 デフォルトのデモ・データソースが手元のデータベースでOEスキーマを指し、それを使用するように 編集することもできます。
• また、Propertiesページで、 デフォルト・データソースの指定に加えて、多数のオプションを設定できることに注意してください。 たとえば、DBデフォルト・パッケージ、DBフェッチ・サイズ （データ・エンジンのデフォルトは300）、結果のXML出力に必要なXMLタグに基づいた XML出力オプションを指定できます。

データ・モデルに名前を付けて保存するには、ページの右上にある Save Asアイコンをクリックします。

データ・モデル・オブジェクト（この例で学習）を保存するフォルダへ移動して、 データ・モデルに適切な名前を入力し、 「Save」をクリックします。

Create Data set -SQLダイアログ・ ボックスで、データセットに適切な名前を入力し、 デフォルトのデータセット・オプション（すでにData Modelで定義したとおり）を受け入れ、 「Query Builder」をクリックして問合せを作成します。

Query Builderウィンドウが表示され、 左側にOEスキーマ・オブジェクトが表示されます。

DEPARTMENTS表およびEMPLOYEES表をクリックし、 それらを右側のModelキャンバスに追加します。

次に、以下の手順に従って、これら2つの表の間に結合を定義します。
DEPARTMENTS表のDEPARTMENT_ID列の横にあるボックスをクリックします。
同様に、EMPLOYEES表のDEPARTMENT_ID列の横にあるボックスをクリックします。
（これらのボックスは、結合用に選択されると、ライトグレーに変わります。）
また、表を結合する細い線がModelキャンバスに表示されます。

表から次の列を選択します（これには、 列名の横のチェック・ボックスを選択します）。
-DEPARTMENTS表から「DEPARTMENT_NAME」を選択
-EMPLOYEES 表から「FIRST_NAME、LAST_NAME、HIRE_DATE」列および「SALARY」列を選択
（以下の画面を参照してください）

「Conditions」タブをクリックします。 より適切な別名になるように、列名を変更して、"_"を削除します。 以下のように列の別名を変更します。

• DEPARTMENT_NAMEからDepartmentNameへ
• FIRST_NAMEからFirstNameへ
• LAST_NAMEからLastNameへ
• HIRE_DATEからHireDateへ
• SALARYからSalaryへ

また、以下の画面のように、DEPARTMENT_NAME列のConditionフィールドに"IN (:P_DNAME)"と入力します。 これにより、DEPARTMENT_NAME列にパラメータP_DNAMEが定義されます。

注：ここでIN条件は、DEPARTMENT_NAME列にAll値またはMultiple値を受け入れるパラメータのために使用されています。

別名および表示名は、Data ModelページのDiagramまたはStructureでも変更できます。

Query Builderに現れる問合せ結果を表示するには、「Results」を クリックします。ここで、パラメータの部門名の入力を求められるため、「Sales」と入力して「OK」をクリックします。

結果が表示されます。 「Save」をクリックして、問合せを保存します。

ここで、Create Data set -SQLダイアログ・ボックスに戻り、 作成した問合せがSQL Query領域に反映されていることを 確認します。
Emp_DataSetなどの適切な名前を入力して、「OK」をクリックし、このデータセットをデータ・モデルに追加します。

バインド変数を作成するかどうかを 尋ねられます。 「OK」をクリックして、パラメータを作成します。

作成されたパラメータがData ModelのParametersノードの下に表示されていることに注意してください。

データ・モデルに変更を加えるたびに（データセットへの変更、パラメータの追加、その他の変更など）、右上のSaveアイコンをクリックしてEmp_DMデータ・モデルを保存します。

Data Modelペインで、「List of Values」ノードをクリックします。 List of Valuesペインで、 「+」サインをクリックして新しいList of Valuesを作成します。

次のオプションを選択します。

• LOVのNameにDepNameと入力
• Typeに、ドロップダウン・リストから「SQL Query」を選択
• Data Sourceで「OE」が選択されていることを確認
• 「Query Builder」をクリックして、LOVに部門名を返す問合せを定義

データ・モデルを保存します。

Query Builderページで、DEPARTMENTS表から「DEPARTMENT_NAME」を選択します。 「Save」をクリックします。

「Save」をクリックして、データ・モデルを保存します。 LOVの問合せは次のように表示されます。

次に、このLOVを使用するP_DNAMEパラメータにプロパティを設定します。

Parametersノードの下に表示される「P_DNAME」パラメータを選択します。

Default Valueに*（星印）を入力し、Parameter Typeで「Menu」を選択します（デフォルトのパラメータ・タイプはText）。

パラメータのList of ValuesにDepNameが選択されていることを確認します。
Multiple Selection、Can select all、およびAll Values Passedオプションが選択されていることを確認します。
（これらのオプションでは、部門にすべてまたは複数の値を選択できます。）

また、Display LabelをDepartmentなどの適切なものに変更します。

「Save」をクリックして、データ・モデルを保存します。

さらに、問合せを手動で編集して、Last Name列とFirst Name列を連結してEmployee Nameにできます。 問合せの編集は、以下のように行います。

Select DEPARTMENTS.DEPARTMENT_NAME as "Department Name",
EMPLOYEES.FIRST_NAME || ' '||EMPLOYEES.LAST_NAME as "Employee Name",
EMPLOYEES.HIRE_DATE as "Hire Date",
EMPLOYEES.SALARY as Salary
from OE.DEPARTMENTS DEPARTMENTS,
OE.EMPLOYEES EMPLOYEES
where DEPARTMENTS.DEPARTMENT_ID=EMPLOYEES.DEPARTMENT_ID
and DEPARTMENTS.DEPARTMENT_ID IN (:P_DNAME)

「OK」をクリックし、データ・モデルを保存します。
Query Builderでは、問合せは以下のようになります。

注：問合せを手動で編集したら、Query Builderでは編集できません。

Oracle BI Publisherの現行バージョンで確認したかもしれませんが、 データ・モデルのXMLデータをプレビュー表示できます。

ページ右上のXMLアイコンをクリックし、 前のトピックで定義したデータ・モデルのXML出力を 表示させます。

Departmentパラメータに「All」が選択されていることに注意してください（デフォルト値であるため）。

行数に「All」を選択し、 「Run」をクリックして、部門すべてのXMLデータ出力を表示させます。

（ここでは、XMLデータの一部が画面に表示されます）

Oracle BI Publisher（Web）にOracle BIのAdministrator権限を持つユーザーとしてログインします（ログインしていない場合）。
「Administration」リンク（Oracle BI Publisherページの右上）をクリックします。

「Administration」ページで、System Maintenanceセクションの「Scheduler Configuration」リンクをクリックします。

表示されるScheduler Configurationページで、Database Connectionセクションの「Test Connection」をクリックして、スケジューラが正しく構成されているかどうかを確認します。

接続に成功したことを示す次のメッセージが表示されます。

これで、レポートのスケジューリングを開始できます。

Oracle BI Publisher Administrationページでは（このページにアクセスするにはOracle BIのAdministrator権限でOracle BI Publisherにアクセスする必要があります）、Deliveryセクションに配信先の一覧が表示されます。
Deliveryセクションで「Email」リンクをクリックします。

電子メールの構成ページで、「Add Server」をクリックします。

Add Serverページで、

• メール・サーバーの適切な名前をServer Nameフィールドに入力します。
• Hostフィールドに電子メール・サーバーを入力します。
• 適切であれば、以下のフィールドに値を入力します。
  • Generalフィールド：ポート番号
  • Securityフィールド：ユーザー名およびパスワード
  「Apply」をクリックします。

重要な注意点：タイプ（プリンタ、ファックス、電子メール、WebDAV、またはFTP）にかかわらず、おのおののサーバーに一意の名前を入力する必要があります。

同様に、配信先の1つとしてWebDAVサーバーを追加できます。 Administrationページで「WebDAV」リンクをクリックし、「Add Server」をクリックします。

• Server Nameフィールドに適切な名前を入力し、WebDAVサーバーのホストを入力します。
• 適切な場合は、以下のフィールドを入力します。
  • Generalフィールド：ポート番号
  • Securityフィールド：認証タイプ（None、Basic、Digest）および暗号化タイプ（None、SSL）。
  • Proxy Serverフィールド：ホスト、ポート番号、ユーザー名、パスワード、認証タイプ（None、Basic、Digest）

Oracle BI Publisherにログインし（ログインしていない場合）、カタログの「My Folders」→「Learn folder」に進みます。

Employee Salaries by Departmentレポートの下の「Schedule」リンクをクリックします。

注：Scheduleリンクが表示されない場合は、ユーザーにScheduler権限がないか、Schedulerが正しく構成されていないことが考えられます。

Schedule Report Jobページが表示されます。
Generalタブのページで、レポート名およびパラメータ値を選択できます（Departmentレポート・パラメータの値に「All」を選択します）。

「Output」タブをクリックして出力オプションを定義します。 "Use Bursting Definition to Determine Output& Delivery Destination"チェック・ボックスが選択されていないことを確認してください。

次のオプションを選択します。

• 名前にDeptSalを入力して、Layoutドロップダウン・リストから「Departmental Salaries」を選択し、適切な出力形式として「PDF」を選択します。
• ドロップダウン・リストから、ロケール、カレンダーのデフォルト値を受け入れ、適切なタイムゾーンを選択します。
• Save Outputチェック・ボックスが選択されていることを確認します。

また、Make Output Publicオプションが選択されていないことを確認し（このオプションを選択すると、スケジュールされたレポートの出力がすべてのユーザーに対して表示されます）、Save Data for Republishingオプションが選択されていることを確認します（これにより、後でレポートを異なるレイアウトや出力タイプで再公開できます）。

スケジューリングされたレポートの配信先を追加することもできます。 Destinationセクションで、Destination Typeとして「Email」を選択し、「Add Destination」をクリックします。

Destinationセクションの下部にEmailセクションが表示されます。 必要に応じてTo、CCおよびReply ToフィールドにメールIDを追加し、メールにSubjectを追加してメッセージを入力します。

注：

• スケジュールされたレポートに配信先を追加するには、最初に配信先をAdministrationページで構成しておく必要があります。
• スケジュールされた1つのジョブに複数の出力を定義し、それぞれを別個の宛先に配信できます。 たとえば、PDF出力を電子メールに添付してマネージャのリストに配信する場合を考えてみましょう。 また、同時に同じレポートのExcel出力をコンテンツ管理サーバーに（WebDAV経由で）配信するとします。

「Schedule」タブをクリックしてスケジューリング・オプションを定義します。

「Run Now」オプションを選択することにより、ジョブをただちに実行します。 ドロップダウン・リストからFrequencyに「Once」を選択します。

電子メール通知オプションを追加することもできます（すでに電子メールの配信先を定義している場合）。

「Submit」をクリックしてスケジュールを配信します。

ジョブ名にEmployee Salaries by Department-Schedと入力して、もう一度「Submit」をクリックします。

ジョブの配信に成功したことを示すメッセージが表示されます。 「OK」をクリックします。

レポート・ジョブの週次実行のスケジューリング

このジョブを作成するには、まず上記の1から3のステップに従います。 ステップ4で、「Schedule」タブをクリックし、以下のオプションを選択します。

• Frequencyドロップダウン・リストから「Weekly」を選択します。
• レポートを毎週実行するためのオプションを入力したことを確認してください。
• レポートを月曜日ごとに実行するように「Monday」を選択します。
• StartフィールドおよびEndフィールドに、レポートの開始日付および終了日付を入力し、時間は午前8時であることを確認します。

「Submit」をクリックしてジョブを送信し、ジョブの名前を指定してからもう一度「Submit」をクリックします。

ジョブのスケジューリングで利用可能な異なるFrequencyパターンをいくつか選択します。 Specific Datesオプションでは、カレンダー要件に合うように完全なカスタム・パターンを作成できることに注意してください。

「Open」（ページの右上）をクリックし、「Report Job History」を選択します。

Report Job Historyページに、実行中のレポート・ジョブおよび完了したレポート・ジョブの情報が表示されます。 以下のスクリーンショットに、作成したレポート・ジョブの一覧が表示されていることがわかります。 （ジョブ・ステータスが成功を示していることに注意してください）。 ジョブ名のリンク（「Employee Salaries by Department -Sched」）をクリックします。

適切な検索基準を入力して、レポートを検索、または特定のレポートのジョブ履歴を検索することもできます。 さまざまな検索基準を使用できることに注目してください。

特定のレポートに関する、 ジョブ情報全般および他のジョブ実行の詳細が表示されます。 「DeptSal」（Output Name列）をクリックし、作成したDepartmental Salariesレイアウトを使用して、 スケジュールされたレポート出力を表示します。

Oracle BI Publisherで「Return」をクリックします。

注：「Republish」オプションをクリックして、スケジュールされたジョブを異なるレイアウトおよび出力オプションで再公開することもできます。

同様に、「Report Jobs」をクリックしてManage Report Jobsページを表示します。 このページには、将来の日付でスケジュールされているジョブ、 および繰り返されるレポート・ジョブに関する情報が 表示されます。 このページから、レポート・ジョブの一時停止、再開、編集または削除ができます。

ジョブ名の隣の列をクリックして、そのジョブを選択します。「Pause」をクリックしてジョブを一時停止します。 （ジョブ・ステータスがPausedに変更されることに注目してください。）

同じジョブを再開する場合は、「Resume」をクリックします。 同様に、ジョブを削除する場合は「Delete」をクリックします。