Diese Anleitung setzt voraus, dass Sie erfolgreich zu einer Nuclos Version >= 4.50 gewechselt haben. Sollten Sie in Ihrer Datenbank noch alte Jasper Reporte haben, erfahren Sie an dieser Stelle, wie Sie diese über die Management Konsole - im besten Fall völlig automatisiert - aktualisieren können. Die Migration über die Management Konsole passt die Reporte an die aktuelle Jasper Version von Nuclos an und kann damit Warnungen beheben. Sie ist aber nicht zwangsweise bei allen Reporte älterer Versionen notwendig. Falls Ihre Reporte wie gewohnt aussehen und kein Warnungen im Nuclos Log zu finden sind, können Sie die Reporte auch in der alten Version belassen und auf eine Migration verzichten.



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.


Wenn alle Jars, welche Fonts für JasperReports bereitstellen, aktualisiert wurden, kann die Migration über die Management Konsole durchgeführt werden.


Migration über die Management Konsole

  1. Öffnen Sie die Management Konsole über Administration → "Management Console...".
  2. Wählen Sie den Befehl -migrateJasperReports aus.
  3. Führen Sie den Befehl zuerst ohne Parameter aus. In der Ausgabe bekommen Sie Informationen darüber, welche Reporte bereits aktuell sind und welche erst noch migriert werden müssen.
  4. Führen Sie den Befehl nun mit den Parametern -patch -removeDeprecatedPdfFonts aus, um die Reporte automatisch zu migrieren.
  5. Falls Sie die Migration nochmals mit anderen Parametern ausführen möchten, müssen sie den Parameter -forceAll hinzufügen, um die Migration auch von aktuellen/neueren Reporte zu erzwingen.


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

  • -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".
  • Keine Stichwörter