Taulut ja kentät
Taulun sarakkeet ovat suljettu kuuden tyypin joukko, joista jokainen muunnetaan sisään tullessa, sekä indeksit, joiden avulla rivi löytyy.
Taulu määritellään kerran Xuda Studiossa, ja jokainen paikka, joka näyttää sen datan, eli Studion ruudukko, dashboardin Data-välilehti, Hae dataa -ohjelma tai suora API-kutsu, lukee samat kenttämääritykset.
Tämä sivu käsittelee kenttiä siinä muodossa, kuin ne kohtaat taulua rakentaessasi ja selatessasi. Täydellinen ominaisuusluettelo, indeksit ja tapa, jolla Hae dataa- tai Aseta dataa -ohjelma osoittaa tauluun, löytyvät sivulta Taulu osiosta Building Blocks.
Kuusi kenttätyyppiä, ei muita
Jokainen taulun kenttä on täsmälleen yksi kuudesta tyypistä. Studio näyttää kunkin omalla kuvakkeellaan
ruudukon otsikossa tekstimerkin sijaan, koska sarake on kapea ja kentän tunnus, kuten ORD_Total, vie jo
suurimman osan leveydestä:
Seitsemättä tyyppiä ei ole, eikä omaa voi lisätä. Kenttä, joka ei sovi näihin kuuteen,
kuten rikastekstilohko, tiedosto tai suhde toiseen tauluun, mallinnetaan string-tyyppinä (tunnus,
polku, JSON-koodattu lohko) tai niistä koostuvana array- tai object-tyyppinä. Millekään niistä ei ole
omaa ensimmäisen luokan sarakkeen tyyppiä taulussa.
Mitä kukin tyyppi arvolle oikeasti tekee
Sekä dbs_create että dbs_update muuntavat lähettämäsi arvon kentän ilmoitetun tyypin mukaan
ennen tallennusta, joten kannattaa tietää tarkasti, mitä kukin muunnos tekee, eikä olettaa tuttua
merkitystä:
string
Kaikki, mikä ei jo ole merkkijono, muunnetaan tavallisella merkkijonomuunnoksella. Tyhjä tai
puuttuva arvo tallentuu muodossa "".
number
Tallennetaan Number(value). Arvo, jota ei voi jäsentää äärelliseksi luvuksi, muuttuu arvoksi 0
eikä kirjoitusta hylätä. Tyhjä tai puuttuva arvo tallentuu myös arvona 0.
boolean
Vain kiinteä luettelo merkkejä tulkitaan arvoksi true (Y, 1, true, TRUE, ON, YES), ja toinen
kiinteä luettelo arvoksi false (N, 0, false, FALSE, OFF, NO). Kaikki muu, myös tyhjä
arvo, tallentuu arvona false.
object
Merkkijono jäsennetään JSON5:nä, ja jo objektin muotoinen arvo tallennetaan sellaisenaan. Tyhjä tai
puuttuva arvo tai merkkijono, jota ei voi jäsentää, tallentuu muodossa {}.
array
Merkkijono jäsennetään ensin JSON5:nä, ja jos se epäonnistuu, se arvioidaan JavaScript-literaalina. Jo
taulukon muotoinen arvo tallennetaan sellaisenaan. Tyhjä tai puuttuva arvo tai merkkijono, jota kumpikaan
jäsennys ei käsittele, tallentuu muodossa [].
date
Sisään tullessa ei ole erillistä päivämääräkäsittelyä: mikä tahansa lähettämäsi merkkijono tallennetaan täsmälleen
sellaisenaan. Valitse yksi muoto. ISO 8601 (2026-09-25T00:00:00.000Z) on turvallisin oletus, koska mikään
alustassa ei normalisoi päivämääräkenttää puolestasi, ja taulu, jossa on sekalaisia muotoja, lajittuu ja suodattuu
epäjohdonmukaisesti.
Arvon lähettäminen, josta ei voi tulla kelvollista lukua number-kenttään, ei epäonnistu kutsussa, vaan
tallentaa äänettömästi arvon 0. Tarkista numeerinen arvo itse ennen kirjoitusta, jos 0 olisi väärin.
Kenttien nimeäminen
Muuta nimeämissääntöä kuin kenttätunnusten yksilöllisyyttä taulussa ei pakoteta, mutta jokainen Xuda-projektissa jo oleva taulu
noudattaa yhtä käytäntöä: etuliitteenä jokaisessa kentässä on taulun lyhyt koodi, joten ORD - Orders tuottaa
ORD_Id, ORD_Total, ORD_Status. Se pitää kenttien nimet yksiselitteisinä, kun kysely, lauseke tai
tuontitiedosto viittaa useaan tauluun yhtä aikaa.
Kentän merkitseminen pakolliseksi
Kentällä on pakollisuuslippu, jonka asetat sitä määritellessäsi tyypin ja kommentin rinnalla, kirjaamaan, ettei riviä ole tarkoitus tallentaa ilman arvoa siinä.
Tauluilla on oma aktiivinen/arkistoitu-tila
Erillään siitä, että yksittäinen rivi arkistoidaan (pehmeästi poistetaan, katso Datan kysely API:n kautta), taulu itse voi olla aktiivinen tai arkistoitu Studio-solmuna. Dashboardin Data-välilehti listaa projektin taulut kortteina, joiden välillä voi vaihtaa Käytössä- ja Arkistoitu-näkymän, ja kukin kortti näyttää taulun nimen ja nykyisen rivimäärän. Taulun arkistointi täällä on Studio-puolen toiminto solmulle, ja se on eri toiminto kuin rivien arkistointi sen sisällä.