Eigenschaft SIZE

Prüft der Anzahl der Elemente einer Eingabekomponente vom Typ FS_LIST

Die Eingabekomponente FS_LIST ermöglicht die Erstellung von Listen auf der Basis von FirstSpirit-Daten unterschiedlicher Herkunft bzw. Typen. Die Anzahl der in einer FS_LIST enthaltenen Listenelemente kann über eine Regel ermittelt und ausgewertet werden. Mithilfe des Attributs SIZE kann beispielsweise eine Regel definiert werden, die die Anzahl der möglichen Einträge in diese Eingabekomponente auf einen bestimmten Wert beschränkt.

Der Ausdruck <PROPERTY source='list' name='SIZE'/> kann im Bereich Wertermittlung der Regeldefinition (oder für die Definition einer Vorbedingung) eingesetzt werden und liefert die Anzahl der Einträge, die aktuell in der Eingabekomponente enthalten sind.

Zur Definition einer vollständigen Bedingung für eine Validierung, also z. B.:

• „Ist die Anzahl der in der FS_LIST enhaltenen Einträge größer als 10?“ oder
• „Ist die Anzahl der in der FS_LIST enhaltenen Einträge kleiner als als 2?“

muss zusätzlich ein Vergleichswert:

• ein konstanter numerischer Vergleichswert (z.B. <NUMBER>10</NUMBER>) oder
• ein variabler Vergleichswert, bspw. die Anzahl der Einträge einer weiteren FS_LIST

und ein Operator:

• <GREATER_THAN/>,
• <LESS_THAN/> oder
• <EQUAL/>

angegeben werden. In diesem Fall liefert der Ausdruck einen Booleschen Wert zurück.

Beispiele

Beispiel 1) Beschränkt die Anzahl der Einträge für eine FS_LIST auf maximal 2 Einträge

Das folgende Formular enthält eine Eingabekomponente „st_list“ (vom Typ FS_LIST) zur Angabe von E-Mail-Adressen. Über ein dynamisches Formular soll sichergestellt werden, dass vom Redakteur nicht mehr als zwei Einträge zur Liste hinzugefügt werden.

Dazu wird innerhalb des <WITH/>-Abschnitts die Zeichenanzahl der Eingabekomponente geholt und gegen eine numerische Konstante verglichen. Das Ergebnis dieser „Größer-als“-Prüfung ist ein Boolescher Wert, der anschließend im <DO/>-Abschnitt mit einer Validierung der Eingabekomponente verknüpft wird. Solange die Bedingung („Anzahl der Einträge ist nicht größer als 2“) nicht erfüllt ist, wird der <VALIDATION/>-Abschnitt der Regel ausgeführt und ein Korrekturhinweis eingeblendet. Durch die umschließenden <ON_SAVE/>-Tags wird außerdem das Speichern des Formulars unterbunden.

<ON_SAVE>
        <WITH>
            <NOT>
                <GREATER_THAN>
                    <PROPERTY source="list" name="SIZE"/>
                    <NUMBER>2</NUMBER>
                </GREATER_THAN>
            </NOT>
        </WITH>
        <DO>
            <VALIDATION>
                <PROPERTY source="list" name="VALID"/>
                <MESSAGE lang="*" text="Only 2 entries allowed!"/>
                <MESSAGE lang="DE" text="Es sind nur 2 Einträge zugelassen!"/>
            </VALIDATION>
        </DO>
    </ON_SAVE>