Sprache: Deutsch · English
Jasper Extensions in Nuclos
Fonts, Scriptlets, Barcode-/QR-Bibliotheken als serverseitige Extensions einbinden und im Jasper-Classpath registrieren.
HOW-TO ANWENDUNGSENTWICKLER STAND: JUL 2026 GILT FUER NUCLOS 4.2026.X
Auf dieser Seite
Was sind Jasper-Extensions?
Immer wenn du deinem Jasper-Report eine Extension hinzufügst – z.B. ein Font-Paket, eine Scriptlet-Bibliothek, einen Barcode-Generator oder ZXing für QR-Codes – musst du diese serverseitige Extension auch in Nuclos einbinden, damit der Report ausgeführt werden kann.
1. Extension installieren
Variante A – über ein Nuclet: Konfiguration → Nuclets, das Nuclet wählen, im Tab Extensions die JAR hinzufügen und Server Extension? ankreuzen.
Variante B – im Serververzeichnis: im Nuclos-Instanzverzeichnis einen Ordner extensions/server anlegen, die JARs dort ablegen und zusätzlich unter webapp/WEB-INF/lib im Tomcat.
2. Extension im Classpath registrieren
Damit die JasperReports-Komponente die Extension nutzt, wird sie über den Parameter Administration → Parameter registriert:
- Parametername:
nuclos.jasper.reports.compile.classpath.jars.byclasses - Beschreibung: frei wählbar.
- Wert: je Extension eine Klasse inkl. Package-Pfad, getrennt durch Leerzeichen oder Zeilenumbruch.
Pflichtwerte
Diese beiden Pflichtwerte müssen immer enthalten sein, sonst funktioniert das Reporting nicht:net.sf.jasperreports.engine.JasperReport org.nuclos.server.report.api.JRNuclosDataSource
Classpath-Parameter in der Administration.
Beispielwert inklusive ZXing (QR-Code):
net.sf.jasperreports.engine.JasperReport org.nuclos.server.report.api.JRNuclosDataSource com.google.zxing.BarcodeFormat com.google.zxing.WriterException com.google.zxing.client.j2se.MatrixToImageWriter com.google.zxing.common.BitMatrix com.google.zxing.qrcode.QRCodeWriter com.qrcodeself.QRCodeClass
Neustart
Nach jeder Änderung des Parameters ist ein Serverneustart nötig.
Verwandte Seiten
Überblick
Inhalte