レポート ビューアー Web パーツのカスタマイズCustomize the Report Viewer web part

適用対象:APPLIES TO: はいSQL Server 2016 Reporting Services 以降SQL Server 2016 Reporting Services and later はいPower BI レポート サーバーPower BI Report Server はいSharePoint 2016 以降SharePoint 2016 & later いいえSharePoint OnlineSharePoint OnlineはいSQL Server 2016 Reporting Services 以降SQL Server 2016 Reporting Services and later はいPower BI レポート サーバーPower BI Report Server はいSharePoint 2016 以降SharePoint 2016 & later いいえSharePoint OnlineSharePoint Online

以前のバージョンの SQL Server Reporting Services (SSRS) に関するコンテンツについては、「SQL Server 2014 Reporting Services」をご覧ください。For content related to previous versions of SQL Server Reporting Services (SSRS), see SQL Server 2014 Reporting Services.

レポート ビューアー Web パーツを使用することで、SharePoint 統合用に構成されているレポート サーバーで実行されるレポートを表示できます。You can use the Report Viewer web part to view reports that run on a report server configured for SharePoint integration. 表示できるレポートは、レポート定義 (.rdl) ファイルやレポート ビルダーのレポートなどです。Reports that you can display include report definition (.rdl) files and Report Builder reports. レポートは、新しいページのレポート ビューアー Web パーツに自動的に表示されます。Reports open in the Report Viewer web part in a new page automatically. また、既存の Web ページまたはサイトに常に特定のレポートを表示する必要がある場合は、レポート ビューアー Web パーツをそのページに追加することもできます。You can also add a Report Viewer web part to an existing web page or site if you want a particular report to be always visible on that page.

注意

Reporting ServicesReporting Services アドインによってインストールされるレポート ビューアー Web パーツと、RSWebParts.cab ファイルに含まれているレポート ビューアー Web パーツは、名前は同じでも異なるものです。Although they have identical names, the Report Viewer web part that is installed through the Reporting ServicesReporting Services Add-in is different from the Report Viewer web part that is included in the RSWebParts.cab file. このトピックでは、 Reporting ServicesReporting Services アドインを使用してインストールされるレポート ビューアー Web パーツを利用するための手順について説明します。The instructions in this topic are specifically for the Report Viewer web part that is installed through the Reporting ServicesReporting Services Add-in.

次の方法でレポート ビューアー Web パーツをカスタマイズできます。You can customize the Report Viewer web part in the following ways:

  • プロパティを設定して Web パーツの外観を変更する。Change the appearance of the web part by setting properties.

  • レポート ツール バーで使用できる対話型レポート機能を選択する。Choose which interactive reporting features are available on the report toolbar.

  • 使用できる表示領域を指定する。Specify which view areas are available. レポート ビューアー Web パーツには、レポート表示領域、パラメーター領域、および資格情報領域が含まれます。The Report Viewer web part has a report view area, a Parameters area, and a Credentials area.

他の種類のファイルがサポートされるようにレポート ビューアー Web パーツを拡張することはできません。また、レポート ツール バーをカスタム ツール バーに置き換えたり、既存のツール バーに新しい機能を追加することはできません。You cannot extend the Report Viewer web part to support different file types, and you cannot replace the report toolbar with a custom toolbar or add new functionality to the existing toolbar. 標準の機能をカスタマイズする必要がある場合には、カスタムの Web パーツを作成してください。If you require customization of the standard features, you should create a custom web part.

Web パーツのプロパティの設定Setting web part properties

Web パーツには、特定の機能の設定に使用されるカスタム プロパティが用意されています。A web part has custom properties that are used to configure specific functionality. また、すべての Web パーツに標準で用意されている共通プロパティもあります。A web part also has common properties that are standard for every web part.

既定のプロパティの変更Change default properties

