Overview

Use the ReportPageViewer component to create a web page that displays a Crystal report. The ReportPageViewer component renders the report in DHTML and provides a toolbar that enables the user to navigate the report. You can customize the appearance and behavior of the ReportPageViewer component by setting its attributes.

For example, you can configure the ReportPageViewer component to display a Crystal report that requires additional user input, logs the user into the database using a specific username and password, and has a customized appearance.

To display a report using the ReportPageViewer component, you must specify a report source. A report source is an object used by the ReportPageViewer component to access the properties of a report. It provides the ReportPageViewer component with the means to query for report data, page information, and other internal report information. Report sources are obtained from report servers, such as the Page Server, RAS, and the Java Reporting Component. Once you have obtained a report source, you assign the report source to the ReportPageViewer component by setting the reportSource attribute.

If the report contains parameters, by default the ReportPageViewer component prompts the user to enter parameter information. You can configure the ReportPageViewer component to use pre-defined parameters by setting the parameterFields attribute. You can then disable parameter prompting by setting the allowParameterPrompting attribute to false.

If the report needs database logon information to retrieve data, by default the ReportPageViewer component prompts the user to enter database logon information. You can configure the ReportPageViewer component to use a pre-defined database logon by setting the databaseLogonInfos attribute and by setting the allowDatabaseLogonPrompting attribute to false.

You can customize the appearance of the ReportPageViewer component by setting various attributes. Some commonly used attributes include the following:

• displayGroupTree attribute

The Group Tree is a tree style view of the report structure. It appears on the left portion of the ReportPageViewer component and is used to quickly navigate the report. By default, the ReportPageViewer component displays the Group Tree; to disable rendering of the Group Tree, set the displayGroupTree attribute to false.

• displayToolbar attribute

The Toolbar is the main method of report navigation. It includes buttons to export, search, and page through the report. By default, the ReportPageViewer component displays the Toolbar. You can disable rendering of the Toolbar or specific components of the Toolbar, by setting the displayToolbar attribute or related attributes to false. For example, to display the Toolbar but disable exporting, set the displayToolbarExportButton to false.

Data Binding

The ReportPageViewer component supports data binding to an EnterpriseItem bean. This bean provides the source for a report through its reportSource property, so that the report can be rendered by the ReportPage Viewer. Use the reportSource attribute to bind the component to the desired report source.