Previewing Reports in the HTML Viewer (Report Builder 2.0)

Report Builder 2.0 uses the HTML Viewer to preview reports. Report Manager uses the HTML Viewer to display reports on demand as they are requested from the report server. The 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. In Run mode in Report Builder 2.0, the report toolbar is called the Run tab.

Note

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 "Setting Parameter Properties for a Published Report" in the Reporting Services documentation in SQL Server Books Online.

Report Toolbar in Report Manager (Run tab in Report Builder 2.0)

The report toolbar provides page navigation, zoom, refresh, search, export, and print 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 Printing Reports (Report Builder 2.0).

The report toolbar in Report Manager 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 Run tab in Report Builder 2.0 looks different, but offers the same functionality.

Report toolbar

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

Control

To

Page navigation controls

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

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 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

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

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

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 and hide icons

Show or hide parameter value fields and the View Report button in a report that includes parameters.

Browser refresh button on report toolbar

Report refresh icon

Refresh the report. Data for live reports will be refreshed. Cached reports will be reloaded from where they are stored.

About Export Formats

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.

Export format

Description

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.

Acrobat (PDF) file

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.

Excel

View the report in Microsoft Excel.

Web archive (MHTML)

View the report in an MIME-encoded HTML format that keeps images and linked content together with a report.

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.

Parameters

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 administrator.

Credentials

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.

A report can contain multiple data sources. Each data sources has a set of credentials. The report author specifies the type of credentials to use for a data source that is used only in this report (an embedded data source). For a shared data source that is published and managed on a report server, the system administrator or owner of the data source specifies the type of credentials to use. For more information, see Working with Embedded and Shared Data Sources (Report Builder 2.0) and Specifying Credentials for a Report Data Source (Report Builder 2.0).