レポート ビューアー Web パーツには、ライブラリまたはフォルダーからの要求に応じてレポートを開く場合に適している既定のプロパティがあります。The Report Viewer web part has default properties that are ideally suited for opening reports on demand from a library or folder. 既定では、利用可能なコントロールがすべてツール バーに表示されます。By default, all available controls are displayed on the toolbar. 高さと幅は、Web ページの使用可能な領域をすべて使用するように設定されます。Height and width are set to use all of the available space on the web page. 既定のプロパティを変更する場合は、 [サイトの設定] で Web パーツをカスタマイズできます。If you want to modify the default properties, you can customize the web part through Site Settings.

  1. [サイトの操作] メニューの [サイトの設定] をクリックします。On the Site Actions menu, click Site Settings.

  2. [ギャラリー] の [Web パーツ] をクリックします。Under Galleries, click web parts.

  3. ReportViewer.dwpをクリックします。Click ReportViewer.dwp.

  4. ツール ペインを開き、使用するプロパティを設定します。Open the tool pane and set the properties you want to use.

Web ページ上の埋め込みレポート ビューアーのカスタマイズCustomize an embedded Report Viewer in a web page

プロパティを設定することで、Web ページ内のレポート ビューアーを調整することができます。You can set properties to make the Report Viewer fit within a web page. レポート ビューアーが含まれているページと同じスタイルと色をレポート ビューアーにも使用できます。The report viewer can use the same style and colors as the page that contains it. ツール バー、ドキュメント マップ、およびパラメーター領域の一部または全体を非表示にすることで、割り当てられた領域内でレポートの表示領域を最大限に広げることができます。You can hide all or part of the toolbar, document map, and parameters area to maximize the report viewing area within the allocated space. 常にレポートでは、作成時に定義したスタイルを使用します。The report always uses the styles you defined for it when you created it. SharePoint ライブラリにパブリッシュした後に、レポートの外観をカスタマイズすることはできません。You can't customize report appearance after you publish it to a SharePoint library.

Web ページにレポート ビューアー Web パーツを埋め込む場合は、 [レポート URL] プロパティに特定のレポートを設定する必要があります。If you are embedding the Report Viewer web part in a web page, you should set the Report URL property to a specific report. この操作を行わないと、レポートへのリンクを求めるメッセージがレポート ビューアーに表示されます。If you do not, the Report Viewer will display instructions for linking to a report. このメッセージのカスタマイズや削除はできません。You cannot customize or remove the instructions.

レポート ビューアー Web パーツのカスタム プロパティCustom properties of the Report Viewer web part

カスタム プロパティを設定する際には、ページにレポート ビューアー Web パーツが埋め込まれている場合にのみ使用されるプロパティもあることに注意してください。When setting custom properties, be aware that some properties are used only when the Report Viewer web part is embedded in a page. [タイトル]、[高さ]、[幅]、[枠の種類]、[領域] などがその例です。Examples include Title, Height, Width, Chrome type, and Zone. その他のツール バーやパラメーターの設定などのプロパティは、レポート ビューアーがページ内に表示される場合にも、ページ全体にレポートが表示される場合にも使用されます。Other properties, such as Toolbar settings and Parameters settings, are used regardless of whether the Report Viewer appears within a page or opens a report in full-page mode.

次に、レポート ビューアー Web パーツのカスタム プロパティを示します。The custom properties of the Report Viewer web part are listed below.

