RDL Report Viewer

<< Click to Display Table of Contents >>

Navigation:  Professional > Reports > RDL Reports >

RDL Report Viewer

Report Mode

File Mode


This form allows for interaction with RDL reports via Microsoft's WinForms ReportViewer control.




The toolbar displayed in the widget is part of the ReportViewer control and provides functionality such as the following.

Paging: First, Previous, Go to (type in any page number and press <ENTER>), Next, Last
The toolbar may show a question mark next to the total number of pages. This is because pages are rendered as needed, so the control may not initially know the total number of pages. To compute the exact number of pages, click Last to skip to the last page.

Refreshing: Click Refresh to refresh the report (see following sections for further explanation on refreshing a report),

Printing: Click Print to print the report. Click Print Layout to toggle print layout view in the control. Click Page Setup to edit page settings before printing.

Exporting: Click Save to export the report to Microsoft Excel, Word or PDF.

Zooming: Click the Zoom drop-down to choose the scale at which the report will be displayed.

Searching: Enter search terms and click Find or Next.


This form is used in two modes, Report Mode and File Mode, depending on the source of the underlying RDL report.


Report Mode


An RDL Report published to the database or an *.rdl saved to the facility's work folder uses Report mode. When an RDL Report is selected in the report chooser, the form will first show the parameters for the underlying grid1 report(s). If the RDL Report contains multiple datasets, the union of all input parameters for all underlying grid reports appears.


Select the desired input parameters (or a saved User Report), and click Go. The ReportViewer control then appears, with the RDL Report rendered, based on the data from the underlying grid report(s).


In report mode, Refresh will hide the ReportViewer control and display the input parameters. Select different input parameters and click Go. The ReportViewer control will appear again with the updated data based on the latest input parameters.


File Mode


File mode is used when a RDL has not been published to the database, but is being used to view data from a grid report that is already open in the workspace. In File mode, hovering the mouse over the RDL RDL-To do bar-WF(16) button shows the path to the *.rdl file currently open in the viewer. Click this button, and EQuIS Professional will launch the *.rdl file in the associated RDL editing application2 installed.


In File mode, Refresh will re-render the report with the same grid data originally used, based on any changes that have been made to the *.rdl file using a third-party editing application. The editing application and EQuIS Professional can both be kept open while iteratively editing the report (i.e. in the editing application). Click Refresh to view the report.


1 The dataset(s) within a RDL Report must be EQuIS grid report(s) (e.g. Analytical Results II). A grid EQuIS report is any report that produces a table/grid.

2 Editing *.rdl files requires a third-party editing application (e.g. Microsoft® Report Builder 15 [2021]) that needs to be installed separately on the computer.