I Template Viewerを使用したテンプレートのテスト

この付録では、Template Viewerツールの使用方法について説明します。

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

Template Viewerについて

Template Viewerは、テンプレートをテストするために使用するBI Publisherのデスクトップ・ツールです。

Oracle BI Enterprise Editionの「ホーム」ページまたはBI Publisherの「ホーム」ページから、BI Publisherのデスクトップ・ツールをダウンロードできます。WindowsマシンにインストールされたTemplate Viewerを起動するには、「スタート」メニューを使用します。

Template Viewerデスクトップ・ツールを使用して、次のことが可能です。

テンプレートおよびサブテンプレートをデバッグします。「テンプレートのデバッグ」を参照してください。
データ・ファイルへのテンプレートの適用時に使用されるメモリーを追跡します。「メモリー使用率のモニター」を参照してください。
XSLTをプロファイリングして、XSLコードによって消費される時間を表示します。「XSLTのプロファイリング」を参照してください。
テンプレートで使用されるフォントをテストします。「フォントのテスト」を参照してください。
テンプレートに関連するXLIFFファイルを選択して、テンプレートの翻訳をテストします。
「エクスポート」オプションを使用して、ファイルを選択した場所にエクスポートします。
XSLTプロセッサを実行してXML文書を検証します。「XML文書の検証」を参照してください。

GUID-6CC056CB-C2A1-42A8-8115-E8E61F3E10C3-default.gifの説明が続きます

図GUID-6CC056CB-C2A1-42A8-8115-E8E61F3E10C3-default.gifの説明

テンプレートのデバッグ

テンプレートのプレビュー・ウィンドウで期待した結果が得られなかった場合は、Template Viewerを使用してトレース設定を有効にし、デバッグ・メッセージを表示して問題を解決できます。

XSL-FOプロセッサでのサンプル・データとテンプレートのマージ後に生成される、中間XSLファイルを保存および表示することもできます。すでにXSLを使用している場合は、Template Viewerのデバッグ機能をすぐに習得できます。

Template Viewerでテンプレートをプレビューしてログ・メッセージを表示する手順は次のとおりです。

Template Viewerを開きます。

Windowsデスクトップで「スタート」メニューから、「プログラム」、「Oracle BI Publisher Desktop」、「Template Viewer」の順に選択します。
「参照」をクリックして、サンプル・データ・ファイルおよびテンプレート・ファイルを含む作業ディレクトリを選択します。データ・ファイルとテンプレート・ファイルは同じフォルダに置かれている必要があります。
「ファイル」タブで、適切なオプションを選択します。たとえば、.xslテンプレートをテストしている場合は「Excelテンプレート」を選択します。「データ」および「テンプレート」リージョンに、そのディレクトリ内に存在するデータ・ファイルとテンプレート・ファイルが表示されます
適切なデータ・ファイルおよびテンプレート・ファイルをクリックして、それらを選択します。
ログ(デバッグ)レベルを選択します。
サブテンプレートをテストする場合は、「スタイル・テンプレート・ファイル」フィールドでサブテンプレートを参照して指定します。
必要に応じて、「設定(デフォルト)」タブでレポート・パラメータを設定します。
「出力フォーマット」リストから、出力フォーマットを選択します。たとえば、Excelです。
「処理開始」をクリックします。

Template Viewerにより、選択したデータと選択したマスター・テンプレートおよびサブテンプレートがマージされ、適切なビューアが作成されます。メッセージ・ボックスでログ・メッセージを確認します。
生成されたXSLを表示するには:
1. データ・ファイルとテンプレート・ファイルを選択し、出力フォーマットとして「Excel」を選択します。
2. 「ツール」、「XSLファイルの生成元」、「Excelテンプレート」の順に選択します。
3. プロンプトが表示されたら、生成されたXSLファイルを保存します。
4. 保存した場所に移動し、適切なビューアでXSLファイルを開きます。

メモリー使用率のモニター

Template Viewerで、データ・ファイルへのテンプレートの適用時に使用されるメモリーを追跡できます。

テンプレートで使用されるメモリーをモニターする手順は次のとおりです。

データ・ファイルとテンプレート・ファイルを選択します。
「メモリー使用率のモニター」オプションを選択します。
「出力フォーマット」リストから、出力フォーマットを選択します。
「処理開始」をクリックします。

選択したディレクトリに、MemMonLongで始まる名前の付いた.csvファイルが生成されます。このログ・ファイルには、ガーベジ・コレクション前後のメモリーに関する情報が保存されます。メモリーは秒単位で測定される一定の間隔でモニターされます。

XSLTのプロファイリング

Template Viewerを使用してXSLTをプロファイリングできます。XSLテンプレートには、時間を計測でき、プロファイリング・ツールとして機能する時間ロギング・コマンドが含まれています。テンプレートを実行すると、log.csvファイルが生成され、XSLコードの実行時間が記録されます。

Template ViewerでXSLTをプロファイリングする手順は次のとおりです。

Template Viewerを開きます。
Windowsデスクトップで「スタート」メニューから、「プログラム」、「Oracle BI Publisher Desktop」、「Template Viewer」の順に選択します。
作業ディレクトリを参照して選択します。
XSLを生成するXMLデータ・ファイルとRTFテンプレート・ファイルを選択します。
「ツール」、「XSLファイルの生成元」、「XSLへのプロファイリングの挿入」の順に選択します。
XSLを生成する「RTFテンプレート」を選択します。
「出力フォーマット」リストから、「Excel」を選択します。
「処理開始」をクリックします。
Excelを使用してファイルを開きます。
最も時間を消費している3つの領域に注目してください。

XML文書の検証

XML文書を検証して、適切なコードが含まれていることを確認できます。

XSLテンプレートを使用してXML文書を検証する手順は次のとおりです。

Template Viewerを開きます。
Windowsデスクトップで「スタート」メニューから、「プログラム」、「Oracle BI Publisher Desktop」、「Template Viewer」の順に選択します。
作業ディレクトリを参照して選択します。
XMLデータ・ファイルを選択します。
XML文書のテストに使用するXSLテンプレートを選択します。
「出力フォーマット」リストから、XSLTの実行を選択します。

フォントのテスト

フォントをテストして、レポートが正しく表示されることを確認できます。

ローマ字が正しく表示されないなどの問題を回避するために、必要なフォントが正しくマップされていることを確認する必要があります。フォント・マッピングのフォント・ファミリ名が、テンプレートで使用されている名前と完全に一致していることを確認する必要があります。

Template Viewerを開きます。
Windowsデスクトップで「スタート」メニューから、「プログラム」、「Oracle BI Publisher Desktop」、「Template Viewer」の順に選択します。
「設定(「デフォルト」)」タブに移動します。
フォント・マッピングを含むxdo.cfg構成ファイルをロードします。
たとえば、Arialフォントはxdo.cfgファイルで次のように設定されます。
```
    <font family="Arial" style="italic" weight="bold">
         <truetype path="D:\fonts\arialbi.ttf" />
     </font>
```
xdo.cfg構成ファイルに変更を加える場合は、このファイルを再ロードします。
レポートを実行します。
1. 「ファイル」タブで、フォントのテストに使用するデータ・ファイルとテンプレートを選択します。
2. 「出力フォーマット」リストから、出力フォーマットを選択します。
3. 「処理開始」をクリックします
4. レポートを表示して、フォントが正しく表示されているかどうかを確認します。