Startseite / Vorlagenentwicklung / Regeln / Formulareigenschaften <PROPERTY/> / Eigenschaft SELECT

Eigenschaft SELECT

Manipuliert die Auswahl von CHECKBOX, COMBOBOX, LIST und RADIOBUTTON

Die Eigenschaft SELECT kann zur Manipulation der Auswahl in optionsbasierten Eingabekomponenten-Typen verwendet werden und zwar in:

Mithilfe von SELECT können Einträge dieser Eingabekomponenten gewählt werden. Dabei ist ein Vergleich mit folgenden Eingabekomponenten-Typen möglich:

Die (Quell-)Eingabekomponente (im folgenden Beispielcode „gadget1“), deren Wert in eine andere Eingabekomponente gesetzt werden soll, wird im Bereich Wertermittlung in der Regeldefinition folgendermaßen angegeben:

<WITH>
<PROPERTY name="VALUE" source="gadget1"/>
</WITH>

Die (Ziel-)Eingabekomponente (im folgenden Beispielcode „gadget2“), in die ein Wert aus einer anderen Eingabekomponente gesetzt werden soll, wird über das Attribut SELECT im Bereich Handlungsanweisung der Regeldefinition folgendermaßen angegeben:

<DO>
<PROPERTY name="SELECT" source="gadget2"/>
</DO>

Es können nur Werte in die Ziel-Eingabekomponente gesetzt werden, die über den Parameter „values“ im Tag <ENTRIES/> (z. B. im Falle von CMS_INPUT_CHECKBOX) für die Eingabekomponente definiert sind.

Soll ein Wert gesetzt werden, der nicht in der Wertemenge enthalten ist, wird eine Warnung in der Java-Konsole angezeigt:

Invalid value 'e' for property 'SELECT'.

Bei der Regeldefinition für die oben angegebenen Ziel-Eingabekomponenten sollten die unterschiedlichen Eigenschaften beachtet werden:

 

Auswahlmenge
(Wie viele Werte können ausgewählt werden?)

Entfernen von Auswahlen
(Wie können gewählte Werte wieder entfernt werden?)

CMS_INPUT_CHECKBOX

0

1

n

durch Deaktivieren in der GUI
oder DESELECT

CMS_INPUT_COMBOBOX

0

1

 

durch Deaktivieren in der GUI oder EMPTY

CMS_INPUT_LIST

0

1

n

durch Deaktivieren in der GUI
oder DESELECT

CMS_INPUT_RADIOBUTTON

 

1

 

Kein Entfernen möglich

     

Beispiele

Beispiel 1) Einträge einer Liste (LIST) per Eingabe in Text-Komponente auswählen

Regeln Eigenschaft SELECT

Mit folgendem einfachen Beispiel können per Eingabe in eine Text-Komponente („st_text“) entsprechende Werte in einer CMS_INPUT_LIST-Eingabekomponente („st_list“) ausgewählt werden. Dabei sind über das Tag ENTRY in CMS_INPUT_LIST die Werte a, b, c, d definiert.

<RULE>
<WITH>
<PROPERTY name="VALUE" source="st_text"/>
</WITH>
<DO>
<PROPERTY name="SELECT" source="st_list"/>
</DO>
</RULE>

Wird in die Text-Komponente a eingegeben, wird auch a in der Liste ausgewählt. Wird in die Text-Komponente b eingegeben, wird auch b in der Liste ausgewählt. Eine Abwahl der gewählten Einträge erfolgt über „Entfernen“ in der GUI.

Wird in die Text-Komponente ein Wert eingegeben, der nicht in der Wertemenge der CMS_INPUT_LIST-Komponente enthalten ist, beispielsweise m, wird eine entsprechende Warnung in der Java-Konsole ausgegeben.

Alternativ kann die Listen-Komponente auch dynamisch mit Werten aus einer Datenbank-Tabelle gefüllt werden (über CMS_INCLUDE_OPTIONS).

© 2005 - 2024 Crownpeak Technology GmbH | Alle Rechte vorbehalten. | FirstSpirit 2024.12 | Datenschutz