Welcome
Reporting
Learn how to generate reports for the product.
Reporting deployment planning
Rational® ClearQuest® lets you customize your deployment to support data-pull reports with BIRT reporting tools.
About the Report Launcher for Rational® ClearQuest®
The Report Launcher for Rational® ClearQuest® is a web application for running data-pull reports that are saved on a server file system.
Deploying the BIRT server runtime on the WebSphere® Application Server
Before you can run BIRT reports from the Report Launcher for Rational® ClearQuest®, you must install and configure the BIRT server runtime on the WebSphere® Application Server.
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.

IBM ClearQuest 10.0.9
Overview
Learn general information about the product.
Installing
Learn how to install the product.
Upgrading and migrating
Learn how to upgrade and migrate data for the product.
Administering
Learn how to administer the product.
Reporting
Learn how to generate reports for the product.
- Reporting on Rational® ClearQuest® data sources
  Rational® ClearQuest® provides a flexible reporting solution to design and test reports with Business Intelligence and Reporting Tools (BIRT) and SAP Crystal reports that are configured with the ClearQuest Reporting Driver. Users can share ClearQuest reports with the Report Launcher for ClearQuest or access reports from Rational Team Concert to facilitate Agile planning.
- Reporting deployment planning
  Rational® ClearQuest® lets you customize your deployment to support data-pull reports with BIRT reporting tools.
  - Scenarios for planning your reporting deployment
    This topic presents several scenarios that can help you decide which reporting configuration is best for your environment.
  - About the Rational® ClearQuest® Reporting Driver
    The Rational® ClearQuest® Reporting Driver provides ClearQuest authenticated access to ClearQuest data sources to design and run data-pull reports.
  - About the Rational® ClearQuest® Report Server for Crystal Reports
    Use the Rational® ClearQuest® Report Server for Crystal Reports to run data-pull reports on the ClearQuest Web server. Use the Report Launcher for Rational ClearQuest to provide access to reports on a shared file server.
  - About the Report Launcher for Rational® ClearQuest®
    The Report Launcher for Rational® ClearQuest® is a web application for running data-pull reports that are saved on a server file system.
    - Deploying the Report Launcher for Rational® ClearQuest®
      Deploying Report Launcher for Rational® ClearQuest® for use with WebSphere® Application Server requires installing and configuring the Report Launcher for Rational ClearQuest component. You must also deploy the server runtime for the selected reporting tool on the WebSphere Application Server.
    - Deploying the BIRT server runtime on the WebSphere® Application Server
      Before you can run BIRT reports from the Report Launcher for Rational® ClearQuest®, you must install and configure the BIRT server runtime on the WebSphere® Application Server.
      - Installing BIRT web archive on WebSphere® Application Server
        This topic describes how to install the BIRT web archive on the WebSphere® Application Server.
      - Configuring the BIRT web archive on the WebSphere® Application Server
        This topic describes how to configure the BIRT web archive on the WebSphere® Application Server.
      - Configuring the BIRT runtime for Rational® ClearQuest® reporting
        This topic explains how to configure the BIRT Report Viewer with the Rational® ClearQuest® Reporting Driver for running ClearQuest reports. The required files for the Rational ClearQuest Reporting Driver are in the reports folder in the ClearQuest home directory.
      - Verifying the BIRT deployment
        After installing and configuring BIRT to use the Rational® ClearQuest® Reporting Driver, verify the BIRT deployment and check the installed version.
      - 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.
    - Configuring security for the Report Launcher and reports
      Rational® ClearQuest® provides security features that can be configured to protect access to the Report Launcher for ClearQuest and access to the reports themselves. Use the information in this topic to learn about and configure the network, client, and data security for the Rational ClearQuest reporting environment.
    - Using the Report Launcher
      Use the Report Launcher for Rational® ClearQuest® to manage and run reports that are designed with BIRT reporting tools and stored on a shared file server. Authorized users can select reports from the Report Launcher navigation window and view the generated data in the Report Launcher view window.
Developing
Learn how to develop schemas by using the Rational® ClearQuest® Designer.
Managing change and releases
Learn how to manage change and release in the product.
Integrating
You can integrate Rational® ClearQuest® with other software by adding packages to existing schema.
Extending product function
Learn how to extend the product.
Reference
Review reference information for the product.
Tutorials

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 https://eclipse-birt.github.io/birt-website/docs/integrating/viewer-usage/.
Edit the reportlauncher.properties configuration file to pass credentials to BIRT reports at run time and to clear user and password settings.