すべて展開
すべて折りたたむマスターレポートはコンテンツレポートを読み込むようにデザインすることのできる動的なテンプレートのようなものです。これは、ページのヘッダにあるロゴやフッタにある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ファイル）として保存した後、そのファイルを他のレポート定義と同様に編集することができます。