validValues

Die Eigenschaft validValues (früher range) gibt eine Reihe von Werten an, die für Benutzereingaben gültig sind. Die Eigenschaft wird für numerische und Zeichenfelder verwendet.

Die Eigenschaft gibt ein Feldgruppenliteral mit einzelnen oder zweiwertigen Elementen an, wie in den folgenden Beispielen dargestellt:
  validValues = [ [1,3], 5, 12 ]
  validValues = [ "a", ["d", "i"]] 
Jedes einzelne Element enthält einen gültigen Wert. Jedes zweiwertige Element enthält eine Auswahl. Es gelten folgende Richtlinien:
  • Bei Zahlen ist der linke Wert der niedrigste gültige und der rechte Wert der höchste gültige Wert. Im ersten Beispiel sind die Werte 1, 2, 3, 5 und 12 für ein Feld INT gültig.
  • Bei Zeichenfeldern wird die Benutzereingabe mit einem Wertebereich für die Zeichen verglichen, für die ein Vergleich möglich ist. Der Bereich ["a", "c"] umfasst beispielsweise (als gültige Werte) alle Eingaben, deren erstes Zeichen 'a', 'b' oder 'c' ist. Die Zeichenfolge 'cat' kommt in der Sortierfolge zwar nach 'c', ist jedoch eine gültige Eingabe.
    Generell gilt: Wenn der erste Wert in dem Bereich mit lowValue und der zweite Wert mit highValuegekennzeichnet ist, ist die Benutzereingabe gültig, falls sie die folgenden Tests besteht:
    • Die Benutzereingabe ist gleich lowValue oder highValue.
    • Die Benutzereingabe ist größer als lowValue und kleiner als highValue.
    • Die ersten Zeichen der Eingabe stimmen mit den ersten Zeichen in lowValue überein, soweit ein Vergleich möglich ist.
    • Die ersten Zeichen der Eingabe stimmen mit den ersten Zeichen in highValue überein, soweit ein Vergleich möglich ist.

Wenn die Benutzereingabe außerhalb des angegebenen Bereichs liegt, zeigt EGL eine Fehlernachricht an (siehe validValuesMsgKey).

Beispiele

Die folgenden zusätzlichen Beispiele zeigen mögliche Wertebereiche für die Eigenschaft an:
  // Gültige Werte sind 1, 2, 3, 5, 7 und 11.
  validValues = [[1, 3], 5, 7, 11]

  // Gültige Werte sind die Buchstaben "a" und "z".
  validValues = ["a", "z"]

  // Gültige Werte sind alle Zeichenfolgen, die mit "a" beginnen.
  validValues = [["a", "a"]]

  // Gültige Werte sind alle Zeichenfolgen, 
  // die mit einem Kleinbuchstaben beginnen.
  validValues = [["a", "z"]]

  // Die Zeichenfolge "baa" ist hier NICHT gültig.
validValues = [ "a", ["bbb", "i"]]

  // Die Zeichenfolge "baa" IST hier gültig.
  validValues = [ "a", ["b", "i"]]

Kompatibilität

Tabelle 1. Unterstützung für die Eigenschaft 'validValues'
Datenelement JSF-Handler VGUI-Datensatz Konsol-UI Textformular Java™ Textformular COBOL Druckformular Java Druckformular COBOL
Ja Ja Ja Ja Ja Ja* Nein Nein

* Es gelten folgende zusätzliche Hinweise zur Kompatibilität:

Tabelle 2. Hinweise zur Kompatibilität für 'validValues'
Plattform Problem
COBOL-Generierung Textformulare unterstützen nur numerische Felder und ein einzelnes gültiges Wertepaar.