プロパティProperty [説明]Description
レポートReport 現在の SharePoint サイトまたは同じ Web アプリケーションやファーム内のサイト上のレポートへの完全修飾パス。A fully-qualified path to a report that is on the current SharePoint site, or on a site within the same Web application or farm. 追加プロパティの設定で最良の結果を得るには、レポート URL を指定した後で [適用] をクリックしてください。For best results when setting additional properties, click Apply after you specify the report URL.
[ハイパーリンク ターゲット]Hyperlink Target 現在のドキュメント内のリンク対象コンテンツを表示するためのターゲット フレームを指定する標準 HTML。Standard HTML that specifies the target frame for displaying linked content within the current document. 外部 Web サイトへのハイパーリンクを含むレポートについて、現在のウィンドウ内の既存のレポートを対象ドキュメントに置き換えるか、対象ドキュメントを新しいブラウザー ウィンドウで開くかを指定できます。For reports that include hyperlinks to external Web sites, you can specify whether a target document replaces the existing report within the current window, or opens in a new browser window. 有効な値には、 _Top_Blank、および _Selfが含まれます。Valid values include _Top, _Blank, and _Self. _Top を指定すると、現在のウィンドウが使用されます。 _Blank を指定すると、新しいブラウザー ウィンドウにドキュメントが読み込まれます。 _Self を指定すると、現在のフレーム内にドキュメントが開きます。_Top uses the current window, _Blank loads the document in a new browser window, and _Self opens the document within the current frame. HTML の Target 属性では _Parent も有効な値ですが、ページに埋め込むレポート ビューアー Web パーツでは使用しないでください。Although _Parent is a valid value for the Target attribute in HTML, do not use it for a Report Viewer web part that is embedded in a page.
Web パーツのタイトルの自動生成Auto-Generate web part Title レポート ビューアー Web パーツの名前とレポートの名前をダッシュでつないで自動生成されたタイトル。A generated title that includes the name of the Report Viewer web part plus the name of the report, separated by a dash. レポートにタイトルがない場合は、レポート ファイルの名前が使用されます。If the report does not have a title, the report file name is used. ページに Web パーツを追加すると、このタイトルが表示されます。The title is visible when you add a web part to a page. このチェック ボックスがオンの場合、ページが更新されるたびにタイトルが生成されます。If this check box is selected, the title will be generated each time the page is refreshed.
Web パーツ タイトルの詳細リンクの自動生成Auto-Generate web part Title Detail Link Web パーツの上に表示されるハイパーリンクを生成します。A generated hyperlink that appears above the web part. このリンクをクリックすると、新しいページ全体にレポートが表示されます。You can click the link to open the report in a new page, in full-page mode.
[レポート ビルダー メニュー項目を表示する]Show report builder menu item レポート ビルダーを開く [アクション] メニュー オプションの表示と非表示を切り替えます。Shows or hides the Actions menu option to open Report Builder.
[サブスクリプション メニュー項目を表示する]Show subscription menu item レポートのサブスクリプションを作成する [アクション] メニュー オプションの表示と非表示を切り替えます。Shows or hides the Actions menu option to create a subscription for the report.
[印刷メニュー項目を表示する]Show print menu item レポートを印刷する [アクション] メニュー オプションの表示と非表示を切り替えます。Shows or hides the Actions menu option to print the report.
[エクスポート メニュー項目を表示する]Show export menu item レポートをエクスポートする [アクション] メニュー オプションの表示と非表示を切り替えます。Shows or hides the Actions menu option to export the report.
[[更新] ボタンを表示する]Show refresh button ツール バーの [更新] ボタンの表示と非表示を切り替えます。Shows or hides the refresh button on the toolbar.
[ページ ナビゲーション コントロールを表示する]Show page navigation controls ツール バーのレポートのナビゲーション ボタンの表示と非表示を切り替えます。Shows or hides the report navigation buttons on the toolbar. このオプションは、すべてのナビゲーション コントロールの表示を変更します。This option changes the visibility of all the navigation controls.
[[戻る] ボタンを表示する]Show back button ツール バーの [戻る] ボタンの表示と非表示を切り替えます。Shows or hides the back button on the toolbar.
[検索コントロールを表示する]Show find controls ツール バーの検索コントロールの表示と非表示を切り替えます。Shows or hides the find controls on the toolbar. ユーザーは検索コントロールを使用して、表示されたレポート内のテキストを検索できます。The find controls allow a user to search for text in the rendered report. このオプションは、すべての検索コントロールの表示を変更します。This option changes the visibility of all the find controls.
[ズーム コントロールを表示する]Show zoom control ツール バーのズーム コントロールの表示と非表示を切り替えます。Shows or hides the zoom control on the toolbar.
[ATOM フィードのボタンを表示する]Show ATOM feed button ツール バーの ATOM フィードのボタンの表示と非表示を切り替えます。Shows or hides the ATOM feed button on the toolbar.

