Referenz
Feldarten
Diese Seiten beschreiben, wie jede Feldart eingestellt wird. Was Erfassende im Layout sehen und wie sie Werte eingeben, steht im Anwenderhandbuch unter Feldarten . Jede Seite hier verweist auf ihr Gegenstück dort.
Feldarten sind vom Programm vorgegeben und lassen sich nicht anlegen. Angelegt werden Felder, siehe Felder und Feld anlegen .
Katalog
Die Gruppen folgen der Auswahl beim Anlegen eines Feldes. Der Bezeichner ist das, was dort und in den Felddetails unter Feldart steht.
| Gruppe | Feldart | Bezeichner | Seite |
|---|---|---|---|
| Text | Text | TEXT | Text |
| Formatierter Text | HTML | Formatierter Text | |
| Link | LINK | Link | |
| Zahlen und Maße | Dezimalzahl, Ganzzahl | DECIMAL, INT | Zahl |
| Datum und Zeit | Datum | DATE | Datum |
| Uhrzeit | TIME | Uhrzeit | |
| Datum und Uhrzeit | DATETIME | Datum und Uhrzeit | |
| Auswahl | Auswahlliste | SELECT | Auswahlliste |
| Auswahlbaum | treeselect | Auswahlbaum | |
| Auswahlliste mit Hierarchie | treesvelecte | Auswahlliste mit Hierarchie | |
| Schalter | switch | Schalter | |
| Verknüpfungen, Normdaten, Adressen | Normdatensatz | normdatensatz | Normdatensatz |
| Adresse | ADDRESS | Adresse | |
| Geoposition | geolocation | Geoposition | |
| Plan | plan | Wandplaner | |
| Dateien und Medien | Bild | bild | Bild |
| Datei | datei | Datei | |
| 3D | 3D | 3D | |
| Berechnet, JSON, eigener Code | JSON | JSON | JSON |
| JSON-Schema | JSON_SCHEMA | JSON-Schema | |
| Virtuelles Feld | VIRTUELL | Virtuelles Feld | |
| Vorlagenfeld | CUSTOM_TEXT, CUSTOM_INT, CUSTOM_DECIMAL, CUSTOM_SVELTE_TEXT, CUSTOM_SVELTE_INT, CUSTOM_SVELTE_DECIMAL | Vorlagenfeld |
Die Bezeichner sind teils groß, teils klein geschrieben. In der Oberfläche ist das unerheblich, beim Vergleichen von Exporten oder Konfigurationen nicht.
Noch ohne Eingabemaske
Diese Feldarten lassen sich anlegen, stehen in der Auswahl aber mit dem Zusatz „noch ohne Eingabemaske“. Ein Feld dieser Art zeigt nur ein gesperrtes Textfeld mit dem Rohwert.
| Bezeichner | Stattdessen | Umstellen ohne Datenverlust |
|---|---|---|
schlagworte | SELECT mit multiple und creatable, oder normdatensatz für ein gepflegtes Vokabular | auf SELECT ja |
audio, video, panorama | datei | ja |
zahl_formatiert, zahl_labeled | DECIMAL | ja |
Die Schlagworte einer Datei sind etwas anderes: sie hängen an der Datei und sind über Bildfeld~schlagworte erreichbar.
Parameter und Vorgabe der Feldart
Die Konfiguration eines Feldes pflegen die Felddetails unter Datenmodell › Felder:
| Abschnitt | Inhalt |
|---|---|
| Grunddaten | Feldbezeichnung, Feldgruppe, Hinweis, Beispielinhalt, Feldart |
| Parameter | Die Schlüssel der Feldart als Formular, darunter Alle Parameter als JSON |
| Ausgabe | Ausgabe-Formatter, siehe Formatierungen |
| Bedingungen | Pflicht, Eindeutigkeit, eigene Regel |
| Eigener Code | HTML-Vorlage oder Svelte-Komponente der Vorlagenfelder |
| Rechte | Lese- und Schreibrechte für alle und je Gruppe |
| Verwendung | Projekte, Layouts und Objekte, die das Feld nutzen |
Die Tabellen auf den Feldartseiten nennen in der Spalte Ohne Angabe, was das Feld tut, wenn der Schlüssel fehlt. Daneben hat jede Feldart eine Vorgabe, gepflegt unter Datenmodell › Feldarten als „Vorgabe-Parameter“. Sie gilt nur für Felder ohne eigene Konfiguration. Sobald ein Feld eigene Parameter hat, gelten nur diese; „Vorgabe der Feldart“ in den Felddetails mischt die Schlüssel der Vorgabe auf Wunsch in die eigene Konfiguration. Das Formular unter Parameter lässt einen Schlüssel weg, wenn sein Wert der Formularvorgabe entspricht.
Wie die Konfiguration aufgebaut ist, wie ein Konfigurations-Hook sie je Projekt übersteuert und was bei fehlerhaftem JSON passiert, steht unter Feldkonfiguration .
Formatierungen
Eine Formatierung (Ausgabe-Formatter) ist eine zweite Lesart des Rohwerts: 1 234,50 cm statt 1234.5, die Anschrift statt der Kennungskette. Sie wirkt in Galerie, Tabelle und Kanban, im
Excel-Export und in Word-Vorlagen. Seit Version 1.4.23 bringt jede Feldart außer TEXT mindestens eine
Formatierung mit:
| Feldart | Formatierungen der Feldart | Vorbelegt in den Ansichten |
|---|---|---|
DECIMAL, INT | Zahl · Zahl mit Einheit | nein |
DATE | Datum TT.MM.JJJJ | nein |
TIME | Uhrzeit HH:MM | nein |
DATETIME | Zeitstempel TT.MM.JJJJ HH:MM | nein |
switch | Beschriftung | nein |
HTML | Nur der Text | ja |
LINK | Ohne Protokoll · Nur die Domain | nein |
SELECT, schlagworte | Mit Mittelpunkt getrennt | nein |
treeselect, treesvelecte | Nur die unterste Ebene | nein |
normdatensatz | Nur das Label · Label mit Quelle | ja (Nur das Label) |
ADDRESS | Adresse einzeilig | ja |
geolocation | Ort einzeilig | ja |
bild, datei, 3D, audio, video, panorama | Dateititel | ja |
JSON | Einträge einzeilig | nein |
Im Export bleibt überall der Rohwert vorbelegt. Gespeicherte Excel-Voreinstellungen und Vorlagen ändern sich dadurch nicht. Datum, Zeitstempel und Schalter sind absichtlich auch in den Ansichten nicht vorbelegt: dort folgt die Anzeige schon der persönlichen Einstellung.
Feldart und Feld
Formatierungen gibt es auf zwei Stufen. Die Feldart bringt ihre unter Datenmodell › Feldarten mit;
ein Feld ergänzt eigene unter Ausgabe. Beide werden nach Kennung zusammengeführt: bei gleicher
Kennung gewinnt das Feld, alles andere der Feldart bleibt am Feld wählbar. Eine neue eigene Formatierung
bekommt deshalb eine freie Kennung. Die Variante standard ist die, die der schlichte Feldname in
Vorlagen adressiert; weitere heißen Feld#kennung.
Die Vorbelegung lässt sich je Ort getrennt setzen und an einem einzelnen Feld ändern, ohne den Rumpf der Feldart abzuschreiben. Ein Eintrag mit Kennung und ohne Rumpf ist genau diese Aussage:
JSON{ "ausgabe": [{ "name": "standard", "vorgabe": { "ansicht": "roh", "export": "roh" } }] }
Ein Formatter sieht nur sein eigenes Feld. Der Rumpf läuft im selben geprüften Sandkasten wie virtuelle Felder und Bedingungen, siehe Virtuelles Feld . Fällt er durch die Prüfung, gibt es keinen Formatter; die Spalte bleibt roh statt falsch. Aufbau und Beispiele stehen unter JSON , die Verwendung in Vorlagen unter Ausgabe-Formatter in Vorlagen .
Bedingungen
Für jede Feldart lassen sich unter Bedingungen vier Prüfungen setzen: darf nicht leer sein, im Projekt einmalig, in der Datenbank einmalig, eigene Regel. Eine verletzte Bedingung ist ein Hinweis, keine Sperre: der Wert wird gespeichert, das Feld trägt ein rotes Ausrufezeichen, eine Leiste über dem Layout zählt die betroffenen Felder. Bedingungen stehen nur am Feld, nie in der Vorgabe der Feldart, und lassen sich per Konfigurations-Hook je Projekt ändern.
JSON{ "bedingungen": { "required": true, "unique": { "meldung": "Inventarnummer doppelt" } } }
Rechte
Lese- und Schreibrechte setzt der Abschnitt Rechte für alle und je Gruppe; das höhere Recht gilt. Siehe Rechtemodell . Feldartspezifisch sind:
| Feldart | Besonderheit |
|---|---|
| Adresse | Zuweisen braucht Schreibrecht auf das Feld, Anlegen und Bearbeiten von Adressen das Recht auf das Adressbuch |
| Normdatensatz | bearbeiten regelt, welche Datensätze im Formular geändert werden dürfen |
| Uhrzeit | disabled sperrt die Eingabe auch bei Schreibrecht |
| Virtuelles Feld | Kein eigenes Recht. Sichtbar nur, wer alle Quellen lesen darf |
Feldart umstellen
Eine Feldart lässt sich unter Grunddaten nur auf eine Feldart mit derselben Speicherform umstellen; die Oberfläche bietet nur diese an. Die Werte bleiben dabei unberührt.
| Speicherform | Untereinander umstellbar |
|---|---|
| Text | TEXT, SELECT, HTML, LINK, switch, treeselect, treesvelecte, JSON, JSON_SCHEMA, schlagworte, CUSTOM_TEXT, CUSTOM_SVELTE_TEXT |
| Ganzzahl | INT, CUSTOM_INT, CUSTOM_SVELTE_INT |
| Dezimalzahl | DECIMAL, zahl_formatiert, zahl_labeled, CUSTOM_DECIMAL, CUSTOM_SVELTE_DECIMAL |
| Datum | DATE |
| Uhrzeit | TIME |
| Zeitstempel | DATETIME |
| Datei | bild, datei, 3D, audio, video, panorama |
Verweisarten (ADDRESS, normdatensatz, geolocation, plan) stehen jeweils allein. Umstellbar heißt
nicht bedeutungsgleich: aus einem Schalter wird eine Auswahlliste mit den Werten 1 und 0.
Die passende Feldart wählen
| Frage | Folge |
|---|---|
| Wird nach dem Wert gefiltert, sortiert oder gruppiert? | Ein eigenes Feld mit passender Speicherform. Zahlen als DECIMAL, Daten als DATE, sonst werden Vergleiche zu Textvergleichen |
| Ist die Wertemenge begrenzt? | SELECT, nicht TEXT. Freitext erzeugt Varianten (Öl/Leinwand, Öl auf Leinwand), die keine Gruppierung mehr zulassen |
| Hat die Wertemenge Ebenen? | Auswahlbaum oder Auswahlliste mit Hierarchie. Sie speichern den Pfad und erlauben Gruppierung je Ebene |
| Braucht der Begriff Kennung und Quelle, etwa für LIDO? | normdatensatz |
| Wiederholt sich eine Struktur mit einem Zusatz (Titel je Sprache, Maße je Bereich)? | JSON. Ein Feld statt zwölf |
| Ist der Wert aus anderen Feldern ableitbar? | VIRTUELL statt doppelter Erfassung |
Ein Feld Höhe (cm) mit Freitext ist ein häufiger Erfassungsfehler. Richtig ist ein DECIMAL-Feld mit
Einheiten: gespeichert wird in der Basiseinheit, angezeigt in der gewählten. So bleibt der Wert
vergleichbar, sortierbar und rechenbar. Siehe Zahl .