Manual for iReport 0.2.0 and above

2 Installing iReport
2.1 System Requirements
2.2 Installation and configuration
2.3 The Final Test...

2 Installing iReport

iReport comes as a zip archive. It contains the main distribution files (classes and source), some templates for wizards, and all additional required jars.

2.1 System Requirements

You'll need several things to get started with iReport:

• Sun JDK 1.4 or greater
• Ant (required if you want recompile sources, but strongly reccomended to lunch iReport too)
• JasperReports 0.4.6 (*)
• SAX 2.0 XML Parser (Apache Xerces 1.3 or later recommended) (*)
• Jakarta Commons Digester Component (version 1.1 or later) (*)
• Jakarta Commons BeanUtils Component (version 1.1 or later) (*)
• Jakarta Commons Collections Component (version 1.0 or later) (*)
• Jakarta Commons Logging Component (version 1.0 or later) (*)
• JDBC 2.0 Driver (A MySql driver is already included) (*)
• iText - Free Java-PDF library by Bruno Lowagie and Paulo Soares (*)
• Jakarta POI (version 1.5.1 or later) (*)
• JFreeChart (version 0.9.8 or later) (*)
• Acrobat Reader 5.0 is not required, but strongly recommended.
• If you think to use Chinese Simplified, Chinese traditional, Japanese and Korean characters, you must download the Asian font pack from Adobe at: http://www.adobe.com/products/acrobat/acrrasianfontpack.html or use a localized Windows.
• If you want connect to a database, you must provide a JDBC driver (not shipped with iReport).

(*) a jar of this software is already included in the lib directory of iReport distribution, so you have not to download it.

Note that for now, JFreeChart is used to generate charts. This may change. I'm evaluating JCharts, another OpenSource charting library. It's possible that in the future, iReport will support both these libraries through an abstract layer.

Libraries' versions can change for different versions of iReport: i.e. iReport 0.3.1 comes with JasperReports 0.5.3.

2.2 Installation and configuration

If you have already installed a jdk on your machine (not simply a Java Runtime Enviroment, but a Java Development Kit), we are ready to start...

1. Unzip iReport-x.x.x.zip and copy the extracted directory where you want. 2. Look for a file called tools.jar in your jdk and copy it in the lib directory of iReport. 3.Start iReport.bat or iReport.sh.

At the first execution, iReport will create a directory (.ireport) in your home directory. Here will be stored all configuration files. iReport use XML files for configuration.

***This files are not compatible with old 0.1.0 properties files***

1. go to menu->Tools->Options 2. go to tab external programs 3. set external viewers programs

Fig.2.1: The external programs options tab.

2.3 Final test...

Ok, check the configuration....
Create a new blank report. Click on the iReport "Run without connection" button.
After a few seconds, our pdf will appear opened with the program that we have set, as a signal that all is OK.

< Back to the TOC