flexi-select¶

Das Auswahlfeld bietet eine Liste vordefinierter Optionen, aus der ein Eintrag ausgewaehlt wird. Bei Bedarf kann der Anwender den ausgewaehlten Eintrag nachtraeglich als Freitext anpassen, oder das Feld in Abhaengigkeit von einem anderen Feld automatisch deaktiviert werden.

Einstellungen¶

Einstellung	Beschreibung
Bezeichnung	Der angezeigte Text ueber dem Feld
Name	Eindeutiger Bezeichner des Feldes (wird automatisch aus der Bezeichnung abgeleitet)
Pflichtfeld	Wenn aktiv, muss ein Eintrag ausgewaehlt sein, damit das Feld als gueltig gilt
Fehlertext	Meldung, die angezeigt wird, wenn das Pflichtfeld leer bleibt
Optionen	Liste der zur Auswahl stehenden Eintraege (siehe Optionen)
Eintrag bearbeitbar	Erlaubt es dem Anwender, einen ausgewaehlten Eintrag im Anschluss als Freitext zu ueberschreiben
Feld deaktivieren	Sperrt das Feld dauerhaft oder in Abhaengigkeit von einem anderen Feld (siehe Feld deaktivieren)

In den Erweiterten Einstellungen stehen zusaetzlich zur Verfuegung:

Einstellung	Beschreibung
Vorbelegung	Eintrag, der beim Anlegen eines neuen Dokuments bereits ausgewaehlt ist
Pruefungsregeln	Regeln, die bestimmen, wann der ausgewaehlte Eintrag als korrekt gilt (siehe Pruefungsregeln)

Optionen¶

Die Optionen werden im Editor als Liste gepflegt. Jeder Eintrag wird einzeln hinzugefuegt und kann nachtraeglich

ueber das Stift-Symbol umbenannt,
ueber das Muelltonnen-Symbol entfernt,
per Drag-and-Drop in der Reihenfolge verschoben werden.

Die Reihenfolge im Editor entspricht spaeter der Reihenfolge im Auswahl-Popup.

Eintrag bearbeitbar¶

Ist die Option Eintrag bearbeitbar aktiv, erscheint nach der Auswahl eines Eintrags rechts neben dem Feld ein Stift-Symbol. Damit kann der Anwender den ausgewaehlten Wert in ein freies Texteingabefeld umwandeln und beliebig anpassen — zum Beispiel, um eine Standard-Antwort um eine konkrete Information zu ergaenzen.

Im Bearbeitungsmodus stehen zwei Schaltflaechen zur Verfuegung:

Speichern uebernimmt den eingegebenen Text als Wert des Feldes.
Abbrechen verwirft die Aenderung und leert das Feld.

Entspricht der gespeicherte Text spaeter wieder einer der vordefinierten Optionen, wird das Feld automatisch wieder als normales Auswahlfeld dargestellt.

Feld deaktivieren¶

Mit dieser Option wird das Auswahlfeld gesperrt, sodass der Anwender keinen Eintrag mehr aendern kann. Die Sperre kann entweder dauerhaft gelten oder vom Zustand eines anderen Feldes abhaengig gemacht werden.

Einstellung	Beschreibung
Abhaengiges Feld	Wenn aktiv, wird die Sperre vom Zustand eines anderen Feldes gesteuert. Ohne diese Option ist das Feld dauerhaft gesperrt
Pfad des abhaengigen Feldes	Name des steuernden Feldes. Liegt das Feld im selben Abschnitt, genuegt der Name (`auswahl`). Fuer ein Feld in einem anderen Abschnitt: `abschnitt.feld`
Vergleichswert	Optionaler Wert, mit dem der Inhalt des abhaengigen Feldes verglichen wird
Sperren wenn	Bedingung, unter der das Feld gesperrt wird (siehe Tabelle unten)

Die moeglichen Bedingungen unter Sperren wenn haengen davon ab, ob ein Vergleichswert eingetragen ist:

Vergleichswert eingetragen?	Auswahl	Bedeutung
Nein	Feld leer	Sperrung, solange das abhaengige Feld leer ist
Nein	Feld gesetzt	Sperrung, sobald das abhaengige Feld einen Wert enthaelt
Ja	Wert stimmt ueberein	Sperrung, wenn das abhaengige Feld genau den Vergleichswert enthaelt
Ja	Wert stimmt nicht ueberein	Sperrung, solange das abhaengige Feld nicht den Vergleichswert enthaelt