HTML ビューアーのデータ フィードhtmlviewer_datafeed
[ツール バーの位置]ToolBar location レポート ビューアー内のツール バーの位置を決定します。Determines the location of the toolbar within the report viewer. 有効な値には、 TopBottomが含まれます。Valid values include Top and Bottom.
[プロンプト領域]Prompt area 有効な値には、 DisplayedCollapsed、および Hiddenが含まれます。Valid values include Displayed, Collapsed, and Hidden. Displayed を指定すると、パラメーター化された値が含まれ実行前にユーザー入力を必要とするレポートの場合に、パラメーター領域が表示されます。Displayed displays the Parameters area for reports that include parameterized values and that require user input before the report will run. すべてのレポート パラメーターが指定されており、パラメーター領域をユーザーに対して表示しない場合には、 Hidden を使用します。Use Hidden if all of the report parameters are specified and you do not want the parameters area to be visible to users.
[パラメーター領域の幅]Parameters Area Width 測定単位と値を選択できます。You can choose the measurement and value. 既定値は 200 ピクセルです。The default is 200 pixels. このプロパティの唯一の要件は、0 より大きい値を設定することです。The only requirement for this property is that it is greater than zero.
ドキュメント マップDocument Map レポートで定義するレポート ナビゲーション コントロールであり、1 回のクリック操作でレポート内の特定のセクションにアクセスするために使用されます。A report navigation control that is defined in the report and used to provide one-click access to specific sections of a report. このコントロールは HTML レポートで利用できます。It is available in HTML reports. ドキュメント マップは、レポート表示領域の横にある折りたたみ可能な領域に表示されます。The document map is displayed in a collapsible area next to the report viewing area. 有効な値には、 DisplayedCollapsed、および Hiddenが含まれます。Valid values include Displayed, Collapsed, and Hidden. レポートにドキュメント マップが定義されている場合、Web パーツのプロパティで [非表示] または [折りたたみ済み] が指定されていない限り、この領域は既定で展開されます。If a document map is defined for a report, the area is expanded by default unless marked as hidden or collapsed in the web part properties. ドキュメント マップが折りたたんだ状態で表示された場合は、矢印をクリックして領域を展開できます。If the document map is collapsed, you can click the arrow to expand it.
[ドキュメント マップ領域の幅]Document Map Area Width 測定単位と値を選択できます。You can choose the measurement and value. 既定値は 200 ピクセルです。The default is 200 pixels. このプロパティの唯一の要件は、0 より大きい値を設定することです。The only requirement for this property is that it is greater than zero.
[パラメーターの読み込み]Load Parameters レポートのパラメーターのプロパティを取得します。Retrieve parameter properties for the report. ただし、すべてのレポートにパラメーターが設定されているとは限りません。Not all reports have parameters. レポートにパラメーターがない場合は、値が返されません。If the report does not have parameters, no values will be returned. アップロードしたばかりのレポートにプロパティを設定しようとすると、データ ソース接続が削除されたというエラーが表示されることがあります。If you are setting properties for a report that you just uploaded, you might get an error indicating that the data source connection has been deleted. その場合、接続をリセットし、接続を指定した後でパラメーター プロパティを設定してください。If this occurs, reset the connection and then finish setting parameter properties after the connection is specified. 接続の設定方法の詳細については、「共有データ ソースを作成および管理する (Reporting Services の SharePoint 統合モード)」を参照してください。For more information about how to set the connection, see Create and Manage Shared Data Sources (Reporting Services in SharePoint Integrated Mode).

最良の結果を得るには、 [適用] をクリックした後で [パラメーターの読み込み] をクリックしてください。For best results, click Apply before clicking Load Parameters.

パラメーター プロパティを読み込んだ後、レポートのパラメーターのプロパティ ページで設定する場合と同じ方法でプロパティを設定できます。After you load parameter properties, you can set them the same way you would in the parameter property pages of the report. パラメーターの設定方法の詳細については、「パブリッシュ済みレポートのパラメーターを設定する方法 (Reporting Services の SharePoint 統合モード)」を参照してください。For more information about how to set parameters, see Set Parameters on a Published Report (Reporting Services in SharePoint Integrated Mode).

ツール バーのカスタマイズCustomizing the toolbar

