Groovy Handler in Applikationen

Reiter "Handler"

Diesen Dialog erreichen Sie, wenn die Experten-Optionen aktiviert sind, im Eigenschaftendialog einer Applikation und im Eigenschaftendialog ihrer Seiten und Datengruppen. Hier können Handler definiert werden, über die Groovy-Skript ausgeführt werden kann.

Actionhandler

Reagiert auf Aktionen wie das Speichern oder Löschen von Daten.

Renderinghandler

Wird beim Rendern der Seite aktiv.

Beispiele für die Verwendung von Handlern

Mit dem Actionhandler können z.B. alte Werte eines Datensatzes in den Verarbeitungskontext geschrieben und per Prozess als History verwendet werden. Ein weiteres Anwendungsbeispiel ist die Erzeugung von IDs, die aus den Werten von diversen Eingabefeldern (z.B. Name, Jahr, fortlaufende Nummer) zusammengesetzt sind. Wird dieses Problem mit einem Handler gelöst, wird weder ein Prozess noch JavaScript benötigt. Aus Sicherheitsgründen ist der Einsatz eines Handlers von Vorteil, da Code nicht clientseitig ausgeführt wird, sondern auf dem Server.

Skriptausführung

Skript wird jeweils in dem Umfeld ausgeführt, in dem es hinterlegt ist. Bei einer Seite wird das Skript nur für diese Seite ausgeführt, in Datengruppen bei allen in dieser Datengruppe enthaltenen Seiten und Aktionen. Skript im Applikationsknoten wird applikationsweit ausgeführt.

Handlerdefinition entfernen

Die aktuell ausgewählte Handlerdefinition wird gelöscht.

Nach oben / unten verschieben

Ändert die Reihenfolge der Handler.

Handlerdefinition hinzufügen / Handlerdefinition bearbeiten

Öffnet einen Dialog, in dem ein neuer Handler definiert werden kann bzw. eine bestehende Handlerdefinition bearbeitet werden kann.

Handlerdefinition

Name

Tragen Sie hier einen Namen für den Handler ein.

Aktion

Kann bei einem Actionhandler ausgewählt werden, um das Skript auszuführen. Bei Renderinghandlern ist keine Aktion auswählbar.

Spalte "Methode"

Hier wird die Methode angegeben.

Spalte "Groovy-Skript"

Zeigt den Pfad auf die referenzierte Groovy-Skriptdatei an.

Methode hinzufügen

Hier kann der gewünschte Zeitpunkt für die Ausführung des Skripts ausgewählt werden. Dabei können die folgenden Ausführungsphasen gewählt werden:

  • processBefore

    Das Skript wird vor der Verarbeitung des Requests ausgeführt

  • processBeforeWorkflow

    Nur bei ActionHandlern; Ausführung nach Request, vor einer Prozessausführung

  • processAfter

    Ausführung an letzter Stelle

Ist die gewünschte Methode ausgewählt, wird automatisch der Groovy-Dateimanager geöffnet, in dem unter anderem der Speicherort des Skripts festgelegt werden kann.

Der Speicherort befindet sich im Portalverzeichnis"internal/application/store/<application-GUID>/groovy".

Die Applikations-GUID kann mit der Taste F4 über den Applikationsknoten ermittelt werden, vorausgesetzt, die Experten-Optionen sind aktiviert. Auch innerhalb der beiden Handler-Typen gibt es entsprechend der Applikationsstruktur eine Reihenfolge für die Abarbeitung:

RenderingHandler

processBefore:

  1. RenderingHandler der Applikation

  2. RenderingHandler der Datengruppe

  3. RenderingHandler der Seite

processAfter: umgekehrte Reihenfolge

ActionHandler

processBefore und processBeforeWorkflow:

  1. ActionHandler der Applikation

  2. ActionHandler der Datengruppe

  3. ActionHandler der Seite

processAfter: umgekehrte Reihenfolge

Methode entfernen

Entfernt die aktuell markierte Methode aus der Liste.

Skript bearbeiten

Öffnet den Skript-Editor.

Skript-Datei auswählen

Öffnet den Groovy-Dateimanager.

Kompilierte Skriptklassen zwischenspeichern

Die kompilierten Groovy-Skriptklassen werden im Cache gehalten.

Fehler, wenn Skript nicht vorhanden ist

Gibt eine Meldung aus, wenn das referenzierte Skript nicht gefunden wird.

Println-Ausgaben unterdrücken

Schaltet Println-Meldungen ab.