Naar de inhoud springen
Geverifieerd

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.

De volledige schemareferentie

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 getal weigert een schrijfactie nooit

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.