ツール バーは、レポートの最上部 (タイトルの下) に水平方向に表示されます。The toolbar appears beneath the title and extends across the top of the report. ツール バーには、 [アクション] メニュー、ページ分割されたレポートのページ ナビゲーション、更新や拡大/縮小のコントロールが表示されます。The toolbar provides an Actions menu, page navigation for paginated reports, refresh, and zoom. このツール バーには、ドキュメント マップが設定されたレポート用のドキュメント マップ コントロールもあります。It includes a document map control for reports that have a document map. [アクション] メニューには、レポートのエクスポート、レポート内のテキストまたは数値の検索、レポートの印刷などのコマンドがあります。さらに、レポートをレポート ビルダーで開くコマンドもあります。The Actions menu includes commands for exporting the report, searching for text or numbers within a report, printing the report, and, opening the report in Report Builder.

新しいコマンドを [アクション] メニューに追加することはできませんが、ユーザーに表示されるオプションを変更してカスタマイズすることはできます。You cannot add new commands to the Actions menu but you can customize it by changing the options that are visible to users. ツール バーのボタンとコントロールの表示を変更するには、Web パーツの [ツール バー項目の表示] セクションのオプションを変更します。To change the visibility of toolbar buttons and controls, you change options in the ToolBar Items Visibility section of the web part. また、 [印刷] コマンドや特定のエクスポート形式をレポート サーバーで使用できないように設定することで、このような機能を削除することもできます。You can also remove the Print command or specific export formats by making these features unavailable on the report server. ページ ナビゲーション コントロールは、改ページが含まれているレポートで使用できます (改ページがない場合、レポートは可変長の単一ページになります)。Page navigation controls are available for reports that have page breaks; otherwise, the report is a single page of variable length. [更新] を実行すると、レポートの現在のパラメーターを使用してレポートが再処理されます。Refresh re-processes the report using the parameters that are current for the report. すべてのコントロールを 1 行で表示するには、Web パーツ全体の幅を 400 ピクセル以上に設定します。To display all the controls on one line, set the overall width of the web part to at least 400 pixels.

表示領域のカスタマイズCustomizing the viewing area

表示領域はレポートの表示に使用されます。The view area is used to display reports. レポートの表示領域の一部は、パラメーター領域と資格情報領域 (使用される場合) としても利用されます。The report view area is shared with the Parameters and Credentials area, if they are used. 資格情報が必要な場合、空のレポート表示領域の横に資格情報領域が表示されます。If credentials are required, the Credentials area is displayed next to an empty report view area. ユーザーが資格情報を入力してレポートを実行すると、資格情報領域は閉じます。The Credentials area closes after the user provides credentials and runs the report. ユーザーに資格情報の設定を求めるテキストをカスタマイズするには、データ ソース接続のプロパティを変更します。To customize the text that prompts users to set credentials, modify the data source connection properties. 詳細については、「共有データ ソースを作成および管理する (Reporting Services の SharePoint 統合モード)」を参照してください。For more information, see Create and Manage Shared Data Sources (Reporting Services in SharePoint Integrated Mode).

パラメーター領域には、レポートの実行前に値を入力するためのフィールドが用意されています。The Parameters area provides fields for entering values before running the report. この領域は、レポート定義にパラメーターが含まれている場合にのみ使用されます。It is only used when a report definition includes parameters. パラメーター領域または資格情報領域が表示されるときには、Web パーツの残りの幅に収まるようにレポート表示が調整されます。When either the Parameters or Credentials areas are displayed, the report view is adjusted to use the remaining width of the web part. Web パーツのプロパティを設定して、パラメーターの幅をカスタマイズできます。You can set properties on the web part to customize the width of Parameters. ページ上で個々のパラメーターの横に表示されるラベルも定義できます。You can also define the labels that appear next to individual parameters on the page. パラメーター ラベルの変更方法の詳細については、「パブリッシュ済みレポートのパラメーターを設定する方法 (Reporting Services の SharePoint 統合モード)」を参照してください。For more information about how to modify parameter labels, see Set Parameters on a Published Report (Reporting Services in SharePoint Integrated Mode).

参照See also

SharePoint サイトのレポート ビューアー Web パーツ Report Viewer web part on a SharePoint Site
レポート ビューアー Web パーツを Web ページに追加するAdd the Report Viewer web part to a web page

その他の質問More questions? Reporting Services のフォーラムに質問してみてくださいTry asking the Reporting Services forum