1. 説明
FineReportのレポートではパラメータを、使用範囲によって「テンプレートパラメータ」と「全体パラメータ」に区分することができます。また、使用方法によって「テンプレートパラメータ」と「データセットパラメータ」に区分することができます。以下に詳しく紹介します。
2.
使用範囲による区分
2.1 テンプレートパラメータ
テンプレートパラメータとは、現在のテンプレートに新規作成するパラメータのことを指します。テンプレート>テンプレートパラメータで定義し、現在のレポート中でのみ使用することができます。また、フィルターを併用しなければデータをフィルタリングすることができません。詳しくはをご覧ください。
2.2
全体パラメータ
全体パラメータとは、現在のプロジェクト内に新規作成するパラメータのことを指します。サーバ>全体パラメータで定義します。定義の方法は
テンプレートパラメータと同様です。プロジェクト内のすべてのレポートで使用することができます。フィルターを併用しなければデータをフィルタリングすることができません
注:定義した全体パラメータはすべてWEB-INF\resources\config.xmlファイルに保存されます。全体パラメータとテンプレートパラメータが同じ場合は、テンプレートパラメータが採用されます。
また、使用範囲により区分されるパラメータはフィルター条件を併用する必要があります。
2.3 区別
テンプレートパラメータと全体パラメータの使用方法は同じです。ただし、作用する範囲が異なります。
全体パラメータ:現在のプロジェクトアプリケーションにおけるすべてのテンプレートで使用することができます。
テンプレートパラメータ:現在のテンプレートでのみ使用することができます。
3.
使用方法による区分
3.1 テンプレートパラメータ
使用範囲による区分におけるテンプレートパラメータと同様で、同種のパラメータを記述します。
3.2 データセットパラメータ
現在のテンプレートのテンプレートデータセットに追加されるパラメータを指します。テンプレートデータセット>データベース検索で定義し、現在のレポートでのみ使用することができます。詳しくは
データセットパラメータをご覧ください。
サーバ上のデータセットに追加するパラメータを指します。サーバデータセット>データベース検索で定義します。定義方法はデータセットパラメータと同じです。プロジェクト内のすべてのレポートで使用することができます。
注:定義したサーバデータセットパラメータはWEB-INF\resources\datasource.xmlに保存されます。サーバデータセットパラメータとテンプレートデータセットパラメータが同じ場合は、テンプレートデータセットパラメータが採用されます。
3.3 区別
テンプレートパラメータとテンプレートデータセットパラメータの作用する範囲は同じですが、使用方法が異なります。また、テンプレートパラメータとサーバデータセットパラメータは作用する範囲も使用方法も異なります。
テンプレートデータセットパラメータ:戻されるデータセットに対し直接に作用します。そのため、このようなパラメータ定義方法を使う場合、取得されるデータセットはすでに条件を満たしたデータです。したがって、フィルター条件を設定する必要はありません。現在のテンプレートにのみ作用します。
サーバデータセットパラメータ:テンプレートデータセットパラメータに類似しています。唯一異なるのは、プロジェクト内のすべてのテンプレートに作用し、直接呼び出すことができることです。
テンプレートパラメータ:取り出されるデータセットに対し影響しません。必要なデータをすべて取り出し、パラメータを呼び出して、セル中のデータにフィルタリングを行います。このようにして、自身の必要なデータを表示させます。現在のテンプレートにのみ作用します。
結論:データセットパラメータは条件を満たすデータを直接に取り出しますが、テンプレートパラメータはすべてのデータを取り出した後に、
フィルター条件の設定を通して対応するパラメータのデータを再度取得します。このため、データ量が大きい場合にデータセットパラメータを使用すると、レポートのアクセス効率を高めることができます。
4.
共用説明
全体パラメータとサーバデータセットパラメータはともにすべてのパラメータで共用です。共用とは、以下のことを意味します。テンプレートの数にかかわらず、パラメータは1回定義するだけで充分です。ただし、使用時に各テンプレートは独立しています。BSクライアントで1枚のテンプレートに全体パラメータを割り当てると、その他のテンプレートがその値を使用できるというわけではありません。
以下のページで、いくつかの簡単な例をあげてテンプレートパラメータ、
データセットパラメータ、全体パラメータの具体的な使用方法を詳しくご紹介します。
索引:
- テンプレートパラメータ
- データセットパラメータ
- 全体パラメータ
|
|
トップに戻る
CopyRight@2014
帆軟軟件(中国)有限公司がすべての権利を留保しています。 |