<EQUAL/> Gleichheitsprüfung in dynamischen Formularen

Das <EQUAL/>-Tag kann im Bereich Wertermittlung der Regeldefinition (oder für die Definition einer Vorbedingung) eingesetzt werden und dient dazu zwei logische Ausdrücke miteinander zu vergleichen. Das Ergebnis des zusammengesetzten logischen Ausdrucks ist einen Boolscher Wert, der genau dann wahr ist, wenn „Ausdruck a“ und „Ausdruck b“ gleich sind:

<EQUAL>
    Ausdruck a
    Ausdruck b
</EQUAL>

Mithilfe des <EQUAL/>-Tags kann eine Eigenschaft des Formulars gegen einen Vergleichswert geprüft werden.

Dazu wird innerhalb des <EQUAL/>-Tags eine bestimmte Eigenschaft eines Formular-Elements (beispielsweise der Wert einer Eingabekomponente) oder auch des Formulars („In welchem Verwaltungsbereich wurde das Formular geöffnet?“) über ein <PROPERTY/>-Tag abgefragt.

Der Vergleichswert kann ein fester numerischer oder textueller Vorgabewert sein oder sich ebenfalls auf eine Eigenschaft eines (anderen) Formularelements beziehen.

Zur Angabe eines fest definierten Vorgabewerts können folgende Tags verwendet werden:

• <TEXT/>: Zur Angabe eines textuellen Vergleichswerts innerhalb eines vergleichenden Ausdrucks
• <NUMBER/>: Zur Angabe eines numerischen Vergleichswerts innerhalb eines vergleichenden Ausdrucks

Die Prüfung eines Datums auf Gleichheit mithilfe des <DATE/>-Tags innerhalb eines <EQUAL/>Abschnitts ist nicht möglich. In diesem Fall müssen die Operatoren <GREATER_THAN/> und <LESS_THAN/> eingesetzt werden.

Beispiele

1) Formular-Eigenschaft mit einem textuellen Vorgabewert vergleichen

VALUE / TEXT:
Wert einer Eingabekomponente (<PROPERTY/>-Tag) mit einem textuellen Vorgabewert (<TEXT/>-Tag) vergleichen:

<EQUAL>
                    <PROPERTY source="st_text" name="VALUE"/>
                    <TEXT>ABC</TEXT>
</EQUAL> 

LANG / TEXT:
Die aktuelle Sprache in der ein Formular vom Redakteur bearbeitet wird (<PROPERTY/>-Tag) mit einem Vorgabewert (Sprachkürzel innerhalb eines <TEXT/>-Tags) vergleichen:

<EQUAL>
                <PROPERTY source="#global" name="LANG"/>
                <TEXT>DE</TEXT>
</EQUAL>

STORETYPE / TEXT:
Den aktuellen Verwaltungsbereich in dem ein Formular vom Redakteur geöffnet wird (<PROPERTY/>-Tag) mit einem Vorgabewert (Verwaltungsbereich innerhalb eines <TEXT/>-Tags) vergleichen

<EQUAL>
                    <PROPERTY source="#global" name="STORETYPE"/>
                    <TEXT>pagestore</TEXT>
</EQUAL>

2) Formular-Eigenschaft mit einem numerischen Vorgabewert vergleichen

LENGTH / NUMBER:
Länge des Wertes einer Eingabekomponente (<PROPERTY/>-Tag) mit einem numerischen Vorgabewert (<NUMBER/>-Tag) vergleichen:

<EQUAL>
                    <PROPERTY source="st_text" name="LENGTH"/>
                    <NUMBER>3</NUMBER>
</EQUAL>

SIZE / NUMBER:
Die Anzahl der Einträge einer Eingabekomponente vom Typ FS_LIST (<PROPERTY/>-Tag) mit einem numerischen Vorgabewert (<NUMBER/>-Tag) vergleichen:

<EQUAL>
                     <PROPERTY source="st_list" name="SIZE"/>
                     <NUMBER>2</NUMBER>
</EQUAL>

3) Zwei Formular-Eigenschaften miteinander vergleichen

VALUE / VALUE:
Werte aus zwei Eingabekomponenten miteinander vergleichen (über zwei <PROPERTY/>-Tags):

<EQUAL>
                    <PROPERTY source="st_value" name="VALUE"/>
                    <PROPERTY source="st_lowerLimit" name="VALUE"/>
</EQUAL>