Skript (Vergleichstyp)
Siehe auch: Skript Aktion, Skript-Regel, Skript Wert
ACHTUNG
Der Skript (Vergleichstyp)-Vergleichstyp ist nur für weit fortgeschrittene und programmiertechnisch versierte Benutzer geeignet. Daher werden hier keine detaillierten Anwendungsmöglichkeiten beschrieben, da dies Teil der Entwicklerdokumentation ist. Der Skript (Vergleichstyp)-Vergleichstyp sollte ausschließlich für Probleme genutzt werden, für die Lobster Data Platform / Orchestration keine generischen Ansätze anbietet. Durch fehlerhafte Verwendung dieses Vergleichstyps kann erheblicher und unwiderruflicher Schaden am System und dem Datenbestand entstehen. Bitte treten Sie für weitere Informationen und eventuelle Schulungen/Workshops diesbezüglich mit unseren Support-Mitarbeitern in Verbindung.
►HINWEIS◄ Der Skript (Vergleichstyp)-Vergleichstyp wird ausschließlich serverseitig unterstützt. Im Client Workflow ist er nicht auswählbar.
Der Skript (Vergleichstyp)-Vergleichstyp ermöglichst es, eine spezifische Vergleichslogik per Bean Shell-Skript zu definieren. Wie alle anderen Vergleichstypen kommt auch der Skript (Vergleichstyp)-Vergleichstyp innerhalb einer Objekt-Feld-Regel zum Einsatz.
Als Rückgabewert des Skripts wird ein Boolean-Wert als Rückgabewert (return) erwartet, der definiert, ob der Vergleich und damit die übergeordnete Objekt-Feld-Regel als "bestanden" (true) oder "nicht bestanden" (false) gilt.
Tatsächlich wird jeder andere Rückgabewert als true auf der Ebene der Objekt-Feld-Regel als "nicht bestanden" gewertet.
Beim Ausführen des Skripts auftretende Fehler werden abgefangen. Die Objekt-Feld-Regel gilt ggf. als "nicht bestanden".
Konfiguration
Das "Skript" muss als statischer Text in einem als Syntax Highlighter ausgeprägten Textfeld eingegeben werden. Das Skript kann auch Kommentare enthalten (s. Screenshot, unten).
►HINWEIS◄ Der Editor ist im Kontext nur verfügbar, wenn die Rolle der Session über die Berechtigung "Administration/System/BSH Script/Script Bearbeiten" verfügt. Auf das Laufzeitverhalten eines bereits konfigurierten Vergleichs hat diese Berechtigung keinen Einfluss.
Variablen
Unterhalb des Skript-Editors können per Klick auf das 
-Symbol Wert-Konfigurationen für Variablen hinzugefügt werden.
Für jede Variable muss ein eindeutiger Variablenname angegeben werden.
Für den Lesezugriff auf hier definierte Variablen im Skript wird die get()-Funktion benötigt.
Eine bestehende Variablenkonfiguration kann per Klick auf das 
-Symbol entfernt werden.
►HINWEISE◄
Als Bezugsobjekt für Wert-Konfigurationen von Variablen dient das Bezugsobjekt für die Objekt-Feld-Regel (entity). Die Prüfwert-Konfiguration der Objekt-Feld-Regel hat darauf keinen Einfluss.
Variablen, die im Kontext der Objekt-Feld-Regel gelten, können im Skript über den Parameter action (s. unten) auch ohne ausdrückliche Wert-Konfiguration per get()-Funktion gelesen werden.
Parameter
Zur Laufzeit werden ausgewählte Daten aus dem Kontext der Objekt-Feld-Regel über Parameter für den Zugriff im Skript bereitgestellt:
|
Parameter |
Beschreibung |
|
environment |
"Lobster Data Platform / Orchestration Environment"-Instanz |
|
si |
Session Information-Objekt (s. Info der Session) |
|
logger |
Logger-Instanz |
|
action |
Die aktuelle Aktion, die behandelt wird, mit allen Variablen ( z. B. action.get("VARNAME") ) |
|
entity |
Bezugsobjekt im Kontext der Objekt-Feld-Regel |
|
em |
aktuelle Datenbank Session |