| Auszug |
|---|
|
Nuclos JasperReports migration 6.17.0: management console, -migrateJasperReports, -patch, -forceAll, -removeDeprecatedPdfFonts, fonts. |
Language: Deutsch · English
Migrating to JasperReports library 6.17.0
Migrate old Jasper reports to the current library version via the management console.
| Status |
|---|
| colour | Blue |
|---|
| title | Administrator |
|---|
|
| Status |
|---|
| colour | Green |
|---|
| title | Updated: Jul 2026 |
|---|
|
| Status |
|---|
| colour | Grey |
|---|
| title | applies to Nuclos 4.2026.x |
|---|
|
When to migrate?
This guide assumes a switch to Nuclos ≥ 4.50. Old Jasper reports in the database can be adapted to the current Jasper version via the management console – ideally automatically. This fixes warnings but is not mandatory: if your reports look as usual and there are no warnings in the log, you may keep them in the old version.
Prerequisite: update fonts
Under Configuration → Nuclet, check the Extensions of each nuclet for outdated font JARs. Recreate the font extension in Jaspersoft Studio and replace the old JAR in the nuclet.
Migration via the management console
- Open Administration → Management Console….
- Choose the command
-migrateJasperReports. - Run it without parameters first – the output shows which reports are current and which need migrating.
- Then migrate automatically with
-patch -removeDeprecatedPdfFonts. - To migrate again with other parameters, add
-forceAll.
Parameters
| Parameter | Effect |
|---|
| -patch | performs the migration (without: information only). |
| -forceAll | migrates all reports, not just older ones. |
| -removeDeprecatedPdfFonts | removes the deprecated „pdfFont“ tag. |
| -overwriteReportFonts "<font>" | sets all font names (default: „DejaVu Sans“). |
| Info |
|---|
|
Outputs include: Successfully patched …, Patching failed for …, Found … report(s) matching/with a newer version. Check reports with a newer version particularly carefully. |
Related pages
Working with Jasper Studio
Overview.
Open →
Jasper extensions in Nuclos
Extensions.
Open →
