Versionen im Vergleich

Schlüssel

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

Inhalt
maxLevel2

In diesem Artikel geht es darum, was Extensions sind und wie man sie installiert.

Was sind Extensions?

Nuclos-Extensions sind zusätzliche Programmbibliotheken und Konfigurationsdateien, die dem Nuclos-Kern bei der Installation hinzugefügt werden.

Programmbibliotheken können desktopclientseitig, serverseitig, beidseitig für den Desktopclient und den Server oder webclientseitig verwendet werden.
Desktopclientseitige Bibliotheken modifizieren Ihren Desktopclient und webclientseitige Ihren Webclient.
Serverseitige Bibliotheken nehmen ausschließlich auf den Server Einfluss, auf dem die Nuclos-Instanz läuft und werden beispielsweise für den Fall benötigt,
wenn die Bibliotheken in serverseitigen Regeln verwendet werden sollen. Beidseitige Bibliotheken nehmen sowohl auf den Desktopclient, als auch auf den Server Einfluss, jedoch nicht auf den Webclient.

Installation von Extensions

SchrittBeschreibung
1Legen Sie im Hauptverzeichnis Ihrer Nuclos-Instanz einen Ordner mit dem Namen extensions an
2Legen Sie im Ordner extensions vier Unterordner mit den Namen client, server, webapp und common an.

Diese sind die Unterordner für die Programmbibliotheken. Extensions die im Ordner client angelegt werden, bieten desktopclientseitige Funktionalitäten, die im Ordner server,
serverseitige, die im Ordner webapp webclientseitige und im Ordner common für beidseitige für den Desktopclient und den Server.
3

Legen Sie im Ordner extensions drei Unterordner für die Konfigurationsdateien mit den Namen tomcat, bin und conf an.

Diese sind die Unterordner für die Konfigurationsdateien. Im Zuge der Installation der Nuclos-Instanz werden die Konfigurationsdateien aus den Extensions entnommen und
in die darin beschriebenen Zielverzeichnisse kopiert. Dadurch hat man die Möglichkeit spezielle Konfigurationsanpassungen an der Nuclos-Instanz vorzunehmen, die mit Update der
Nuclos-Instanz nicht verloren gehen.

Hinweis: Dabei werden auch Konfigurationsdateien ersetzt, die der Nuclos-Installer selbst anpasst, wie z.B. die Port-Konfiguration des Tomcats.
Wenn solch eine Konfigurationsdatei im extensions-Verzeichnis erkannt wird, zeigt der Installer eine Warnung an.

4Updaten Sie Ihre Nuclos-Instanz, indem Sie den Installer auf den verwendeten Dateipfad erneut ausführen. Im Log der Installation kann nachvollzogen werden,
ob die neue Ordnerstruktur übernommen und die Extensions damit installiert wurden.


     

Parameter setzen im Nuclos

Damit die im Nuclos enthaltene Jasperreports-3.5.3 - Intallation den Ort der auszuführenden Scriptlets findet, müssen der Pfad und die Klassen bekannt gemacht werden. Das geschieht über die Definition von Parametern.
Unter Administration -> Parameter wird eine neue Maske geöffnet.Image Removed

     

Image Removed

 

Als Wert wird die Scriptletclass angegeben, sowie, Leerzeichen separiert, alle Klassen inklusive der Package-Name, die aus den Abhängigkeiten verwendet werden.

 

 

 

 

 

 

 

 

 

  1. nuclos.jasper.reports.compile.classpath.jars.byclasses
  2. Jars to add to the Jasperreports compile classpath
  3. grün: Jeweils ein Klasse aus allen verwendeten Jars ( Achtung auf Abhängikeiten)
    gelb!! Dieser Wert muss immer vorhanden sein !! default: net.sf.jasperreports.engine.JasperReport org.nuclos.server.report.api.JRNuclosDataSource

Beispiel für Wert QRCode:

...