Tabeller och fält
En tabells kolumner är en sluten uppsättning av sex typer, var och en konverterad vid inskrivning, plus de index som gör en rad sökbar.
En tabell definieras en gång, i Xuda Studio, och varje ställe som visar dess data, Studios rutnät, dashboardens Data tab, ett Hämta data-program eller ett direkt API-anrop, läser samma fältdefinitioner.
Den här sidan beskriver fält så som du möter dem när du bygger och bläddrar i en tabell. För den fullständiga egenskapslistan, index och hur ett Hämta data- eller Sätt data-program pekar på en tabell, se Table i Building Blocks.
Sex fälttyper, inget annat
Varje fält i en tabell är exakt en av sex typer. Studio visar var och en med en egen ikon i
rutnätets rubrik i stället för en textetikett, eftersom en kolumn är smal och ett fält-id som
ORD_Total redan tar det mesta av bredden:
Det finns ingen sjunde typ och inget sätt att lägga till en egen. Ett fält som inte passar in i
dessa sex, ett rich text-block, en fil, en relation till en annan tabell, modelleras som en
string (ett id, en sökväg, en JSON-kodad blob) eller en array/object av sådana. Det finns
ingen separat förstklassig kolumntyp för något av det i en tabell.
Vad varje typ faktiskt gör med ett värde
Både dbs_create och dbs_update konverterar värdet du skickar enligt fältets deklarerade typ
innan det lagras, så det är värt att veta exakt vad varje konvertering gör i stället för att anta
en välbekant betydelse:
string
Allt som inte redan är en sträng konverteras med en vanlig strängkonvertering. Ett tomt eller
saknat värde lagras som "".
number
Number(value) lagras. Ett värde som inte tolkas som ett ändligt tal blir 0 i stället för att
skrivningen avvisas. Ett tomt eller saknat värde lagras också som 0.
boolean
Bara en fast lista av tecken läses som true (Y, 1, true, TRUE, ON, YES), och en
annan fast lista som false (N, 0, false, FALSE, OFF, NO). Allt annat, även ett
tomt värde, lagras som false.
object
En sträng tolkas som JSON5. Ett värde som redan är ett objekt lagras som det är. Ett tomt eller
saknat värde, eller en sträng som inte går att tolka, lagras som {}.
array
En sträng tolkas först som JSON5, och om det misslyckas utvärderas den i stället som en
JavaScript-literal. Ett värde som redan är en array lagras som det är. Ett tomt eller saknat
värde, eller en sträng som ingen av tolkningarna klarar, lagras som [].
date
Det finns ingen särskild datumhantering vid inskrivning: den sträng du skickar lagras exakt som
den skickades. Välj ett format. ISO 8601 (2026-09-25T00:00:00.000Z) är det säkraste valet,
eftersom ingenting i plattformen normaliserar ett datumfält åt dig, och en tabell med blandade
format sorteras och filtreras inkonsekvent.
Om du skickar ett värde som inte kan bli ett giltigt tal till ett number-fält misslyckas inte
anropet, utan 0 lagras tyst. Validera ett numeriskt värde själv innan du skriver det om en 0
vore fel.
Namnge fält
Det finns ingen påtvingad namnregel utöver att fält-id måste vara unika i tabellen, men varje
tabell som redan finns i ett Xuda-projekt följer en konvention: prefixera varje fält med en kort
kod för själva tabellen, så att ORD - Orders ger ORD_Id, ORD_Total, ORD_Status. Det håller
fältnamnen entydiga när en fråga, ett uttryck eller en importfil måste hänvisa till flera tabeller
samtidigt.
Markera ett fält som obligatoriskt
Ett fält har en flagga för obligatoriskt som du anger när du definierar det, vid sidan av dess typ och kommentar, för att notera att en rad inte är tänkt att sparas utan ett värde där.
Tabeller har ett eget aktivt/arkiverat-läge
Skilt från att en enskild rad arkiveras (mjukraderas, se Querying data over the API) kan en tabell själv vara aktiv eller arkiverad som en Studio-nod. Dashboardens Data tab listar ett projekts tabeller som kort, med växling mellan Aktiv och Arkiverad, där varje kort visar tabellens namn och dess aktuella antal rader. Att arkivera en tabell här är en åtgärd på noden i Studio, och något annat än att arkivera rader i den.