Vorbelegung¶

In den erweiterten Einstellungen kann ein Eintrag als Vorbelegung ausgewaehlt werden. Beim Anlegen eines neuen Dokuments ist dieser Eintrag dann bereits ausgewaehlt und kann vom Anwender bei Bedarf geaendert werden. Wird kein Eintrag als Vorbelegung gewaehlt, ist das Feld zunaechst leer.

Pflichtfeld und Auswahl loeschen¶

Ist das Feld als Pflichtfeld markiert und es ist kein Eintrag ausgewaehlt, wird der unter Fehlertext hinterlegte Text als Hinweis angezeigt.

Sobald ein Eintrag ausgewaehlt ist, erscheint im Feld rechts neben der Auswahl ein kleines Kreuz. Damit kann die Auswahl wieder zurueckgesetzt werden.

Pruefungsregeln¶

In den erweiterten Einstellungen koennen Pruefungsregeln definiert werden. Wenn Regeln konfiguriert sind, zeigt das Feld neben der Auswahl ein Statussymbol (Badge):

Gruener Haken — der ausgewaehlte Eintrag erfuellt die Regeln
Rotes Kreuz — der ausgewaehlte Eintrag erfuellt die Regeln nicht
Gelbes Fragezeichen — es ist noch kein Eintrag ausgewaehlt

Die Pruefung ist erfolgreich, sobald die erste Regel der Liste zutrifft. So lassen sich mehrere Eintraege als gleichwertig „in Ordnung" definieren.

Text-Vergleich¶

Vergleicht den ausgewaehlten Eintrag mit einem festen Text.

Regel	Bedeutung
`VALUE==in Ordnung`	Auswahl muss exakt `in Ordnung` sein
`VALUE!=Nicht erforderlich`	Auswahl darf nicht `Nicht erforderlich` sein

Optional kann vor dem Operator eine Lese-Hilfe angegeben werden — sie hat keinen Einfluss auf die Pruefung und dient nur der besseren Lesbarkeit der Regel:

Regel	Bedeutung
`VALUE:Bewertung==bestanden`	Auswahl muss exakt `bestanden` sein (Lese-Hilfe `Bewertung`)

Zahlen-Vergleich¶

Wird das Auswahlfeld mit numerischen Optionen verwendet, koennen die ueblichen Vergleichsoperatoren genutzt werden.

Regel	Bedeutung
`VALUE>=10`	Auswahl muss mindestens `10` sein
`VALUE<=100`	Auswahl darf hoechstens `100` sein
`VALUE<5`	Auswahl muss strikt kleiner als `5` sein
`VALUE>0`	Identisch mit `VALUE>=0` (Mindestwert)

Mehrere Alternativen¶

Mehrere Regeln werden als Alternativen ausgewertet — die Pruefung gilt als erfuellt, sobald eine davon zutrifft:

VALUE==bestanden
VALUE==teilweise bestanden

Sowohl bestanden als auch teilweise bestanden sind in Ordnung.

Anderes Feld als Alternative¶

Mit COMPONENT:feld.length>n kann ein anderes Feld als gueltige Alternative akzeptiert werden — typischerweise ein Bemerkungsfeld:

VALUE==bestanden
COMPONENT:bemerkung.length>0

Entweder ist die Bewertung bestanden, oder es wurde eine Bemerkung eingetragen.

Wert eines anderen Feldes pruefen¶

Mit COMPONENT:feld.value==<wert> kann der Wert eines anderen Feldes als Bedingung herangezogen werden:

COMPONENT:freigegeben.value==TRUE

Die Auswahl gilt als korrekt, wenn das Feld freigegeben auf An steht.

Hinweise¶

Die Pruefungsregeln erscheinen nur dann am Feld, wenn in den erweiterten Einstellungen mindestens eine Regel hinterlegt wurde. Ohne Regeln wird kein Statussymbol angezeigt.
Solange das Feld ueber die Option Feld deaktivieren gesperrt ist, gilt es automatisch als gueltig — die Pruefungsregeln werden in diesem Zustand nicht ausgewertet.
Ein leeres Feld blockiert die Freigabe eines Dokuments nur dann, wenn es als Pflichtfeld markiert ist.