JasperReports IO Repository File System

JasperReports IO uses a folder-based repository to store all the templates and resources used by the JasperReports IO reporting service. You can import the templates and resources into your Jaspersoft Studio project as a file system, which copies the files and recreates the repository directory structure in your project. You can then use Jaspersoft Studio to create and edit report templates and preview reports using the built-in JasperReports IO engine. You can export the repository when the reports are ready to use in production.

The built-in JasperReports IO preview engine only works for files located in your workspace. It is not available for previewing linked files outside your workspace.

JasperReports IO comes with sample reports and resources in its repository for you to use.

JasperReports IO Repository Directory Structure

When you import files from an existing JasperReports IO repository, Jaspersoft Studio recreates the directory structure of the repository in your workspace. If you want to create a workspace for a JasperReports IO project without importing an existing repository, you can structure the folders in your project to replicate the JasperReports IO repository.

The JasperReports IO repository is structured as follows:

Repository Directories




Contains the data source adapters and data source files for your reports. JasperReports IO supports the following types of data adapters:

JDBC connection
CSV connection
Excel connection
Empty connection
JNDI connection
Remote XML connection

You can create your own data adapters for JasperReports IO either by using the DataAdapter Wizard or by creating a custom data adapter using an XML file. See Creating and Editing Data Adapters for more information.


Contains image files used in reports.

JR-INF Contains the configuration files for report execution. See JasperReports IO Report Execution Contexts for information on creating the files.
reports Contains report templates.