Gå til indhold
Bekræftet

Tabeller og felter

En tabels kolonner er et lukket sæt af seks typer, hver konverteret ved indlæsning, plus de indekser, der gør en række mulig at finde.

En tabel defineres én gang, i Xuda Studio, og alle steder, der viser dens data, Studio-gitteret, dashboardets fane Data, et Hent data-program eller et direkte API-kald, læser de samme felddefinitioner.

Den fulde skemareference

Denne side dækker felter, som du møder dem, når du bygger og gennemser en tabel. For den komplette egenskabsliste, indekser og hvordan et Hent data- eller Sæt data-program peger på en tabel, se Tabel under Byggeklodser.

Seks felttyper, ikke flere

Hvert felt i en tabel er præcis én af seks typer. Studio viser hver med sit eget ikon i gitterets overskrift i stedet for et tekstmærke, da en kolonne er smal, og et felt-id som ORD_Total allerede fylder det meste af bredden:

Der er ingen syvende type og ingen mulighed for at tilføje en brugerdefineret. Et felt, der ikke passer til disse seks, en rich text-blok, en fil, en relation til en anden tabel, modelleres som en string (et id, en sti, en JSON-kodet klump) eller et array/object af dem. Der er ingen separat førsteklasses kolonnetype til noget af det i en tabel.

Hvad hver type faktisk gør med en værdi

Både dbs_create og dbs_update konverterer den værdi, du sender, gennem feltets erklærede type, før den gemmes, så det er værd at vide præcis, hvad hver konvertering gør, i stedet for at antage en velkendt betydning:

string

Alt, der ikke allerede er en streng, konverteres med en almindelig strengkonvertering. En tom eller manglende værdi gemmes som "".

number

Number(value) gemmes. En værdi, der ikke kan tolkes som et endeligt tal, falder tilbage til 0 i stedet for at afvise skrivningen. En tom eller manglende værdi gemmes også som 0.

boolean

Kun en fast liste af tokens læses som true (Y, 1, true, TRUE, ON, YES), og en anden fast liste som false (N, 0, false, FALSE, OFF, NO). Alt andet, også en tom værdi, gemmes som false.

object

En streng tolkes som JSON5. En værdi, der allerede har form som et objekt, gemmes uændret. En tom eller manglende værdi, eller en streng, der ikke kan tolkes, gemmes som {}.

array

En streng tolkes først som JSON5, og hvis det fejler, evalueres den i stedet som en JavaScript-literal. En værdi, der allerede har form som et array, gemmes uændret. En tom eller manglende værdi, eller en streng, som ingen af tolkningerne kan håndtere, gemmes som [].

date

Der er ingen dedikeret datohåndtering ved indlæsning: den streng, du sender, gemmes præcis, som den er sendt. Vælg ét format. ISO 8601 (2026-09-25T00:00:00.000Z) er den sikreste standard, da intet i platformen normaliserer et datofelt for dig, og en tabel med blandede formater sorterer og filtrerer uens.

Et tal afviser aldrig en skrivning

Hvis du sender en værdi, der ikke kan blive et gyldigt tal, til et number-felt, fejler kaldet ikke. Det gemmer lydløst 0. Valider selv en numerisk værdi, før du skriver den, hvis et 0 ville være forkert.

Navngivning af felter

Der er ingen håndhævet navngivningsregel ud over, at felt-id'er skal være unikke i tabellen, men hver tabel, der allerede findes i et Xuda-projekt, følger én konvention: giv hvert felt et kort præfiks for selve tabellen, så ORD - Orders giver ORD_Id, ORD_Total, ORD_Status. Det holder feltnavne entydige, når en forespørgsel, et udtryk eller en importfil skal referere til flere tabeller på én gang.

At markere et felt som obligatorisk

Et felt har et flag for obligatorisk, som du sætter, når du definerer det, ved siden af dets type og kommentar, for at registrere, at en række ikke er beregnet til at blive gemt uden en værdi dér.

Tabeller har deres egen aktiv/arkiveret-tilstand

Uafhængigt af, at en enkelt række arkiveres (blødt slettes, se Forespørgsler på data via API'et), kan en tabel selv være aktiv eller arkiveret som en Studio-node. Dashboardets fane Data viser et projekts tabeller som kort, der kan skiftes mellem Aktiv og Arkiveret, hvor hvert kort viser tabellens navn og dens aktuelle antal rækker. At arkivere en tabel her er en handling på Studio-siden af noden, og det er en anden handling end at arkivere rækker i den.