Hopp til innholdet
Bekreftet

Tabeller og felt

En tabells kolonner er et lukket sett med seks typer, hver konvertert ved inngangen, pluss indeksene som gjør en rad mulig å finne.

En tabell defineres én gang, i Xuda Studio, og alle steder som viser dataene, Studio-rutenettet, dashbordets Data-fane, et Hent data-program eller et direkte API-kall, leser de samme feltdefinisjonene.

Den fullstendige skjemareferansen

Denne siden dekker feltene slik du møter dem når du bygger og blar i en tabell. For hele egenskapslisten, indekser og hvordan et Hent data- eller Sett data-program peker på en tabell, se Tabell i Byggeklosser.

Seks felttyper, ingenting annet

Hvert felt i en tabell er nøyaktig én av seks typer. Studio viser hver med sitt eget ikon i rutenettets overskrift i stedet for et tekstmerke, siden en kolonne er smal og en felt-id som ORD_Total allerede tar det meste av bredden:

Det finnes ingen sjuende type, og ingen måte å legge til en egendefinert. Et felt som ikke passer inn i disse seks, en rik tekstblokk, en fil, en relasjon til en annen tabell, modelleres som en string (en id, en bane, en JSON-kodet blokk) eller en array/object av dem. Det finnes ingen egen førsteklasses kolonnetype for noe av dette i en tabell.

Hva hver type faktisk gjør med en verdi

Både dbs_create og dbs_update konverterer verdien du sender gjennom feltets deklarerte type før den lagres, så det er verdt å vite nøyaktig hva hver konvertering gjør i stedet for å anta en kjent betydning:

string

Alt som ikke allerede er en streng, konverteres med en enkel strengkonvertering. En tom eller manglende verdi lagres som "".

number

Number(value) lagres. En verdi som ikke kan tolkes som et endelig tall, faller tilbake til 0 i stedet for å avvise skrivingen. En tom eller manglende verdi lagres også som 0.

boolean

Bare en fast liste med tokens leses som true (Y, 1, true, TRUE, ON, YES), og en annen fast liste som false (N, 0, false, FALSE, OFF, NO). Alt annet, også en tom verdi, lagres som false.

object

En streng tolkes som JSON5. En verdi som allerede har form av et objekt, lagres som den er. En tom eller manglende verdi, eller en streng som ikke lar seg tolke, lagres som {}.

array

En streng tolkes først som JSON5, og hvis det mislykkes, evalueres den som en JavaScript-literal i stedet. En verdi som allerede har form av en matrise, lagres som den er. En tom eller manglende verdi, eller en streng ingen av tolkingene klarer, lagres som [].

date

Det finnes ingen egen datohåndtering ved inngangen: strengen du sender, lagres nøyaktig som sendt. Velg ett format. ISO 8601 (2026-09-25T00:00:00.000Z) er det tryggeste standardvalget, siden ingenting i plattformen normaliserer et datofelt for deg, og en tabell med blandede formater sorteres og filtreres inkonsekvent.

Et tall avviser aldri en skriving

Å sende en verdi som ikke kan bli et gyldig tall til et number-felt, får ikke kallet til å mislykkes. Det lagrer stille 0. Valider en tallverdi selv før du skriver den hvis en 0 ville vært feil.

Å gi felt navn

Det er ingen håndhevet navneregel utover at felt-id-er må være unike i tabellen, men alle tabeller som allerede finnes i et Xuda-prosjekt følger én konvensjon: prefiks hvert felt med en kort kode for selve tabellen, slik at ORD - Orders gir ORD_Id, ORD_Total, ORD_Status. Det holder feltnavnene entydige når en spørring, et uttrykk eller en importfil må referere til flere tabeller samtidig.

Å markere et felt som obligatorisk

Et felt har et obligatorisk-flagg du setter når du definerer det, sammen med typen og kommentaren, for å registrere at en rad ikke er ment å lagres uten en verdi der.

Tabeller har sin egen aktiv/arkivert-tilstand

Uavhengig av at en enkelt rad arkiveres (myk sletting, se Spørring av data over API-et), kan en tabell selv være aktiv eller arkivert som en Studio-node. Dashbordets Data-fane viser et prosjekts tabeller som kort, som kan veksles mellom Aktiv og Arkivert, der hvert kort viser tabellens navn og gjeldende antall rader. Å arkivere en tabell her er en handling på Studio-siden, på noden, og er noe annet enn å arkivere rader inni den.