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 | Entfernen von Auswahlen | |||
---|---|---|---|---|
CMS_INPUT_CHECKBOX | 0 | 1 | n | durch Deaktivieren in der GUI |
CMS_INPUT_COMBOBOX | 0 | 1 | durch Deaktivieren in der GUI oder EMPTY | |
CMS_INPUT_LIST | 0 | 1 | n | durch Deaktivieren in der GUI |
CMS_INPUT_RADIOBUTTON | 1 | Kein Entfernen möglich | ||
Beispiele
Beispiel 1) Einträge einer Liste (LIST) per Eingabe in Text-Komponente auswählen
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).