Tabellen en velden
De kolommen van een tabel vormen een gesloten set van zes typen, elk omgezet bij het opslaan, plus de indexen waarmee een rij vindbaar wordt.
Een tabel definieer je één keer, in Xuda Studio, en elke plek die de gegevens ervan toont, het raster in Studio, het tabblad Gegevens van het dashboard, een programma Gegevens ophalen of een directe API-aanroep, leest dezelfde velddefinities.
Deze pagina behandelt velden zoals je ze tegenkomt bij het bouwen en bekijken van een tabel. Voor de volledige lijst met eigenschappen, indexen en hoe een programma Gegevens ophalen of Gegevens instellen naar een tabel verwijst, zie Tabel in Bouwstenen.
Zes veldtypen, niets anders
Elk veld in een tabel is precies één van zes typen. Studio toont elk met een eigen icoon in de
rasterkop in plaats van een tekstbadge, omdat een kolom smal is en een veld-id zoals ORD_Total
al het grootste deel van de breedte inneemt:
Er is geen zevende type, en geen manier om een eigen type toe te voegen. Een veld dat niet in deze
zes past, een rich-textblok, een bestand, een relatie met een andere tabel, wordt gemodelleerd als
een string (een id, een pad, een JSON-gecodeerde blob) of een array/object daarvan. Voor
geen van die dingen bestaat een apart volwaardig kolomtype in een tabel.
Wat elk type echt met een waarde doet
Zowel dbs_create als dbs_update zetten de waarde die je stuurt om via het gedeclareerde type
van het veld voordat die wordt opgeslagen. Het is dus goed om precies te weten wat elke omzetting
doet, in plaats van een vertrouwde betekenis aan te nemen:
string
Alles wat nog geen string is, wordt omgezet met een gewone stringomzetting. Een lege of ontbrekende
waarde wordt opgeslagen als "".
number
Number(value) wordt opgeslagen. Een waarde die niet naar een eindig getal wordt omgezet, valt
terug op 0 in plaats van de schrijfactie te weigeren. Een lege of ontbrekende waarde wordt ook
opgeslagen als 0.
boolean
Alleen een vaste lijst tokens wordt gelezen als true (Y, 1, true, TRUE, ON, YES) en
een andere vaste lijst als false (N, 0, false, FALSE, OFF, NO). Al het andere, ook
een lege waarde, wordt opgeslagen als false.
object
Een string wordt als JSON5 geparseerd. Een waarde die al de vorm van een object heeft, wordt
ongewijzigd opgeslagen. Een lege of ontbrekende waarde, of een string die niet te parseren is,
wordt opgeslagen als {}.
array
Een string wordt eerst als JSON5 geparseerd en, als dat mislukt, in plaats daarvan als JavaScript-literal
geëvalueerd. Een waarde die al de vorm van een array heeft, wordt ongewijzigd opgeslagen. Een lege
of ontbrekende waarde, of een string die door geen van beide parsers wordt verwerkt, wordt
opgeslagen als [].
date
Bij binnenkomst is er geen speciale datumverwerking: elke string die je stuurt, wordt precies
zoals verstuurd opgeslagen. Kies één formaat, ISO 8601 (2026-09-25T00:00:00.000Z) is de veiligste
standaard, want het platform normaliseert een datumveld niet voor je, en een tabel met gemengde
formaten sorteert en filtert inconsistent.
Een waarde sturen die geen geldig getal kan worden voor een veld number laat de aanroep niet
mislukken, er wordt stilletjes 0 opgeslagen. Valideer een numerieke waarde zelf voordat je hem
wegschrijft als een 0 verkeerd zou zijn.
Velden een naam geven
Er is geen afgedwongen naamregel behalve dat veld-id's uniek moeten zijn binnen de tabel, maar
elke tabel in een Xuda-project volgt al één afspraak: laat elk veld beginnen met een korte code
voor de tabel zelf, zodat ORD - Orders ORD_Id, ORD_Total en ORD_Status oplevert. Zo
blijven veldnamen ondubbelzinnig zodra een query, een expressie of een importbestand naar meerdere
tabellen tegelijk moet verwijzen.
Een veld verplicht maken
Een veld heeft een vlag voor verplicht die je instelt als je het definieert, naast het type en de opmerking, om vast te leggen dat een rij niet bedoeld is om zonder waarde daar te worden opgeslagen.
Tabellen hebben een eigen status actief of gearchiveerd
Los van het archiveren van een enkele rij (zacht verwijderen, zie Gegevens opvragen via de API) kan een tabel zelf actief of gearchiveerd zijn als Studio-node. Het tabblad Gegevens van het dashboard toont de tabellen van een project als kaarten, om te schakelen tussen Actief en Gearchiveerd, waarbij elke kaart de naam van de tabel en het huidige aantal rijen toont. Een tabel hier archiveren is een actie aan de Studio-kant op de node en is iets anders dan rijen erin archiveren.