Zum Inhalt springen
Geprüft

Tabellen und Felder

Die Spalten einer Tabelle sind eine geschlossene Menge von sechs Typen, jeder beim Speichern umgewandelt, dazu die Indizes, die eine Zeile auffindbar machen.

Eine Tabelle wird einmal in Xuda Studio definiert, und jede Stelle, die ihre Daten zeigt, das Studio-Raster, der Tab Daten des Dashboards, ein Get-Data-Programm oder ein direkter API-Aufruf, liest dieselben Felddefinitionen.

Die vollständige Schema-Referenz

Diese Seite behandelt Felder so, wie du ihnen beim Bauen und Durchsuchen einer Tabelle begegnest. Die vollständige Eigenschaftenliste, die Indizes und wie ein Get-Data- oder Set-Data-Programm auf eine Tabelle zeigt, findest du unter Tabelle in Building Blocks.

Sechs Feldtypen, sonst nichts

Jedes Feld einer Tabelle ist genau einer von sechs Typen. Studio zeigt jeden mit eigenem Symbol im Rasterkopf statt mit einem Text-Badge, da eine Spalte schmal ist und eine Feld-ID wie ORD_Total schon den größten Teil der Breite einnimmt:

Es gibt keinen siebten Typ und keine Möglichkeit, einen eigenen hinzuzufügen. Ein Feld, das in diese sechs nicht passt, ein Rich-Text-Block, eine Datei, eine Beziehung zu einer anderen Tabelle, wird als string (eine ID, ein Pfad, ein JSON-codierter Blob) oder als array/object davon modelliert; für nichts davon gibt es in einer Tabelle einen eigenen vollwertigen Spaltentyp.

Was jeder Typ tatsächlich mit einem Wert macht

Sowohl dbs_create als auch dbs_update wandeln den gesendeten Wert vor dem Speichern über den deklarierten Typ des Feldes um, daher lohnt es sich, genau zu wissen, was jede Umwandlung tut, statt eine vertraute Bedeutung anzunehmen:

string

Alles, was nicht schon ein String ist, wird mit einer einfachen String-Umwandlung konvertiert. Ein leerer oder fehlender Wert wird als "" gespeichert.

number

Number(value) wird gespeichert. Ein Wert, der sich nicht zu einer endlichen Zahl parsen lässt, fällt auf 0 zurück, statt den Schreibvorgang abzulehnen. Ein leerer oder fehlender Wert wird ebenfalls als 0 gespeichert.

boolean

Nur eine feste Liste von Tokens gilt als true (Y, 1, true, TRUE, ON, YES) und eine andere feste Liste als false (N, 0, false, FALSE, OFF, NO); alles andere, auch ein leerer Wert, wird als false gespeichert.

object

Ein String wird als JSON5 geparst; ein Wert, der bereits die Form eines Objekts hat, wird unverändert gespeichert. Ein leerer oder fehlender Wert oder ein String, der sich nicht parsen lässt, wird als {} gespeichert.

array

Ein String wird zuerst als JSON5 geparst, und wenn das scheitert, stattdessen als JavaScript-Literal ausgewertet; ein Wert, der bereits die Form eines Arrays hat, wird unverändert gespeichert. Ein leerer oder fehlender Wert oder ein String, den keines der beiden Parsings verarbeitet, wird als [] gespeichert.

date

Beim Speichern gibt es keine eigene Datumsbehandlung: Jeder String, den du sendest, wird genau so gespeichert, wie er gesendet wurde. Wähle ein Format, ISO 8601 (2026-09-25T00:00:00.000Z) ist der sicherste Standard, denn nichts in der Plattform normalisiert ein Datumsfeld für dich, und eine Tabelle mit gemischten Formaten sortiert und filtert uneinheitlich.

Eine Zahl lehnt nie einen Schreibvorgang ab

Wenn du für ein number-Feld einen Wert sendest, der keine gültige Zahl werden kann, schlägt der Aufruf nicht fehl, sondern speichert stillschweigend 0. Prüfe einen numerischen Wert selbst, bevor du ihn schreibst, wenn eine 0 falsch wäre.

Felder benennen

Es gibt keine erzwungene Namensregel außer dass Feld-IDs in der Tabelle eindeutig sind, aber jede Tabelle, die schon in einem Xuda-Projekt existiert, folgt einer Konvention: Setze jedem Feld ein kurzes Kürzel für die Tabelle selbst voran, sodass ORD - Orders zu ORD_Id, ORD_Total, ORD_Status führt. Das hält Feldnamen eindeutig, sobald eine Abfrage, ein Ausdruck oder eine Importdatei mehrere Tabellen gleichzeitig referenzieren muss.

Ein Feld als Pflichtfeld markieren

Ein Feld trägt ein Pflichtfeld-Flag, das du beim Definieren neben seinem Typ und Kommentar setzt, um festzuhalten, dass eine Zeile nicht ohne einen Wert dort gespeichert werden soll.

Tabellen haben einen eigenen Zustand aktiv/archiviert

Getrennt davon, dass eine einzelne Zeile archiviert (weich gelöscht) wird, siehe Daten über die API abfragen, kann eine Tabelle selbst als Studio-Knoten aktiv oder archiviert sein. Der Tab Daten des Dashboards listet die Tabellen eines Projekts als Karten, umschaltbar zwischen Aktiv und Archiviert, wobei jede Karte den Namen der Tabelle und ihre aktuelle Zeilenzahl zeigt. Eine Tabelle hier zu archivieren ist eine Aktion auf der Studio-Seite am Knoten und eine andere Operation, als Zeilen darin zu archivieren.