Auswahlbaum

Die Feldart für Werte mit Ebenen, die als offener Baum im Feld stehen. In der Auswahl beim Anlegen heißt sie treeselect. Die Eingabe aus Sicht der Erfassung beschreibt Auswahlbaum .

Die Auswahlliste mit Hierarchie arbeitet mit denselben Werten und derselben Speicherform, zeigt sie aber als Klappliste. Ein Wechsel zwischen beiden lässt die Daten unberührt.

Die Hierarchie steckt im Wert

Es gibt keine Vokabulartabelle im Hintergrund. Jeder Wert ist ein Pfad, und das Trennzeichen macht daraus einen Baum:

JSON
{
  "values": [
    "Haus A/Erdgeschoss/Raum 1",
    "Haus A/Erdgeschoss/Raum 2",
    "Haus B/Obergeschoss/Raum 1"
  ],
  "path_separator": "/",
  "multiple": false,
  "store_path": "full"
}

Werte umbauen heißt Konfiguration ändern, nicht Daten migrieren. Eine Ebene umzubenennen ändert aber nur die Liste: bestehende Werte behalten den alten Pfad. Wer Ebenen umbenennt, zieht die Werte per Stapelverarbeitung nach.

Parameter

Schlüssel	Werte	Ohne Angabe	Wirkung
`values`	Liste von Pfaden	leer	Die Optionen
`path_separator`	Zeichenkette	`/`	Trennt einen Wert in Ebenen. Leer ergibt eine flache Liste
`multiple`	`true`, `false`	`false`	Mehrere Werte wählbar
`max_items`	Zahl	offen	Obergrenze bei Mehrfachauswahl
`divider`	Zeichenkette	`,`	Verbindet mehrere Werte im gespeicherten Text
`save_as_json`	`true`, `false`	`false`	Speichert die Auswahl als JSON-Liste statt als verbundenen Text
`store_path`	`full`, `leaf`	`full`	Ganzer Pfad oder nur die letzte Ebene
`selectable_parents`	`true`, `false`	`false`	`true`: Zwischenebenen sind selbst wählbar. `false`: nur Blätter, ein Klick auf eine Ebene schaltet alles darunter
`creatable`	`true`, `false`	`false`	Eigene Pfade bei der Eingabe erlaubt
`importable`	`true`, `false`	`false`	Der Excel-Import darf Pfade außerhalb der Liste schreiben, die Handeingabe nicht
`dynamic_options`	`true`, `false`	`false`	Bietet zusätzlich an, was dieses Feld bei anderen Objekten trägt
`searchable`	`true`, `false`	`true`	Suchfeld über dem Baum
`placeholder`	Zeichenkette	leer	Platzhalter im Suchfeld
`expand_depth`	Zahl	`1`	Klappt beim Laden bis zu dieser Tiefe auf
`sort`	`true`, `false`	`true`	Sortiert die Ebenen alphabetisch statt in der Reihenfolge aus `values`

store_path: die wichtigste Entscheidung

Wert	Gespeichert	Wann sinnvoll
`full`	`Haus A/Erdgeschoss/Raum 1`	Wenn die Ebene Bedeutung trägt. Raum 1 in Haus A und Haus B bleiben verschiedene Werte, und die geteilte Gruppierung liefert je Ebene eine Gruppe
`leaf`	`Raum 1`	Wenn nur der Endwert zählt und die Hierarchie reine Navigationshilfe ist

full ist die vorsichtigere Wahl. Aus dem Pfad lässt sich das Blatt jederzeit ableiten, umgekehrt nicht. Für die Anzeige gibt es dafür die Formatierung „Nur die unterste Ebene“.

Trennzeichen nachträglich ändern

divider steckt im gespeicherten Text, path_separator in jedem einzelnen Wert. Wer eines davon nachträglich ändert, trennt bestehende Werte an anderen Stellen, als sie geschrieben wurden. Die Werte müssen mitgezogen werden.

save_as_json: true speichert eine echte Liste. Das ist präziser, macht Filter und Excel-Export aber sperriger. Für die meisten Felder ist die verbundene Form richtig.

Import

Ohne creatable und ohne importable übernimmt der Excel-Import nur Pfade aus der Liste. Angenommen wird der ganze Pfad und die letzte Ebene allein, solange sie eindeutig ist. Gespeichert wird die Form, die store_path vorgibt. Alles andere wird geparkt, siehe Zuordnungen auflösen . Bei Mehrfachauswahl gilt die ganze Zelle als Einheit.

Formatierung

Die Feldart bringt Nur die unterste Ebene mit. Trennzeichen und Verbinder liest sie aus der Konfiguration des Feldes. Sie ist nirgends vorbelegt, weil das Weglassen des Pfades Werte mehrdeutig machen kann. Siehe Formatierungen .

Wann eine andere Feldart passt

Bedarf	Feldart
Wenig Platz im Layout, viele Werte	Auswahlliste mit Hierarchie
Flache Liste	Auswahlliste
Begriffe mit Kennung, Quelle und Übersetzung, oder eine Hierarchie, die unabhängig vom Feld gepflegt wird	Normdatensatz . Ein Pfad in `values` ist Konfiguration, ein Normdatensatz ist Bestand