Seitenhistorie
| Auszug | ||
|---|---|---|
| ||
Nuclos JasperReports Migration 6.17.0: Management Console, -migrateJasperReports, -patch, -forceAll, -removeDeprecatedPdfFonts, Fonts. |
Sprache: Deutsch · English
Migration zu JasperReports library 6.17.0
Alte Jasper-Reporte über die Management-Konsole auf die aktuelle Library-Version migrieren.
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
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
...
.
Voraussetzungen
Damit die Reporte später korrekt aussehen, muss sichergestellt werden, dass verwendete Fontextensions aktuell sind. Klicken Sie auf das Menü Konfiguration → Nuclet und überprüfen sie alle Nuclets, indem sie die jeweilige Detailansicht öffnen und dann unter Extensions nach veralteten Font Jars suchen. Erstellen sie über Jaspersoft Studio die Fonterweiterung neu. Tauschen Sie dann im Nuclet die alte Jar-Datei durch die Neue aus.
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
-migrateJasperReports
...
- wählen.
...
- Zuerst ohne Parameter
...
- ausführen – die Ausgabe zeigt, welche Reporte
...
- aktuell sind und welche
...
- migriert werden müssen.
...
- Dann mit
-patch -removeDeprecatedPdfFonts
...
- automatisch
...
- 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“). |
| Info | ||
|---|---|---|
| ||
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
ausführen möchten, müssen sie den Parameter -forceAll hinzufügen, um die Migration auch von aktuellen/neueren Reporte zu erzwingen.-patch: Führt eine Migration mit allen weiteren Parametern durch. Ohne diesen Parameter gibt der Befehl lediglich Informationen über die Reporte aus Nuclos zurück. -forceAll: Standardmäßig werden nur Reporte mit älterer Versionssignatur migriert. Setzt man diesen Parameter werden sämtliche Reporte aus Nuclos migriert. -removeDeprecatedPdfFonts: Entfernt während der Migration das veraltete Tag "pdfFont" aus der Report XML Datei. -overwriteReportFonts <"fontNameInQuotes">: Überschreibt bzw. setzt während der Migration alle FontNamen. Defaultfont, falls kein Font spezifiziert wird: "DejaVu Sans".
Mögliche Ausgaben des Befehls:
- Succesfully patched ...: Gibt die Anzahl der erfolgreich migrierten Reporte zurück und listet diese anschließend auf.
- Patching failed for ...: Gibt die Anzahl der Reporte zurück, welche nicht migriert werden konnten. Im Anschluss werden die Exceptions/Fehler aufgelistet, welche die Migration scheitern ließen.
- Found xy report(s) matching the current Jasper Version of Nuclos: Gibt die Anzahl und dann die Reporte zurück, welche nicht migriert werden müssen, da sie bereits mit der von Nuclos verwendeten Jasperversion übereinstimmen.
- Found xy report(s) with a newer version than used in Nuclos: Gibt die Anzahl und dann die Reporte zurück, welche eine neuere Version besitzen als in Nuclos verwendet wird. Falls solche Reporte vorhanden sind, sollten sie besonders sorgfältig überprüft werden, da in diesen Reporten eventuell Funktionen verwendet werden, welche von der Nuclos Jasper Version nicht unterstützt werden. Sie können diese Reporte auch über Jaspersoft Studio nochmals exportieren und als Kompatibilitätsversion
Parameterübersicht des Befehls
Überblick
Inhalte