How to Import and Export Report Templates

 

Overview

Report templates are distributed as .zip archive files.

Importing brings a template into a Jaspersoft Studio project for editing.

Exporting packages a finished template into a .zip file ready for upload to Risk Controller.

 

Import a Report Template

1. In Jaspersoft Studio, right-click the project folder in Project Explorer and select New > Folder.
2. Name the subfolder to reflect the report (e.g. Risk Detail) and click Finish.
3. Right-click the new subfolder and select Import to open the Import wizard.
4. Expand General, select Archive File, and click Next.
5. Click Browse and navigate to the .zip file — from \Report Design\Examples on the installation media or downloaded from Risk Controller.
6. In the left panel, confirm the folder is ticked. In the right panel, confirm all components are ticked, including subreports and image files.
7. Confirm the Into folder field shows the correct subfolder.
8. Click Finish. The report components appear in the subfolder.

Notes:

• Always take a copy of a shipped template before modifying it. This preserves the original as a reference.
• If a template was developed on a different machine, the Data Adapter may point to another user's adapter. Update it to the locally configured predict-da adapter before previewing.

 

Export a Report Template

1. In Project Explorer, right-click each .jrxml file in the report subfolder and select Compile Report.
2. For reports with subreports:
   1. Click the subreport element in the main report canvas.
   2. In the Properties panel, remove any folder path from the Expression field, leaving only the .jasper filename
      1. e.g. ActionsSubReport.jasper
3. Select File > Export to open the Export wizard.
4. Expand General, select Archive File, and click Next.
5. In the left panel, tick the report subfolder to select all components.
6. Untick any components in draft state.
7. Click Browse next to To archive file, choose a save location, and enter a filename.
8. Confirm Save in zip format and Create directory structure for files are both selected.
9. Click Finish.

Note:

• Every .jrxml file must have a corresponding compiled .jasper file in the export package.
• Risk Controller cannot compile all Jaspersoft functions.
• Reports uploaded without the .jasper file will fail at runtime.

 

Troubleshooting

• Report components not visible in the right panel:
  • The .zip structure may not match what the Import wizard expects. Re-download or re-package the file and try again.
• Subreport not found error in Risk Controller:
  • The Expression field still contains a full file path. Remove it, leaving only the .jasper filename.
• Report fails after upload due to missing .jasper file:
  • Right-click the .jrxml in Project Explorer, select Compile Report, then re-export.