--- title: 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==` 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.