Sprache: Deutsch · English
Scriptlets
Report-Logik per Java-Scriptlet erweitern – JRDefaultScriptlet, Test im Designer, Einbindung als Extension.
HOW-TO ANWENDUNGSENTWICKLER STAND: JUL 2026 GILT FUER NUCLOS 4.2026.X
Auf dieser Seite
Was sind Scriptlets?
Scriptlets sind selbst geschriebene Java-Klassen, die Einfluss auf die Ausführung eines Reports/Formulars nehmen. Für ein einfaches Scriptlet leitest du von net.sf.jasperreports.engine.JRDefaultScriptlet ab (leere Standardmethoden) und überschreibst nur die benötigten Methoden.
Ablauf
- Scriptlet-Klasse erstellen und als JAR packen.
- Scriptlet in Jaspersoft Studio testen.
- Scriptlet in Nuclos als Extension einbinden.
Scriptlet-Klasse erstellen
- Java-Library-Projekt anlegen; alle eigenen Klassen in einem Package.
- Aktuelles JDK verwenden.
jasperreports-6.17.0.jarund weitere Abhängigkeiten hinzufügen.
In Jaspersoft Studio testen
Zuerst die Klasse(n) dem Classpath bekannt machen: Extras → Optionen → Tab Classpath, per Add Jar das Scriptlet-JAR (und alle Abhängigkeiten inkl. jasperreports-6.17.0.jar) hinzufügen; reloadable anhaken. Bei einem einzelnen Scriptlet reicht der vollständige Klassenname unter dem Dokument-Property Scriptlet Class. Der Aufruf erfolgt über $P{REPORT_SCRIPTLET}.methode() in der Image-/Text-Expression.
Bekannter Bug
In Jaspersoft Studio 6.17.0 gibt es einen Bug, durch den Reporte mit Scriptlets nicht korrekt kompilieren. Nutze zum Testen eine andere Version.
In Nuclos einbinden
Damit Reporte mit Scriptlets in Nuclos laufen, müssen die Scriptlets als serverseitige Extensions eingebunden werden.
Verwandte Seiten
Überblick
Inhalte