レポート デザイナーを使用して Reporting Services の改ページ調整されたレポートをデザインする (SSRS)
レポート デザイナーを使用すると、 Reporting Services のフル機能付きのページ分割レポートおよびレポート ソリューションを作成できます。 レポート デザイナーには、データ ソースを定義できるグラフィカル インターフェイスが用意されています。 レポート デザイナーには、データセットとクエリ、データ領域とフィールドのレポート レイアウトの配置、連携するパラメーターとレポートのセットなどの対話機能も用意されています。
レポート デザイナーは、Microsoft Visual Studio のビジネス インテリジェンス ソリューション作成環境である SQL Server Data Tools (SSDT) の機能です。 SQL Server Data Tools (SSDT) は、SQL Server には含まれていません。 SQL Server Data Toolsをダウンロードします。
レポート プロジェクトの利点
レポート プロジェクトは、レポート定義およびリソース用のコンテナーの役割を果たします。 プロジェクトを使用する目的
レポートおよび関連アイテムを 1 つのコンテナーにまとめます。
レポートおよび関連アイテムがローカルに格納されているレポート ソリューションをテストします。
関連アイテムをまとめて配置します。 プロジェクトのプロパティと構成管理を使用して、複数の環境に配置します。
レポートおよび関連アイテムの一連のプライマリ コピーを保持します。 配置後、パブリッシュされたレポートが誤って変更される可能性があります。
この記事の情報は、SQL Server Data Tools (SSDT) ソリューションで単一レポート プロジェクトのページ分割レポートおよび関連アイテムを設計する場合に参考にしてください。 SQL Server Data Tools のソリューションおよび複数のプロジェクトの詳細については、「 SQL Server Data Tools の Reporting Services」を参照してください。
共有データ ソース
SQL Server Data Tools を使用して、レポート ソリューションの共有データ ソースを定義および配置します。 共有データ ソースは、 OverwriteDataSources プロパティおよび TargetDataSourceFolder プロパティを使用して、プロジェクト内の他のアイテムとは別に配置できます。 詳細については、「配置プロパティを設定する (Reporting Services)」を参照してください。
レポート デザイナーでは、レポート データ ペインとソリューション エクスプローラーの両方で作業して、レポートで使用されるデータ ソースを定義します。 詳しくは、「 Report Data Pane」をご覧ください。 レポート サーバーまたは SharePoint サイトにパブリッシュされ、SQL Server Data Tools ソリューションに含まれていないデータ ソースを開く際に、SQL Server Data Tools を使用することはできません。 その機能には、レポート ビルダーの作成環境 (SSRS) を使用します。
SQL Server Data Tools はクライアント ツールです。 レポート ソリューションをローカル コンピューターでテストし、サーバー ソリューションをテストするためにテスト環境に配置した後、運用環境に配置できます。 配置後、データ ソース処理拡張機能とデータ ソース資格情報がレポート サーバー環境用に構成されていることを確認します。 構成マネージャーを使用すると、さまざまな配置のプロパティを管理できます。 詳細については、「SQL Server データ ツールの Reporting Services (SSDT)」を参照してください。
詳細については、「データ接続文字列を作成する - レポート ビルダーおよび SSRS」を参照してください。
共有データセット
SQL Server Data Tools を使用して、レポート ソリューションの共有データセットを定義および配置します。 共有データセットは、 OverwriteDatasets プロパティおよび TargetDatasetFolder プロパティを使用して、プロジェクト内の他のアイテムとは別に配置できます。 詳細については、「配置プロパティを設定する (Reporting Services)」を参照してください。
レポート デザイナーでは、レポート データ ペインとソリューション エクスプローラーの両方で作業して、レポートで使用される共有データセットを定義します。 詳しくは、「 Report Data Pane」をご覧ください。 レポート サーバーまたは SharePoint サイトから直接パブリッシュ済みデータセットを開く際に、SQL Server Data Tools を使用することはできません。 その機能には、共有データセット モードでレポート ビルダーの作成環境 (SSRS) を使用します。
SQL Server Data Tools はクライアント ツールです。 クエリ デザイナーを使用すると、[プレビュー] でクエリ結果をローカルに作成してテストできます。 配置後、共有データセットは、依存する共有データ ソースおよびレポートとは別に管理できます。 詳細については、「レポート埋め込みデータセットと共有データセット (レポート ビルダーおよび SSRS)」、「クエリ デザイン ツール (SSRS)」、「共有データセットを管理する」を参照してください。
ページ分割されたレポート
ページネーションのあるレポートは、レポート プロジェクト内に保存されるファイルです。 レポートは、スタンドアロン レポート、サブレポート、またはメイン レポートからのドリルスルー アクションの対象として使用できます。 TargetReportFolder プロパティおよびその他のプロパティを使用して、プロジェクト内の他のアイテムとは別にレポートを配置できます。 詳細については、「配置プロパティを設定する (Reporting Services)」を参照してください。
Note
SharePoint モードでレポート サーバーにパブリッシュする場合、レポート デザイナー プロジェクトでは一部のレポート ソリューション機能をテストできません。 レポート、サブレポート、および詳細レポートへの参照では、レポート プロジェクトの配置後にのみテストできる完全修飾 URL を使用する必要があります。 詳細については、「SharePoint モードのレポート サーバー上のパブリッシュされたレポート アイテムの URL の例 (SSRS)」を参照してください。
レポートは、次の方法でプロジェクトに追加できます。
新しいレポート プロジェクトの追加 既定では、空のレポートがレポート デザイナーに表示されます。 詳細については、「新規または既存のレポートをレポート プロジェクトに追加する (SSRS)」を参照してください。
レポート ウィザード プロジェクトの追加 順を追った指示に従ってレポートを作成します。 レポート ウィザードでは、データ定義とレポート デザインが、一連の手順に簡略化され、完成したレポートが生成されます。 スタイルを追加して、組織のウィザードをカスタマイズできます。 詳細については、「新規または既存のレポートをレポート プロジェクトに追加する (SSRS)」を参照してください。
新しい種類のアイテム (レポート) の追加 空のレポートがレポート デザイナーに表示されます。
既存のアイテムの追加 既存のレポート定義 (.rdl) がレポート デザイナーに表示されます。 以前のバージョンの Reporting Services からレポートまたはプロジェクトを開くと、プロジェクトが現在のバージョンに、レポートが現在のスキーマに自動的にアップグレードされます。 詳細については、「 Upgrade Reports」を参照してください。
Microsoft Access レポートをインポートします。 Access データベース (.mdb、.accdb) またはプロジェクト (.adp) ファイルからすべてのレポートをインポートします。 レポート デザイナーによって、データベースまたはプロジェクト ファイル内の各レポートが RDL に変換され、レポート プロジェクト内に保存されます。 Access レポートのすべての機能がレポート定義 (.rdl) ファイルに転送されるわけではありません。 詳細については、「Microsoft Access からレポートをインポートする (Reporting Services)」および「サポートされる Access レポート機能 (SSRS)」を参照してください。
Note
インポート機能を使用するには、レポート デザイナーがインストールされているコンピューターに Access 2002 以降のバージョンがインストールされている必要があります。 レポートのインポート時に、Access レポートのデータ ソースが使用可能な状態である必要があります。
RDL の直接操作 レポート デザイナーで作成したレポートは、XML 形式のレポート定義言語 (RDL) ファイルとして保存されます。 このファイルは、レポート デザイナー、テキスト エディターをはじめ、XML の編集が可能な任意のツールで編集できます。
レポート デザイナーでレポート定義ソースを編集する際は、開発ツールのインストール元である SQL Server のバージョンの現在の RDL スキーマで作業していることになります。 プロジェクトを構築する際に、配置プロパティに応じてスキーマ バージョンが変更されることがあります。 詳細については、「SQL Server Data Tools の配置およびバージョン サポート (SSRS)」を参照してください。
RDL を直接編集すると、生成されるレポートがレポート サーバーにパブリッシュできなかったり、実行できなかったりする場合があります。 XML ファイルと同様に、要素内で使用されている XML 固有の文字が正しくエンコードされていることを確認してください。 レポートをパブリッシュすると、レポート サーバー側でそのスキーマを基にして RDL ファイルに含まれる XML の検証が行われます。
RDL スキーマの一部ではない要素を含めるには、その要素を Custom 要素に配置します。 カスタム表示拡張機能では、カスタム要素を読み取ることができます。 ただし、Reporting Services によって提供される表示拡張機能では、要素は無視されます。 たとえば、Custom 要素を使用するとレポートにコメントを保存できます。
詳細については、「レポート定義言語 (SSRS)」を参照してください。
レポート パーツ
注意
レポート パーツは、SQL Server Reporting Services 2019 以降の SQL Server Reporting Services のすべてのリリースと、Power BI Report Server 2022 年 9 月以降の Power BI Report Server のすべてのリリースで廃止になっています。
Report Designer では、テーブル、グラフ、およびその他のページ分割されたレポート アイテムをプロジェクトに作成できます。 それらを作成すると、レポート サーバーや、レポート サーバーに統合されている SharePoint サイトに [レポート パーツ] としてパブリッシュできます。 このアクションを使用すると、自分や他のユーザーが他のレポートで再利用できます。 詳細については、「レポート デザイナーでのレポート パーツ (SSRS)」を参照してください。
TargetReportPartFolder プロパティおよびその他のプロパティを使用して、プロジェクト内の他のアイテムとは別にレポート パーツを配置できます。 詳細については、「配置プロパティを設定する (Reporting Services)」を参照してください。
リソース
レポートに関連していて、レポート サーバーによって処理されないファイルを、プロジェクトに追加できます。 たとえば、写真の画像や空間データの ESRI シェープファイルを追加できます。 詳しくは、リソースに関する記事をご覧ください。
ページ分割されたレポートのレイアウト
レポート レイアウトを作成するには、レポート アイテムとデータ領域をツールボックスからデザイン画面にドラッグして位置を調整します。 レポートにデータを追加するには、データセット フィールドをデザイン画面のアイテムにドラッグします。 Tablix データ領域でデータをグループにまとめるには、データセット フィールドをグループ化ペインにドラッグします。 レポート作成ツールは基本的にレポート定義を作成する方法であるため、レポート ビルダーとレポート デザイナーのレポート デザイン方法は似ています。
ページ分割されたレポートのプレビュー
[プレビュー] は、レポート データとレイアウト デザインを確認する際に使用します。 レポートをプレビューすると、レポート プロセッサはレポート定義スキーマと式の構文を検証し、 Output ウィンドウに問題を一覧表示します。
Note
レポートをプレビューすると、レポートのデータがローカル コンピューターのファイルにキャッシュされます。 同じレポートを、同じクエリ、パラメーター、および資格情報を使用して再びプレビューすると、レポート デザイナーはクエリを再実行する代わりにキャッシュされたコピーを表示します。 データ ファイルは <reportname>.rdl.data として、レポート定義ファイルと同じディレクトリに保存されます。 レポート デザイナーを終了してもファイルは削除されません。
レポートは、次の方法でプレビューできます。
[プレビュー] ビュー [プレビュー] タブを選択します。レポート サーバーで提供されるものと同じレポート処理および表示機能を使用して、レポートがローカルで実行されます。 表示されるレポートは対話型のイメージです。ユーザーは、パラメーターの選択、リンクの選択、ドキュメント マップの表示、レポートの非表示部分の展開と折りたたみなどを行うことができます。 また、インストールされている任意の表示形式にレポートをエクスポートできます。
スタンドアロン プレビュー ブラウザーでローカル レポートを実行します。 デバッグ構成を使用すると、このモードを使用して、作成したカスタム アセンブリをデバッグすることもできます。 プロジェクトをデバッグ モードで実行するには 3 つの方法があります。
[デバッグ] メニューの [デバッグの開始] をクリックします。
Visual Studio の標準ツール バーの [開始] ボタンを選択します。
F5 キーを押します。
レポートを作成しても配置しないプロジェクト構成を使用している場合は、現在の構成の StartItem プロパティで指定されたレポートが、別のプレビュー ウィンドウで開きます。
Note
デバッグ モードを使用するには、開始アイテムを設定する必要があります。 ソリューション エクスプローラーでレポート プロジェクトを右クリックし、 [プロパティ] をクリックします。次に、 [StartItem] で、表示するレポートの名前を選択します。
プロジェクトの開始アイテムではない特定のレポートをプレビューする場合は、レポートを作成しても配置しない構成 (DebugLocal 構成など) を選択し、レポートを右クリックして、[実行] を選択します。 レポートを展開しない構成を選択する必要があります。 それ以外の場合、レポートは、プレビュー ウィンドウにローカルに表示されるのではなく、レポート サーバーにパブリッシュされません。
印刷プレビュー。
プレビュー モードまたはプレビュー ウィンドウに最初に表示されるレポートは、HTML 表示拡張機能によって生成されるレポートと似ています。 プレビューは HTML 形式ではありませんが、レポートのレイアウトおよび改ページは HTML 出力と似ています。
印刷プレビュー モードに切り替えることによって、表示を変更し、印刷されるレポートを表示できます。 プレビュー ツール バーの [印刷プレビュー] ボタンを選択します。 レポートは、実際のページに近い状態で表示されます。 この表示は、画像表示拡張機能および PDF 表示拡張機能によって生成される出力と似ています。 印刷プレビューは画像または PDF ファイルではありませんが、レポートのレイアウトおよびページ割り当ては、それらの形式での出力と似ています。 ページの幅を設定するなど、レポート画像のサイズを選択できます。
印刷プレビューを使用すると、レポートを印刷するときに発生する可能性があるさまざまなレポート表示の問題を識別できます。 一般的な表示の問題は次のとおりです。
レポートの幅が広すぎて、レポートに対して指定した用紙サイズに収まらないため、余分な空白ページが表示される。
指定した用紙の幅を超えて動的に拡張されるマトリックスがレポートに含まれているため、余分な空白ページが表示される。
グループ間の改ページが思いどおりに動作しない。
ヘッダーとフッターが期待どおりに表示されない。
印刷形式で読みやすいようにレポート レイアウトを変更する必要がある。
ページ分割レポートの保存および配置
レポート デザイナーでは、レポートおよび他のプロジェクト ファイルをローカルに保存することも、レポート サーバーまたは SharePoint サイトに配置することもできます。 共有データ ソース、共有データセット、レポート、レポート リソース、およびレポート パーツは、ユーザーが構成するプロジェクト配置プロパティに応じて、別々に配置することも、まとめて配置することもできます。 詳細については、「構成プロパティと配置プロパティ」を参照してください。
レポート デザイナーでは、Reporting Services の現在のバージョンの SQL Server Data Tools (SSDT)がサポートするレポート定義スキーマを使用してレポートをデザインする点を理解しておくことが重要です。 特定のレポート サーバーまたは SharePoint サイトのプロジェクト配置プロパティを設定できます。 レポートを保存すると、レポート デザイナーによって、対象レポート サーバーのバージョンと一致するスキーマ内のビルド ディレクトリにレポート定義が保存されます。 下位のレポート サーバー上でパブリッシュできるレポートを作成するために、レポート デザイナーは対象スキーマに存在しないレポート アイテムを削除します。 このアクションは、メッセージが表示されずに自動的に行われます。 このアクションが行われた場合、元のレポート定義はプロジェクト フォルダーに保持されます。 配置される変更済みのレポート定義は、ビルド フォルダーにあります。
Note
式および配置エラーをデバッグする場合、ビルド フォルダー内のレポート定義を表示する必要があります。 [ソースの表示] は使用しないでください。 [ソースの表示] を使用すると、プロジェクト フォルダーのレポート定義ソースが表示されます。
詳細については、「SQL Server データ ツールの配置およびバージョン サポート (SSRS)」を参照してください。
ローカルでのレポートの保存
レポート デザイナーでレポートまたは他のプロジェクト アイテムを操作する場合、ファイルはローカル コンピューターまたはアクセス権限のある別のコンピューター上の共有に保存されます。
ソース管理ソフトウェアを使用している場合は、レポートを保存するときにレポートをソース管理サーバーにチェックインすることがあります。 詳細については、「ソース管理」を参照してください。
ページ分割レポートの配置または公開
SQL Server Data Toolsでは、レポートまたは他のプロジェクト アイテムを複数のバージョンの Reporting Services レポート サーバーに配置できます。 対象レポート サーバーと互換性のあるスキーマ バージョンへのレポート定義のアップグレードを制御するには、プロジェクト構成を使用します。 プロジェクト構成で制御されるプロパティには、対象レポート サーバー、ビルド プロセスでプレビューと配置のためにレポートを一時的に保存するフォルダー、およびエラー レベルが含まれます。 詳細については、「構成プロパティと配置プロパティ」および「配置プロパティを設定する (Reporting Services)」を参照してください。
別のファイル形式へのページ分割レポートのエクスポート
レポートは、さまざまな形式にエクスポートできますが、エクスポートすることによって、一部のレポート レイアウトや対話機能に影響が生じることがあります。 各種の出力形式に関するデザイン上の注意事項の詳細については、「レポートのエクスポート (レポート ビルダーおよび SSRS)」を参照してください。
レポートの検証とエラー レベル
レポートは、プレビューの前および配置時に検証されます。 レポートをビルドする際にビルドに関する多くの問題が発生する可能性があります。 レポートには、プロジェクトによって指定された Reporting Services のバージョンと互換性のない、式やクエリなどの文字列が含まれる場合があります。
ビルドに関する警告やエラーを管理するには、ErrorLevel プロパティを使用します。 ErrorLevel プロパティには 0 ～ 4 の範囲の値が含まれます。 値によって、エラーとしてレポートされるビルドの問題や、警告としてレポートされるビルドの問題が決まります。 既定値は 2 です。 警告とエラーは SQL Server Data Tools (SSDT)Output ウィンドウに問題を一覧表示します。
ErrorLevel の値以下の重大度レベルを持つ問題は、エラーとしてレポートされます。それ以外の問題は、警告としてレポートされます。
次の表に、エラー レベルを示します。
| エラー レベル | 説明 |
|---|---|
| 0 | レポートのプレビューおよび配置を妨げる、最も重大で避けることのできないビルドの問題。 |
| 1 | レポートのレイアウトが大幅に変更される重大なビルドの問題。 |
| 2 | レポートのレイアウトが大きく変更される重大度のやや低いビルドの問題。 |
| 3 | レポートのレイアウトが目立たない程度に若干変更されるマイナーなビルドの問題。 |
| 4 | パブリッシュ上の警告としてのみ使用される。 |
SQL Server 2016 (13.x) Reporting Services 以降 (SSRS) で新しくなったレポート アイテムが含まれるレポートをプレビューまたは配置しようとすると、これらのレポート アイテムはレポートから削除される可能性があります。 既定では、構成の ErrorLevel プロパティは 2 に設定されます。この設定では、マップが削除されると、レポートの作成が失敗する原因となります。 ただし、ErrorLevel プロパティの値を 0 または 1 に変更すると、マップが削除されても、警告が発行され、ビルド プロセスは続行されます。
関連するコンテンツ
SQL Server Data Tools のダウンロード
SQL Server Data Tools の Reporting Services
クエリ デザイン ツール
SQL Server Data Tools の配置およびバージョン サポート
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示