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

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

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.

Procedure

Navigate to the following URL:

http://server_host:port/birt/index.jsp

Where port is the port defined in the profile used to deploy the application. The default Rational® ClearQuest® profile uses port 12080. The default WebSphere® Application Server profile uses port 9080.

Results

If BIRT has been deployed successfully, a message displays in the browser confirming that the BIRT viewer has been installed. The message includes version information for the installation.