How to design and compile an existing IG v14 custom report to use in IG v15

Products

• CA Identity Manager

Issue/Introduction

This article provides instructions for importing, designing, and compiling existing 14.x custom reports for Identity Governance (IG) 15.x using Jaspersoft Studio 7.

Environment

IGA Xpress 1.0
IGA Suite v15

Resolution

Locate the Existing JRXML File

Follow these steps to find the JRXML files for your custom reports:

1. Log in to the JasperReports Server.
2. Export the IG folder from the Repository and extract the zip file. The extracted folder contains the main JRXML and dependent resources.
3. Navigate to <IG_extracted_folder>\resources\organizations\IG\IG\reports.
4. Every report in this folder has a corresponding XML configuration file (e.g., Users_Overview.xml) that includes information about the JRXML files and resources like images, language bundles, and style templates.
5. Open the corresponding XML file for the report to identify the paths of the main JRXML file and dependent resources.

Design and Configure the Report

Ensure the following configurations are met within the report design:

• Naming: The internal report name and the report file name (.jrxml or .jasper) must be identical.
• Image References: References in the JRXML should use the name alone (e.g., image1.png). Remove any prefixes like repo: (e.g., change repo:image1.png to image1.png).
• Font Selection: The reporting framework defaults to the DejaVu open-source font family. If you use a different font, ensure it is installed on the machine hosting Identity Governance.
• Commercial Elements: Replace any commercial elements (e.g., commercial charts) with corresponding free/open-source elements.

Compile the Report

1. Locate the .data file within Jaspersoft Studio.
2. Rename the file extension from .data to .jrxml.
3. In the Project Explorer view, right-click the renamed .jrxml file.
4. Select JasperReports > Compile Report from the context menu.
5. Verify that a compiled .jasper file appears in the project directory alongside your .jrxml file.

Deploy the Report

1. Create the following directory if it does not already exist: /opt/brcm/iga/conf/idg/reports/resources.
2. Place the compiled .jasper file and all associated resources (images, language bundles) into this /resources folder.

Note: Always compile and test the report in Jaspersoft Studio to ensure it is error-free before configuring it within the IGA reporting framework.