Upgrading from a Previous Version

Reports created in JReport Designer 7 or prior must be converted to Version 12 before they can be modified with JReport Designer 12. The conversion procedure is described below. However, JReport Version 7 or prior reports can continue to be published to, and run by JReport Server 12 without any modifications.

To upgrade Version 7.1 or prior reports to Version 12:

1. Be sure that JReport Designer 12 has been installed in a folder that does not contain any previous versions of JReport Designer. If it does, uninstall and reinstall to a new directory.
2. Convert a set of reports by either of following methods:
   • Run the conversion tool rptconv.bat/rptconv.sh which is located in <install_root>\bin.
   • Convert a report by opening it directly and then saving it with JReport Designer 12.

A Version 7 or prior report is converted to a flow layout report with a banded object. A banded object has the same report sections that a Version 7 or prior report template has, however in Version 12 the sections are called panels. Any other data objects in the Version 7 or prior report are converted to the corresponding data containers within the banded object.

All converted reports can be used in the same way as a new Version 12 report that contains a banded object. You can insert other components into the banded panels as described in Component placement. In addition, the features of Version 12, such as page mode, displays types, CSS styles and so on can be applied to the converted reports. However, in the converted reports, the layout cannot extend beyond the banded object as it can for a new report created in Version 12. That is, while you can insert components into the banded object created as a result of the migration, you cannot insert components after the banded object. If your reports require this functionality, you will need to re-create the report as a new report in Version 12.