Nuclos Jasper Extensions: serverseitige Extension, Nuclet, extensions/server, nuclos.jasper.reports.compile.classpath.jars.byclasses, Pflichtwerte, Neustart.

globe with meridians Sprache: Deutsch · English

hammer and wrench Jasper Extensions in Nuclos

Fonts, Scriptlets, Barcode-/QR-Bibliotheken als serverseitige Extensions einbinden und im Jasper-Classpath registrieren.

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:

  1. Parametername: nuclos.jasper.reports.compile.classpath.jars.byclasses
  2. Beschreibung: frei wählbar.
  3. Wert: je Extension eine Klasse inkl. Package-Pfad, getrennt durch Leerzeichen oder Zeilenumbruch.

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

Nach jeder Änderung des Parameters ist ein Serverneustart nötig.

Verwandte Seiten

printer Scriptlets

Scriptlets.

Öffnen →

clipboard Barcode einbinden

Barcodes.

Öffnen →

magnifying glass tilted left QR-Codes im Reporting nutzen

QR-Codes.

Öffnen →