logical-condition(cnd a, val b [, c, ...])

Gruppe

Logical Functions


Diese Funktion ist veraltet (deprecated).

Liefert einen logischen Wert true oder false, abhängig von der Bedingung a und ihrem Parameter b bzw. ihren Parametern b, c, … (Siehe: Tabelle). Die Bedingung wird als Schlüsselwort (z. B. equal) in a erwartet. Zur logischen Inversion kann diesem Schlüsselwort not vorangestellt werden, z. B. not equal oder auch notequal. Die Anzahl der Argumente ab Parameter b hängt vom Schlüsselwort ab. Überflüssige Parameter werden ignoriert.

Die Funktion implementiert selbst keine eigene Bedingungslogik, sondern bildet nur einen einheitlichen Aufruf-Rahmen für vorhandene Funktionen mit logischem Rückgabewert.

Der Rückgabewert der aufgerufenen Funktion wird zum Ergebnis dieser Funktion.

Als Schlüsselwort kann auch ein Funktions-Macro mit der Syntax Macro(macroname) verwendet werden. Wenn das Schlüsselwort nicht erkannt werden kann, wird die Funktion mit einer Exception beendet.

Konditionsnamen


Wert

Entspricht Funktion

empty

is empty(a)

match

match-pattern(a, b)

file

file-exists(a)

length

length(trim(a)) > 0

equal

a equals b

istrue

copy(field/value/variable)

and

logical-and(a, b,[c,d,e])

or

logical-or(a, b,[c,d,e])

xor

xor(a, b)

numeric

numeric(a)

<

a < b

>

a > b

<=

a <= b

>=

a >= b

Ist dem Wert ein not vorangestellt, wird das Ergebnis der gewählten Operation negiert.

Erweiterung der registrierten Bedingungs-Schlüsselworte


Zusätzlich zu den hartkodierten Schlüsselworten entsprechend obiger Tabelle können in der Datei ./etc/admin/datawizard/custom_conditionfilter.properties weitere Schlüsselwörter als Property definiert werden. Sie wird beim Start vom Integration Server und nach jeder Veränderung gelesen.

Syntax: key=Funktion_Klassenname oder key=Funktion_ID oder key=Makro(makroname)
Die Schlüsselworte (key) müssen eindeutig sein, die Klassennamen vollständig mit Package angegeben, Funktion_IDs sind registrierte Funktion-IDs aus filter.properties oder custom_filter.properties (positive Zahlen). Macros werden erst beim ersten Aufruf der Funktion geladen. Public Macros stehen jedem Mandanten zur Verfügung, mandantenabhängige Macros können nur von ihrem Mandanten aufgerufen werden.

Falls eine zusätzliche Funktion mehr als 5 Parameter erwartet, muss die Anzahl der Parameter (Default: 6) mit dem Property: param_count=<Parameteranzahl> erhöht werden. Werte kleiner als der Default 6 werden ignoriert.

Registrierte Keys werden als Tooltip des Parameters a angezeigt, registrierte Public Macros erst nach erstem Aufruf.

Parameterbeschreibung


Parameter

Beschreibung

a

Name der zu verwendenden Kondition (siehe Tabelle).

b

Parameter a der aufgerufenen logischen Funktion.

c, ...

(optional) Eventuell weitere Parameter der aufgerufenen Funktion (b bis f).

Beispiele


Parameter a

Parameter b

Parameter c

Ergebnis

not numeric

M73D22


true

equal

one

two

false