HTML Viewer and the Report Toolbar
Applies To: SQL Server 2016
SQL Server Reporting Services provides an HTML Viewer that is used to display reports on demand as they are requested from the report server. HTML Viewer provides a framework for viewing reports in HTML. It includes a report toolbar, a parameter section, a credentials section, and a document map. The report toolbar in HTML Viewer includes features you can use to work with your report, including export options so that you can view your report in formats other than HTML. The parameter section and document map appear only when you open reports that are configured to use parameters and a document map control.
Although you cannot modify the report toolbar, you can configure parameters on a report URL to hide it on a report. For more information about hiding the report toolbar, see URL Access Parameter Reference.
The report toolbar provides page navigation, zoom, refresh, search, export, print, and data feed functionality for reports that are rendered in the HTML rendering extension.
Print functionality is optional. When it is available, a Printer icon appears on the report toolbar. On first use, clicking the Printer icon downloads an ActiveX control that you must install. Once the control is installed, clicking the Printer icon opens a Print dialog box so that you can select from the printers that are configured for your computer. Print availability is determined by server settings and browser settings. For more information, see Print Reports from a Browser with the Print Control (Report Builder and SSRS) and Enable and Disable Client-Side Printing for Reporting Services.
The report toolbar is similar to the one shown in the following illustration. The report toolbar that you see may differ from the illustration based on report features or the rendering options that are available.
The following table describes commonly used features of the report toolbar. Each feature is identified by the control that you use to access it.
|Use this icon or control||To|
|Page navigation controls||Open the first or last page of a report, scroll through a report page by page, and open a specific page in a report. To view a specific page, type the page number and press ENTER.|
|Page display controls||Enlarge or reduce the size of the report page. In addition to percentage-based changes, you can select Page Width to fit the horizontal length of a report page in the browser window, or Whole Page to fit the vertical length of a report in the browser window. A Zoom option is supported by Microsoft Internet Explorer 5.5 and later.|
|Search field||Search for content in the report by typing a word or phrase that you want to find (the maximum value length is 256 characters). The search is case-insensitive and starts at the page or section that is currently selected. Only visible content is included in a search operation. To search for subsequent occurrences of the same value, click Next.|
|Export formats||Open a new browser window and render the report in the selected format. The formats that are available are determined by the rendering extensions that are installed on the report server. TIFF is recommended for printing. Click Export to view the report in the selected format.|
|Document map icon||Show or hide the document map pane in a report that includes a document map. A document map is a report navigation control similar to the navigation pane on a Web site. You can click on items in the document map to navigate to a specific group, page, or subreport.|
|Printer icon||Open a Print dialog box so that you can specify print options and print a report. On first use, clicking this icon prompts you to download the print control.|
|Show and hide icons||Show or hide parameter value fields and the View Report button in a report that includes parameters.|
|Report refresh icon||Refresh the report. Data for live reports will be refreshed. Cached reports will be reloaded from where they are stored.|
|Data feed icon||Generated data feeds from reports.|
|Pin to Power BI Dashboard||Pin support report items to a Power BI. If the button is not visible, the report server has not been integrated with Power BI. For more information, see Power BI Report Server Integration (Configuration Manager).|
From the report toolbar, you can select to view your report in a variety of formats. The formats that are available are determined by the rendering extensions that are installed on the report server. When you select another format, a second browser window is used to display the report, using a viewer associated with the export format you selected. If a viewer is not available for the format you select, you can select a different format.
The following export formats are included in a default report server installation. The list of export formats available to you may vary from those listed here.
|XML||View a report in XML syntax. Reports viewed in XML open in a new browser window.|
|CSV||View a report in a comma-delimited format. The report opens in an application that is associated with the CSV file type.|
|View a report using a client-side PDF viewer. You must have third-party PDF viewer (for example, Adobe Acrobat Reader) to use this format.|
|MHTML||View the report in an MIME-encoded HTML format that keeps images and linked content together with a report.|
|Excel||View the report in Microsoft Excel, an .xlsx file.|
|PowerPoint||View the report in Microsoft PowerPoint, a .pptx file.|
|TIFF file||View the report in the default TIFF viewer. For some Microsoft Windows clients, this is the Windows Picture and Fax Viewer. Select this format to a view a report in a page-oriented layout.|
|Word||View the report in Microsoft Word, a .docx file.|
Parameters are values that are used to select specific data (specifically, they are used to complete a query that selects the data for your report, or to filter the result set). Parameters that are commonly used in reports include dates, names, and IDs. When you specify a value for a parameter, the report contains only the data that matches the value; for example, employee data based on an Employee ID parameter. Parameters correspond to fields on the report. After you specify a parameter, click View Report to get the data.
The report author defines the parameter values that are valid for each report. A report administrator can also set parameter values. To find out which parameter values are valid for your report, ask your report designer or administrator.
Credentials are user name and password values that grant access to a data source. After you specify your credentials, click View Report to get the data. If a report requires you to log on, the data that you are authorized to see might differ from the data that another user sees. Consequently, two users can run the same report and get different results. In addition, some reports contain hidden areas that are revealed based on user logon credentials or selections made in the report itself. Hidden areas in the report are excluded from search operations, producing different search results than when all parts of the report are visible.