Versionen im Vergleich

Schlüssel

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

Nuclos JasperReports Scriptlet: JRDefaultScriptlet, Scriptlet Class, $P{REPORT_SCRIPTLET}, Extension, jasperreports-6.17.0.jar.

globe with meridians Sprache: Deutsch · English

hammer and wrench Scriptlets

Report-Logik per Java-Scriptlet erweitern – JRDefaultScriptlet, Test im Designer, Einbindung als Extension.

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
maxLevel

...

Definition

...

2
minLevel2

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

  1. Scriptlet-Klasse erstellen und als JAR packen.

Eine schrittweise Anleitung zur Anfertigung eines Scriptlets und Verwendung in Jaspersoft Studio kann im JasperReports Ultimate Guide wunderbar nachvollzogen werden.

Daher werden hier nur die Eckpunkte und Besonderheiten in Bezug auf Nuclos erläutert.

Konfiguration

...

  1. Scriptlet in Jaspersoft Studio testen.
  2. 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.jar

...

  • und 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.

Warnung
titleBekannter Bug

Je nachdem, was das Scriptlet ausführen soll bzw. mittels ihre definierten Funktion zurückgibt, wird die entsprechende Komponente aus der Palette ausgewählt (Image, TextField). Im Image/Text Expression unter den Eigenschaften wird die Methode über den Parameter aufgerufen ($P{REPORT_SCRIPTLET}.methodexy()).

...

In Jaspersoft Studio 6.17.0

...

gibt es einen Bug,

...

durch den Reporte mit Scriptlets nicht korrekt kompilieren.

...

Nutze zum Testen eine andere Version.

Info
titleIn

...

Nuclos einbinden

Damit Reporte

...

mit Scriptlets in Nuclos laufen, müssen die Scriptlets als serverseitige Extensions eingebunden werden.

Verwandte Seiten

printer Arbeiten mit Jasper Studio


Überblick.

Öffnen →

electric plug

. Wie dies genau funktioniert, ist im Kapitel

Jasper Extensions in Nuclos

beschrieben


Einbinden.

Öffnen →