すべて展開
すべて折りたたむマスターレポートは動的なテンプレートのようなもので、コンテンツレポートを読み込むように設計できます。これは、ページのヘッダにあるロゴやフッタにあるWebサイトへのリンクといった共通要素を複数のレポートで共有する場合に便利です。マスターレポートは、コントロール、コード、データソース、レイアウトプロパティを使用して設計できます。これらはコンテンツレポートからは変更できません。
マスターレポートは、レポートが実行されるたびにロードされるという点で、テンプレートとは異なります。したがって、マスターレポートを変更すると、そのマスターレポートを参照するすべてのレポートに変更が自動的に適用されます。
マスターレポートの利点
- マスターレポート内に一貫したページヘッダやフッタを追加するなど、レポート共通の機能を実装できる。
- 全社的な情報の変更（住所の変更など）があった場合に、各レポートを個別に変更するのではなく、単一のマスターだけを変更すればよい。
- データに関する広範な変更（データソースの変更など）があった場合、マスターレポートに変更を適用するだけでコンテンツレポートにも同じ変更が反映される。
- アプリケーション全体または企業全体にわたって共通のコード、データソース、テーマ、ページレイアウトを作成できる。
- スタンドアロンのデザイナアプリケーションを使用してコンテンツレポートを作成するエンドユーザーに対してレポートの複雑さが見えないようにする。
マスターレポートの設計
マスターレポートを設計するときは、コントロール、コード、データソース、レイアウトプロパティを通常のレポートと同じように使用します。マスターレポートは単独でも有効であり、コンテンツレポートなしで実行できます。エンドユーザーがマスターレポートを変更できないようにするには、そのユーザーまたはグループに対して当該ファイルのパーミッションを読み取りのみに設定します。
マスターレポートはRDLレポートでのみ利用可能であり、テンプレートのようにコンテンツレポートに適用できるRDLX-masterファイル形式に変換されます。
ContentPlaceHolderコントロールは、RDLレポートをマスターレポートに変換するとツールボックスに表示されます。このコントロールは、マスターレポートテンプレートを適用した後にコンテンツレポートの作成または設計に使用する領域を提供します。
 |
メモ: セクションレポート（コードレポート）にもマスターレポートと似たような概念があります。ただしそこでは、他のレポートが継承する基本レポートクラスを標準レポートに作成します。詳細については、レポートテンプレートの継承を参照してください。 |
コンテンツレポートの作成
マスターレポートを適用する対象のレポートのことをコンテンツレポートと呼びます。コンテンツレポートは単独では無効であり、指定したマスターレポートなしでは実行できません。
ユーザーが新しいレポートを作成し、そのレポートに対するマスターレポートを設定すると、設計画面は実質的にマスターレポートの設計画面の正反対になります。ContentPlaceHolderコントロールで覆われたレポートコントロールは、コンテンツレポートの設計時には見えませんが、実行時には表示されることに注意してください。ContentPlaceHolderコントロールは、ユーザーがレポートコントロールを追加できる唯一の領域です。
コンテンツレポートの設計時にユーザーができること
- マスターレポートに存在しない要素を追加する。
- マスターレポートに存在しない新しいデータソースを追加する。
- マスターレポートのデータソースから新しいデータセットを追加する。
- EmbeddedImagesコレクションに画像を追加する。
- ReportParameterコレクションにパラメータを追加する。
- マスターレポートで指定されたプレースホルダ矩形に任意の数のレポートコントロールを追加する。
- レポートの名前と説明を変更する。
- マスターレポートに存在しない新しいカスタムコードを追加する。
コンテンツレポートの設計時にユーザーができないこと
- マスターレポート（無効なグレー領域）に存在する要素を変更または削除する。
- マスターレポートのデータソースを削除する。
- マスターレポートのデータセットを削除する、またはそのクエリーを変更する。
- マスターレポートのデータセットに対する並べ替えまたはフィルタを変更する。
- EmbeddedImagesコレクションから画像を削除する。
- ReportParameterコレクションからパラメータを削除する。
- マスターレポートの余白またはページ設定を変更する。
メモ: マスターレポートに含まれるコードは、コンテンツレポートからは見えません。そのため、コンテンツレポートのユーザーがコードを利用できるようにするには、マスターレポートの作成者が情報を提供する必要があります。
実行時のイベントの順序
コンテンツレポートを実行するとき、その背後では以下の処理が行われます。
- ActiveReportsがコンテンツレポートをロードします。
- ローダーがコンテンツレポートのマスターレポートタグを解析し、リソースリゾルバーにマスターレポートを要求します。
- マスターレポートが定義にロードされます。
- コンテンツレポートの各ContentPlaceHolderが解析されると、そのたびにマスターレポート内の対応するプレースホルダが特定され、コンテンツレポートの内容がそのプレースホルダに読み込まれます。
- データソース、データセット、およびフィールドがマージされます。競合がある場合はマスターレポートの方が優先されます。
- テーマがマージされます。競合がある場合はマスターレポートの方が優先されます。
- コンテンツレポートのレポートプロパティが、マスターレポートのレポートプロパティに追加されます。以下のプロパティについては、競合がある場合はコンテンツレポートの方が優先されます。
- Report Description
- Report Author
- Report AutoRefresh
- Report Custom
- Report Language
- Report DataTransform
- Report DataSchema
- Report ElementName
- Report DataElementStyle
- データセットのフィルタ
- Report Theme
- Report Code
- ContentPlaceHolderコントロール内にあるすべてのコンテンツ
集約されたレポート定義の変更
コンテンツレポートを実行すると、コンテンツレポートとそのマスターを組み合わせて集約したレポート定義が作成されます。ReportDefinition APIを使用して、実行時にこの集約結果を、マスターレポートもコンテンツレポートも持たない3番目のレポート定義として保存できます。集約結果を通常のレポート定義（*.rdlxファイル）として保存した後、そのファイルを他のレポート定義と同様に編集できます。