スタート・ガイド

この章では、XMLデータをレポート・テンプレートのレイアウト要素に関連付ける概念について説明します。ここでは、基本的な手法と、複雑で条件付き性の高いレポート・フォーマットを作成するための高度な手法について説明します。

Microsoft Wordを使用してRTFテンプレートを作成する場合は、この章を読む前に「Template Builder for Wordを使用したRTFテンプレートの作成」を参照してください。 Template Builderインストールで提供されるデモおよびサンプルは、Microsoft Wordでテンプレートを作成するプロセスに役立ちます。

RTFテンプレートを作成するためにMicrosoft WordまたはTemplate Builderは必要ありません。この章では、Template Builderを使用せずにコンポーネントを追加する方法について説明します。この章で説明するレイアウト・コンポーネントの多くは、Template Builderを使用してテンプレートに挿入することもできます。

この項には、次のトピックがあります。

RTFテンプレートの概要

リッチ・テキスト・フォーマット(RTF)は、Microsoft Wordなどの一般的なワープロ・アプリケーションで使用される仕様です。

文書を保存する場合、RTFはファイル・タイプ・オプションです。

「パブリッシャ」は、RTFファイル・タイプとして保存された文書をXSL-FOに変換し、多くの標準ワード・プロセッサ機能を使用してレポート・レイアウトを作成できます。

設計時には、XSL式に「パブリッシャ」の簡易タグを使用して、データ・フィールドおよびその他のマークアップをテンプレートに追加します。これらのタグは、XMLレポート・データをレポート・レイアウトに関連付け、その他の処理手順を含めます。

「パブリッシャ」は、ワード・プロセッサの書式設定機能に加えて、条件付き書式設定、動的データ列、累計、チャートなどの他の高度なレポート機能をサポートしています。

XSLに精通していて、簡易タグを使用しない場合、「パブリッシャ」ではテンプレートでの純粋なXSL要素の使用もサポートされます。テンプレートにコードを直接含める場合は、任意のXSL要素、多数のFO要素、および「パブリッシャ」が拡張する一連のSQL式を含めることができます。

テンプレートの設計の前提条件

テンプレートを設計する前に、これらのタスクを実行する必要があります。

テンプレートを設計する前に、次のことを行う必要があります:

ソース・レポートのデータに適用されるビジネス・ルールを確認します。
レポート・データ・モデルからサンプル・データを生成します。

Microsoft Wordの書式設定機能について理解します。

XSLT互換性とは何ですか。

「パブリッシャ」は、W3C XSL変換の1.0推奨事項をサポートする、Oracle XDK 11.1.0.7.0によって提供されるXSLTプロセッサを使用します。

プロセッサは、XSLTおよびXPath 2.0標準の現在の作業下書きも実装します。

デフォルトでは、「パブリッシャ」はXSLT 1.0と互換性があります。テンプレートでXSLTおよびXPath 2.0機能を使用する場合は、XSLT 1.0互換性を無効にする必要があります。この構成はテンプレート・レベルで実行されます。テンプレート・レベルの設定は、サーバー設定よりも優先されます。

XSLT互換性は、WordのTemplate Builderでビルド・オプションとして設定されます。「UIオプションの設定」を参照してください。

主な概念

テンプレート・レイアウトを設計するときは、XML入力ファイルをレイアウトに関連付ける方法を理解する必要があります。

この章では、サンプル・テンプレート・レイアウトとその入力XMLファイルを示し、適切な関連付けを行ってマークアップ・タグをテンプレートに追加する方法を示します。

テンプレート・レイアウトの設計

ワード・プロセッサの書式設定機能を使用して、設計を作成します。

たとえば:

テキストのサイズ、フォントおよび配置を選択
箇条書きと番号の挿入
段落の周りにボーダーを描画
透かしを含める
イメージ(jpg、gifまたはpng)を含める
表自動書式設定機能の使用
ヘッダーとフッターの挿入

「パブリッシャ」コードの追加について

RTFテンプレートを作成する場合は、RTFドキュメントに「パブリッシャ」コードを追加します。次のいずれかのメソッドに従ってコードを追加します。

「パブリッシャ」は、コードを追加するために次のメソッドをサポートしています:

基本RTFメソッド

RTFバージョン1.6ライター(またはそれ以降)をサポートするワード・プロセッサを使用して、「パブリッシャ」の簡略化された構文を使用してテンプレートを設計します。
フォーム・フィールド・メソッド

Microsoft Wordのフォーム・フィールド機能を使用すると、構文をテンプレートのデザインに直接配置するのではなく、非表示のフォーム・フィールドに配置できます。

簡易構文ではなくXSLまたはXSL-FOコードを使用する場合は、フォーム・フィールド・メソッドを使用する必要があります。

この章では、前述のメソッドでRTFテンプレートを作成するメソッドについて説明します。

Microsoft Wordを使用している場合は、「パブリッシャ」 Template Builder for Wordを使用して、「パブリッシャ」コード・フィールドを簡単に挿入できます。