Customizing the BIRT report viewer

The view settings for the BIRT report viewer in the Report Launcher for Rational® ClearQuest® web interface are determined by the generated URL for running and viewing reports. You can change the view settings by modifying the URL template in the Report Launcher for Rational ClearQuest configuration file.

About this task

This task requires updating the reportlauncher.properties configuration file. The configuration file is found in the directory where Rational ClearQuest web applications are deployed. If Rational ClearQuest is deployed in the WebSphere® profile, this is the default path for the configuration file:

On Windows®:: %CLEARQUEST_HOME%\cqweb\cqwebprofile.
On Unix: $CLEARQUEST_HOME/cqweb/cqwebprofile/

Where CLEARQUEST_HOME is the directory where Rational ClearQuest is installed.

Procedure

Edit the reportlauncher.properties configuration file.
In the file, locate the reports.launcher.birt.serverPath setting that defines the default URL template for starting the BIRT Report Viewer. Then, change the settings as needed.
For example, to suppress the display of the report viewer toolbar, change the toolbar=true setting to toolbar=false:
```
reports.launcher.birt.serverPath=/birt/frameset?__report=
%reportPath&__title=%title& __toolbar=false
```
For a description of other viewer settings, see http://www.eclipse.org/birt/phoenix/deploy/viewerUsage2.2.php.