Oracle Fusion Middleware Oracle Business Intelligence Publisherレポート・デザイナーズ・ガイド リリース11g (11.1.1) 部品番号 B63038-01

目次

前

次

サブテンプレートの理解

この章では、次のトピックについて説明します。

• サブテンプレートとは
• サブテンプレートのサポートされている場所
• サブテンプレートの設計
• デスクトップからのサブテンプレートのテスト
• カタログでのサブ・テンプレート・オブジェクトの作成
• 外部ソースからのサブテンプレートのコール

サブテンプレートとは

サブテンプレートは、書式設定機能のひとつで、一度定義すれば、複数のレイアウト・テンプレートの間で何度も使用できます。この書式設定には、RTFファイル形式またはXSLファイル形式を使用できます。RTF形式のサブテンプレートは、Microsoft Wordのネイティブ機能を使用するように、設計が簡単です。XSL形式のサブテンプレートは、複雑なレイアウトやデータ要件の場合に使用します。

サブテンプレートの一般的な用途のいくつかを次に示します。

• 共通のレイアウトまたはコンポーネントの再利用(ヘッダー、フッター、アドレス・ブロックなど)

• パラメータ化されたレイアウトの処理

• 動的または条件付きのレイアウトの処理

• 時間のかかる計算の処理や数式の再利用

RTFサブテンプレートについて

RTFサブテンプレートは、1つ以上の<?template:?>定義で構成されたRTFファイルであり、各定義には書式設定またはコマンドのブロックが含まれています。

このRTFファイルは、BI Publisherにカタログのサブ・テンプレート・オブジェクトとしてアップロードされるとき、別のRTF テンプレート内からコールすることができます。

XSLサブテンプレートについて

XSLサブテンプレートとは、BI Publisherの書式設定エンジンが実行するXSLの書式設定コマンドまたは処理コマンドが含まれているXSLファイルです。RTF標準ではサポートされていない複雑な計算または書式設定命令を含めるには、XSLテンプレートを使用します。

このXSLファイルは、BI Publisherにカタログのサブ・テンプレート・オブジェクトとしてアップロードされるとき、別のRTF テンプレート内からコールすることができます。

サブテンプレートのサポートされている場所

サブテンプレートはBI Publisherのカタログにアップロードすることをお薦めします。これは最も安全な場所です。

古いバージョンのBI Publisherとの互換性のため、ローカル・サーバーや別のサーバーのファイルにあるサブテンプレートをコールすることができます(その場合はHTTPプロトコル経由でアクセスします)。このような方法を使用するには、通信できるようにするために、特定のインポート構文およびサーバー設定が必要です。詳細は、「外部ソースからのサブテンプレートのコール」を参照してください。

サブテンプレートの設計

RTFサブテンプレートの設計の詳細は、「RTFサブテンプレートの設計」を参照してください。

XSLサブテンプレートの設計の詳細は、「XSLサブテンプレートの設計」を参照してください。

デスクトップからのサブテンプレートのテスト

BI Publisherテンプレート・ビルダーをインストール済の場合は、テンプレートおよびサブテンプレートをBI Publisherカタログにアップロードする前に、これらの組合せをプレビューできます。ローカル環境からテストするには、BI Publisherプロセッサがローカル・ディレクトリのサブテンプレート・ファイルを検出できるように、インポート・テンプレート構文を変更する必要があります。テストするには、次のようなインポート・テンプレート構文を入力します。

<?import:file:{local_template_path}?>

例:

<?import:file:C:///Template_Directory/subtemplate_file.rtf?>

または、XSLサブテンプレート・ファイルでは次のようになります。

<?import:file:C:///Template_Directory/subtemplate_file.xsl?>

次にテンプレート・ビルダーで「プレビュー 」オプションを選択すると、BI Publisherプロセッサがサブテンプレートを検出し、ローカル環境から表示できるようになります。

プライマリ・テンプレートをBI Publisherカタログにアップロードする前に、カタログの適切な場所をポイントするようにインポート構文を変更する必要があります。

カタログでのサブ・テンプレート・オブジェクトの作成

サブテンプレート・ファイルをアップロードするには:

1. グローバル・ヘッダーで、「新規」をクリックし、「サブ・テンプレート」をクリックします。サブ・テンプレートページが表示されます。

2. 「テンプレート」リージョンで、「アップロード」をクリックし、「テンプレート・ファイルのアップロード」ダイアログを起動します。

3. サブテンプレート・ファイルを参照および選択します。

   • タイプ: RTFサブテンプレート・ファイルの場合はrtf、XSLサブテンプレート・ファイルの場合はxslを選択します。

   • ロケール: サブテンプレート・ファイルの該当するロケールを選択します。

4. 「アップロード」をクリックします。

   サブテンプレート・ファイルが、「テンプレート」リージョンに選択したロケール名で表示されます(例: en_US)。

5. 「保存」をクリックします。「別名保存」ダイアログで、サブ・テンプレートを保存するカタログ・フォルダを選択します。「名前」に名前を入力し、「保存」をクリックします。次の図は、My Subtemplateと命名されたサブ・テンプレートを示しています。

   

6. (RTFサブ・テンプレートのみ)複数のローカライズ済ファイルをアップロードしている場合は、デフォルトとして使用するファイルを選択します。テンプレート・ファイルのローカライゼーションの詳細は、「サブ・テンプレートへの翻訳の追加」を参照してください。

   注意: サブ・テンプレートの定義にアップロードできるRTFファイルはロケールごとに1つだけです。このサブ・テンプレートに追加のテンプレート・ファイルをアップロードした場合は、アップロード前の名前に関係なく、各ファイルにロケールとしての名前が自動的に付けられます。

   重要: XSLサブ・テンプレートの翻訳はサポートされていません。

サブ・テンプレート・オブジェクトは、.xsbという拡張子で保存されることに注意してください。サブ・テンプレート・オブジェクトをインポートするときは、ここで選択した名前に.xsb拡張子を付けた名前を使用します(例: MySubtemplate.xsb)。

外部ソースからのサブテンプレートのコール

ここでは、カタログの外部にあるサブテンプレートをコールする方法について説明します。

重要: これらの手順は、下位互換性のためにのみ提供されています。サブテンプレートはカタログに配置することをお薦めします。

カタログの外部で管理されているサブテンプレートについては、ローカライゼーションはサポートされていません。

HTTPまたはFTP経由でのカタログの外部のサブテンプレートのインポート

httpやftpなどの標準プロトコルを使用して、次のようなインポート・ステートメントを入力します。

<?import:http//myhost:8080/subtemplate.rtf?>

同じサーバー上のカタログの外部のサブテンプレートのインポート

サブテンプレートがサーバー上にあり、BI Publisherカタログ内にはない場合、次のように入力します。

<?import:file://{template_path}?>

説明:

template_pathはサーバー上にあるサブテンプレート・ファイルへのパスです

例:

<?import:file://c:/Folder/mySubtemplate.rtf?>

カタログの外部に格納されているサブテンプレートを実行するために必要な設定

サブテンプレートを使用するには、レポート用に以下のFO処理構成プロパティを設定する必要があります。

• 外部参照無効化: Falseに設定する必要があります

Copyright © 2010, 2011, Oracle and/or its affiliates. All rights reserved.