Sprache: Deutsch · English
Migration zu JasperReports library 6.17.0
Alte Jasper-Reporte über die Management-Konsole auf die aktuelle Library-Version migrieren.
HOW-TO ADMINISTRATOR STAND: JUL 2026 GILT FUER NUCLOS 4.2026.X
Auf dieser Seite
Wann migrieren?
Diese Anleitung setzt einen Wechsel auf Nuclos ≥ 4.50 voraus. Alte Jasper-Reporte in der Datenbank lassen sich über die Management-Konsole – idealerweise automatisiert – an die aktuelle Jasper-Version anpassen. Das behebt Warnungen, ist aber nicht zwingend: Sehen deine Reporte wie gewohnt aus und gibt es keine Warnungen im Log, kannst du sie in der alten Version belassen.
Voraussetzung: Fonts aktualisieren
Prüfe unter Konfiguration → Nuclet je Nuclet die Extensions auf veraltete Font-JARs. Erstelle die Fonterweiterung in Jaspersoft Studio neu und tausche die alte JAR im Nuclet aus.
Migration über die Management-Konsole
- Administration → Management Console… öffnen.
- Befehl
-migrateJasperReportswählen. - Zuerst ohne Parameter ausführen – die Ausgabe zeigt, welche Reporte aktuell sind und welche migriert werden müssen.
- Dann mit
-patch -removeDeprecatedPdfFontsautomatisch migrieren. - Erneute Migration mit anderen Parametern: zusätzlich
-forceAll.
Parameter
| Parameter | Wirkung |
|---|---|
| -patch | führt die Migration durch (ohne: nur Informationen). |
| -forceAll | migriert alle Reporte, nicht nur ältere. |
| -removeDeprecatedPdfFonts | entfernt das veraltete Tag „pdfFont“. |
| -overwriteReportFonts "<Font>" | setzt alle Font-Namen (Default: „DejaVu Sans“). |
Ausgaben
Ausgaben u.a.: Successfully patched …, Patching failed for …, Found … report(s) matching/with a newer version. Reporte mit neuerer Version besonders sorgfältig prüfen.
Verwandte Seiten
Überblick
Inhalte