Configuring the Eclipse IDE for Java and Report Developers with HCL Compass

Compass supports the Business Intelligence and Reporting Tools (BIRT) v4.x.

About this task

Note: The HCL Compass Reporting Driver BIRT 4.x requires the Oracle Java™ Runtime Environment (JRE).

HCL Compass supports the following:

BIRT Reporting Engine: The deployment of BIRT Reporting Engine (BIRT Runtime) did not change and to deploy it, use the HCL Compass deployBIRT script that is found in <CQ_Home>/reports/launcher/birt/. The BIRT Reporting Engine can be found and downloaded from BIRT's official download website at: http://download.eclipse.org/birt/downloads/.

BIRT RCP Report Designer: Starting with BIRT v4.x, the BIRT RCP Report Designer is no longer recommended as the tool to use for designing BIRT reports. The BIRT v4.x RCP Report Designer is no longer available as 64-bit. The 64-bit is required to use the CQJNI database connection profiles to HCL Compass for your reports. Also, the BIRT v4.x RCP Report Designer is no longer available on Linux™.
The alternative is to use the Eclipse IDE for Java and Report Developers, which can be downloaded from http://www.eclipse.org/downloads/packages/.

Note: HCL Compass strongly recommends the use of the Eclipse IDE for Java and Report Developers in place of BIRT RCP Report Designer.

To use the Eclipse IDE for Java and Report Developers with HCL Compass to design Compass reports, follow those steps:

Download Eclipse IDE for Java and Report Developers from http://www.eclipse.org/downloads/packages/, and extract the compressed file into a directory such as C:\BIRT_for_CQ .
Copy the HCL Compass JDBC driver for BIRT from the directory <CQ_HOME>/reports/launcher/birt/ to C:\BIRT_for_CQ\\dropins\ directory, or on UNIX™ to /opt/BIRT_for_CQ/\dropins/.
Edit the file C:\BIRT_for_CQ\eclipse.ini and add the following two lines to the top of the file:
For Windows™
```
 -vm
        <32bit_ORACLE_JRE>/jre/bin/javaw.exe
```
For UNIX

Note:
The ORACLE_JRE is the path where you extracted the Oracle JRE.
Start Eclipse to open existing reports, or create new ones.