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.

GruppeFeldartBezeichnerSeite
TextTextTEXTText
Formatierter TextHTMLFormatierter Text
LinkLINKLink
Zahlen und MaßeDezimalzahl, GanzzahlDECIMAL, INTZahl
Datum und ZeitDatumDATEDatum
UhrzeitTIMEUhrzeit
Datum und UhrzeitDATETIMEDatum und Uhrzeit
AuswahlAuswahllisteSELECTAuswahlliste
AuswahlbaumtreeselectAuswahlbaum
Auswahlliste mit HierarchietreesvelecteAuswahlliste mit Hierarchie
SchalterswitchSchalter
Verknüpfungen, Normdaten, AdressenNormdatensatznormdatensatzNormdatensatz
AdresseADDRESSAdresse
GeopositiongeolocationGeoposition
PlanplanWandplaner
Dateien und MedienBildbildBild
DateidateiDatei
3D3D3D
Berechnet, JSON, eigener CodeJSONJSONJSON
JSON-SchemaJSON_SCHEMAJSON-Schema
Virtuelles FeldVIRTUELLVirtuelles Feld
VorlagenfeldCUSTOM_TEXT, CUSTOM_INT, CUSTOM_DECIMAL, CUSTOM_SVELTE_TEXT, CUSTOM_SVELTE_INT, CUSTOM_SVELTE_DECIMALVorlagenfeld

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.

BezeichnerStattdessenUmstellen ohne Datenverlust
schlagworteSELECT mit multiple und creatable, oder normdatensatz für ein gepflegtes Vokabularauf SELECT ja
audio, video, panoramadateija
zahl_formatiert, zahl_labeledDECIMALja

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:

AbschnittInhalt
GrunddatenFeldbezeichnung, Feldgruppe, Hinweis, Beispielinhalt, Feldart
ParameterDie Schlüssel der Feldart als Formular, darunter Alle Parameter als JSON
AusgabeAusgabe-Formatter, siehe Formatierungen
BedingungenPflicht, Eindeutigkeit, eigene Regel
Eigener CodeHTML-Vorlage oder Svelte-Komponente der Vorlagenfelder
RechteLese- und Schreibrechte für alle und je Gruppe
VerwendungProjekte, 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:

FeldartFormatierungen der FeldartVorbelegt in den Ansichten
DECIMAL, INTZahl · Zahl mit Einheitnein
DATEDatum TT.MM.JJJJnein
TIMEUhrzeit HH:MMnein
DATETIMEZeitstempel TT.MM.JJJJ HH:MMnein
switchBeschriftungnein
HTMLNur der Textja
LINKOhne Protokoll · Nur die Domainnein
SELECT, schlagworteMit Mittelpunkt getrenntnein
treeselect, treesvelecteNur die unterste Ebenenein
normdatensatzNur das Label · Label mit Quelleja (Nur das Label)
ADDRESSAdresse einzeiligja
geolocationOrt einzeiligja
bild, datei, 3D, audio, video, panoramaDateititelja
JSONEinträge einzeilignein

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:

FeldartBesonderheit
AdresseZuweisen braucht Schreibrecht auf das Feld, Anlegen und Bearbeiten von Adressen das Recht auf das Adressbuch
Normdatensatzbearbeiten regelt, welche Datensätze im Formular geändert werden dürfen
Uhrzeitdisabled sperrt die Eingabe auch bei Schreibrecht
Virtuelles FeldKein 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.

SpeicherformUntereinander umstellbar
TextTEXT, SELECT, HTML, LINK, switch, treeselect, treesvelecte, JSON, JSON_SCHEMA, schlagworte, CUSTOM_TEXT, CUSTOM_SVELTE_TEXT
GanzzahlINT, CUSTOM_INT, CUSTOM_SVELTE_INT
DezimalzahlDECIMAL, zahl_formatiert, zahl_labeled, CUSTOM_DECIMAL, CUSTOM_SVELTE_DECIMAL
DatumDATE
UhrzeitTIME
ZeitstempelDATETIME
Dateibild, 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

FrageFolge
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
Einheiten gehören in die Konfiguration

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 .

\ en\ de