サブレポートの使用

サブレポートを使って、レポート内にレポートをネストすることができます。サブレポートに表示するデータは通常、メインレポートのデータと関連性があります。そして、1 つまたは複数のサブレポートパラメータをサブレポートに渡すことにより、サブレポートを有効にすることができます。ただし、サブレポートに表示されるデータが、メインレポートのデータと関連していない場合もあります。

サブレポートを使用する状況は次のとおりです。

• RIGHT OUTER JOIN などの複雑な SQL の使用を回避する場合
• レポートが複数のデータベースのデータを要求する場合

次の図は、サブレポートパラメータの使用法を示し、レポートとサブレポート間の関係を表しています。

メモ: Report Builder は、複数のレベルのネストをサポートしていますが、表示できるネストのレベルは 1 つだけです。

サブレポートの詳細については、Report Builder のオンラインヘルプを参照してください。

サブレポートの定義

サブレポートを定義してレポートに設定することも、メインレポートに挿入する手順の一環としてサブレポートを定義することもできます。

ただし、定義方法にかかわらず、サブレポートには次の特性が設定されます。

• データは、詳細バンドのみで表示されます。サブレポートがヘッダやフッタバンドを使用することはありません。
• サブレポートがメインレポートに関連付けられる場合、サブレポートには、WHERE 節が設定された SELECT ステートメントを使用する内部クエリーが含まれている必要があります。さらに、WHERE 節にはメインレポートの Subreport Expression プロパティで使用された入力パラメータ名が指定されている必要があります。

レポートへの既存サブレポートの追加

既にサブレポートを定義している場合、このサブレポートをメインレポートに追加し、必要に応じてサブレポートパラメータを定義します。

レポートに既存のサブレポートを追加するには :

1. メインレポートを定義するか開きます。
2. ツールボックスの [サブレポート] アイコンをクリックします。
3. サブレポート領域を、特定のレポートバンドにドラッグします。

   [サブレポートソース] パネルが表示されます。

4. [既存のレポートから] を選択し、サブレポートを指定して、[次へ] をクリックします。

   [サブレポートパラメータバインディングへのレポート] パネルが表示されます。

5. サブレポートのフィールドに相当するメインレポートのフィールドを選択し、[次へ] をクリックします。

   [サブレポート設定の終了] パネルが表示されます。

6. [終了] をクリックします。

   Report Builder は、サブレポートをメインレポートに追加します。この結果、レポートはサブレポートパラメータとしてサブレポートマッピングに保存されます。

7. サブレポートパラメータの設定を変更するには、サブレポートを選択し、[プロパティ] シートの [サブレポートパラメータ] をクリックします。

レポートへの新規サブレポートの追加

サブレポートで必要となるデータが明確な場合、サブレポートをメインレポートに追加するときに、新規サブレポートを定義できます。

レポートに新規サブレポートを追加するには :

1. メインレポートを定義するか開きます。
2. ツールボックスの [サブレポート] アイコンをクリックします。
3. サブレポート領域を、特定のレポートバンドにドラッグします。

   [サブレポートソース] パネルが表示されます。

4. [新規レポートとして] を選択し、[次へ] をクリックします。

   [クエリーフィールドの定義] パネルが表示されます。

5. [クエリービルダー] をクリックします。

   クエリービルダーが表示されます。

6. サブレポートのテーブルと列を選択します。
7. キー列に対して条件列と基準列を使用することにより、レポートに WHERE 節を指定します。

   [条件] に [WHERE] を指定し、[基準] に対して ='#CFVariable#' (文字列の列)、=#CFVariable# (数値列) のいずれかを指定してから、CFVariable をサブレポートの入力パラメータ名で上書きします (この後の手順で入力パラメータ名を定義します)。

8. [保存] をクリックします。
9. [次へ] をクリックします。

   [レポートグループの定義] パネルが表示されます。

10. サブレポートに応じて、グルーピングフィールドを指定します。
11. [次へ] をクリックします。

    [レポートレイアウト] パネルが表示されます。

12. [Free Form] または [グリッド] を指定します。[次へ] をクリックします。

    [レポートスタイル] パネルが表示されます。

13. [Only Detail Band] を指定し、[次へ] をクリックします。

    [レポートの題目] パネルが表示されます。

14. カラースキームを指定し、[次へ] をクリックします。

    [レポート名] パネルが表示されます。

15. 必要に応じて見出しを指定し、[次へ] をクリックします。

    [サブレポートバインディング] パネルが表示されます。

16. サブレポートで必要となる各パラメータに対し、次の項目を指定します。
    • パラメータ名
    • メインレポートと関連付けられる値 (ドロップダウンリストボックスをクリック)
    • データタイプ
17. [次へ] をクリックします。

    [サブレポートファイル名] パネルが表示されます。

18. サブレポートの完全修飾ファイル名を指定します。
19. [次へ] をクリックします。

    [サブレポート設定の終了] パネルが表示されます。

20. [終了] をクリックします。
21. 必要に応じてサブレポートを編集します。

    Report Builder により、サブレポートがメインレポートに追加されます。

サブレポート設定の編集

Report Builder により、サブレポート名の変更およびメインレポート内のサブレポートパラメータの編集を実行できます。

サブレポートの設定を編集するには :

1. メインレポート内のサブレポート要素をクリックします。

   サブレポートの設定が [プロパティ] シートに表示されます。

2. サブレポートを変更するには、[サブレポート式] を編集します。
3. サブレポートのパラメータを編集するには :
   1. [サブレポートパラメータ] プロパティをクリックします。
   2. [...] ボタンをクリックします。

   [サブレポートパラメータ] ダイアログボックスが表示されます。

   3. サブレポートパラメータの追加、編集、または削除を実行します。
   4. [OK] をクリックします。

ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX* | ColdFusion 5* | フォーラム* | デベロッパーセンター | サポート情報 | バグ報告

バージョン7