Oracle® Fusion Middleware Oracle Business Intelligence Publisherレポート・デザイナーズ・ガイド 12c (12.2.1) E70038-01 |
|
![]() 前 |
![]() 次 |
サブ・テンプレートは、書式設定機能のひとつで、一度定義すれば、単一のレイアウト・テンプレートで、または複数のレイアウト・テンプレート間で何度も使用できます。この章では、BI Publisherでサブ・テンプレートを使用するための概念について説明します。
この章の内容は次のとおりです。
RTFサブ・テンプレートの設計の詳細は、第13章「RTFサブ・テンプレートの設計」を参照してください。XSLサブ・テンプレートの設計の詳細は、第14・章「XSLサブ・テンプレートの設計」を参照してください。
サブ・テンプレートは、書式設定機能のひとつで、一度定義すれば、単一のレイアウト・テンプレートで、または複数のレイアウト・テンプレート間で何度も使用できます。この書式設定には、RTFファイル形式またはXSLファイル形式を使用できます。RTF形式のサブ・テンプレートは、Microsoft Wordのネイティブ機能を使用するため、容易に設計できます。XSL形式のサブ・テンプレートは、複雑なレイアウトやデータ要件の場合に使用します。
サブ・テンプレートの一般的な用途のいくつかを次に示します。
共通のレイアウトまたはコンポーネントの再利用(ヘッダー、フッター、アドレス・ブロックなど)
パラメータ化されたレイアウトの処理
動的または条件付きのレイアウトの処理
時間のかかる計算の処理や数式の再利用
サブ・テンプレートはBI Publisherのカタログにアップロードすることをお薦めします。これは最も安全な場所です。
古いバージョンのBI Publisherとの互換性のため、ローカル・サーバーや別のサーバーのファイルにあるサブ・テンプレートのコールができます(その場合はHTTPプロトコル経由でアクセスします)。このような方法を使用するには、通信できるようにするために、特定のインポート構文およびサーバー設定が必要です。詳細は、第12.5項「外部ソースからのサブ・テンプレートのコール」を参照してください。
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カタログにアップロードする前に、カタログの適切な場所をポイントするようにインポート構文を変更する必要があります。
サブ・テンプレート・ファイルをアップロードする手順は次のとおりです。
グローバル・ヘッダーで、「新規」をクリックし、「サブ・テンプレート」をクリックします。サブ・テンプレートページが表示されます。
「テンプレート」 リージョンで、「アップロード」をクリックします。
「テンプレート・ファイルのアップロード」ダイアログで、アップロードするサブ・テンプレート・ファイルを選択します。
タイプ: RTFサブ・テンプレート・ファイルの場合はrtf、XSLサブ・テンプレート・ファイルの場合はxslを選択します。
ロケール: サブ・テンプレート・ファイルの該当するロケールを選択します。
「アップロード」をクリックします。
サブ・テンプレート・ファイルが、「テンプレート」リージョンに、選択したロケール名で表示されます(例: English)。
「保存」をクリックします。「別名保存」ダイアログで、サブ・テンプレートを保存するカタログ・フォルダを選択します。「名前」に名前を入力し、「保存」をクリックします。図12-1は、My Subtemplateと命名されたサブ・テンプレートを示しています。
(RTFサブ・テンプレートのみ)複数のローカライズ済ファイルをアップロードしている場合は、デフォルトとして使用するファイルを選択します。テンプレート・ファイルのローカライゼーションの詳細は、第13.6項「RTFサブ・テンプレートへの翻訳の追加」を参照してください。
注意: サブ・テンプレートの定義にアップロードできるRTFファイルは1ロケールに1つのみです。このサブ・テンプレートに追加のテンプレート・ファイルをアップロードした場合は、アップロード前の名前に関係なく、各ファイルにロケールとしての名前が自動的に付けられます。 |
重要: XSLサブ・テンプレートでは、翻訳はサポートされていません。 |
サブ・テンプレート・オブジェクトは、.xsbという拡張子で保存されることに注意してください。サブ・テンプレート・オブジェクトをインポートするときは、ここで選択した名前に.xsb拡張子を付けた名前を使用します(例: MySubtemplate.xsb)。
ここでは、カタログの外部にあるサブ・テンプレートをコールする方法について説明します。
重要: これらの指示は、下位互換性のためにのみ提供されています。サブ・テンプレートはカタログに配置することをお薦めします。 |
カタログの外部で管理されているサブ・テンプレートについては、ローカライゼーションはサポートされていません。
httpやftpなどの標準プロトコルを使用して、次のようなインポート・ステートメントを入力します。
<?import:http//myhost:8080/subtemplate.rtf?>