Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.
Auszug
hiddentrue

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.

Status
colourPurple
titleHow-to
Status
colourBlue
titleAnwendungsentwickler
Status
colourGreen
titleStand: Jul 2026
Status
colourGrey
titlegilt fuer Nuclos 4.2026.x

Panel
bgColor#F4F5F7

Auf dieser Seite

Inhalt
maxLevel2
minLevel2

...

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. wie sie eine serverseitige Extension in Nuclos installieren/hinzufügen.
  2. wie sie eine serverseitige Extension im Classpath registrieren, so dass die JasperReport Komponente 

Hinzufügen/Installation einer Extension in Nuclos

Es gibt 2 verschiedene Varianten um eine Extension in Nuclos hinzuzufügen.

Variante 1: Extension zu Nuclet hinzufügen

1. Öffnen Sie die Nucletübersicht über Konfiguration → Nuclets

2. Wählen Sie das Nuclet aus, welchem Sie die Extension zuordnen wollen.

3. Fügen Sie im Tab Extensions einen neuen Eintrag hinzu und wählen Sie die Jar-Datei der Extension aus.

4. Setzen Sie ein Häkchen unter Server Extension?.

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

Variante 2: Extension im Serververzeichnis platzieren

1. Öffnen sie das Verzeichnis Ihrer Nuclos Instanz

2. Legen Sie darin einen Ordner extensions mit einem Unterordner server an.

3. Platzieren Sie die Jar-Dateien in den server Ordner.

...

unter webapp/WEB-INF/lib im Tomcat

...

.

...

2. Extension im Classpath registrieren

Nachdem die Extension sich nun im System von Nuclos befindet, muss der Jasperreports Komponente noch Zugriff darauf gegeben werden. Dies geschieht, indem man die Extension im Classpath Parameter der JasperReports Komponente bekannt macht. Vorgehen:

Damit die JasperReports-Komponente die Extension nutzt, wird sie über den Parameter Administration → Parameter registriert:

  1. Öffnen Sie die Parameterübersicht: Administration → Parameter.
  2. Falls noch kein Parameter nuclos.jasper.reports.compile.classpath.jars.byclasses vorhanden ist, erstellen Sie einen neuen Eintrag.

Image Removed

...

  1. Parametername:
  1. nuclos.jasper.reports.compile.classpath.jars.byclasses

...

...

  1. Beschreibung: frei wählbar.

...

  1. Wert: je Extension eine Klasse inkl. Package-Pfad, getrennt durch Leerzeichen oder Zeilenumbruch.
Warnung
titlePflichtwerte

Diese beiden Pflichtwerte müssen immer enthalten sein

...

, sonst funktioniert das Reporting nicht

...

:
net.sf.jasperreports.engine.JasperReport

...

org.nuclos.server.report.api.JRNuclosDataSource

Image Added

Classpath-Parameter in der Administration.

Beispielwert inklusive ZXing (QR-Code):

Codeblock
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
Info
titleNeustart

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 →

  • Optionale Extensions (grüne Markierung): Hier fügen Sie Ihre Extensions ein. Sie müssen nur eine Klasse aus der jeweiligen Extension Jar inklusive ihres Package Pfades als Präfix eintragen.
  • Nach einer Veränderung des Parameters ist ein Serverneustart notwendig.
  • Image Removed