Tabuľky a polia
Stĺpce tabuľky sú uzavretá množina šiestich typov, každý pretypovaný pri vstupe, plus indexy, vďaka ktorým sa dá riadok nájsť.
Tabuľka sa definuje raz, v Xuda Studio, a každé miesto, ktoré zobrazuje jej dáta, mriežka v Studiu, karta Dáta v dashboarde, program Získať dáta alebo priame volanie API, číta tie isté definície polí.
Táto stránka popisuje polia tak, ako sa s nimi stretnete pri tvorbe a prehliadaní tabuľky. Úplný zoznam vlastností, indexy a to, ako program Získať dáta alebo Nastaviť dáta ukazuje na tabuľku, nájdete v časti Table v Building Blocks.
Šesť typov polí, nič iné
Každé pole tabuľky je presne jedného zo šiestich typov. Studio zobrazuje každý vlastnou ikonou v
hlavičke mriežky namiesto textového štítku, pretože stĺpec je úzky a id poľa ako ORD_Total už
zaberá väčšinu šírky:
Siedmy typ neexistuje a vlastný pridať nemožno. Pole, ktoré sa do týchto šiestich nezmestí,
blok formátovaného textu, súbor, vzťah na inú tabuľku, sa modeluje ako string (id, cesta,
blob zakódovaný v JSON) alebo array/object z nich. Pre nič z toho neexistuje samostatný
plnohodnotný typ stĺpca tabuľky.
Čo každý typ s hodnotou skutočne robí
dbs_create aj dbs_update pretypujú hodnotu, ktorú pošlete, cez deklarovaný typ poľa predtým,
než sa uloží, takže stojí za to vedieť presne, čo každé pretypovanie robí, a nepredpokladať známy
význam:
string
Čokoľvek, čo ešte nie je reťazec, sa prevedie obyčajným prevodom na reťazec. Prázdna alebo chýbajúca
hodnota sa uloží ako "".
number
Uloží sa Number(value). Hodnota, ktorá sa nedá previesť na konečné číslo, sa vráti na 0, namiesto
odmietnutia zápisu. Prázdna alebo chýbajúca hodnota sa tiež uloží ako 0.
boolean
Ako true sa číta len pevný zoznam znakov (Y, 1, true, TRUE, ON, YES) a ako false
iný pevný zoznam (N, 0, false, FALSE, OFF, NO). Všetko ostatné, vrátane prázdnej
hodnoty, sa uloží ako false.
object
Reťazec sa spracuje ako JSON5. Hodnota, ktorá už má tvar objektu, sa uloží tak, ako je. Prázdna
alebo chýbajúca hodnota alebo reťazec, ktorý sa nedá spracovať, sa uloží ako {}.
array
Reťazec sa najprv spracuje ako JSON5 a ak to zlyhá, vyhodnotí sa ako literál JavaScriptu. Hodnota,
ktorá už má tvar poľa, sa uloží tak, ako je. Prázdna alebo chýbajúca hodnota alebo reťazec, ktorý
nezvládne ani jedno spracovanie, sa uloží ako [].
date
Pri vstupe neprebieha žiadne osobitné spracovanie dátumu: reťazec, ktorý pošlete, sa uloží presne
tak, ako bol odoslaný. Vyberte jeden formát, najbezpečnejšou predvoľbou je ISO 8601
(2026-09-25T00:00:00.000Z), pretože platforma pole dátumu za vás nijako nenormalizuje a tabuľka
so zmiešanými formátmi sa triedi a filtruje nekonzistentne.
Odoslanie hodnoty, ktorá sa nedá zmeniť na platné číslo, do poľa number volanie nezruší, ticho
uloží 0. Ak by 0 bolo nesprávne, číselnú hodnotu pred zápisom overte sami.
Pomenovanie polí
Okrem jedinečnosti id polí v tabuľke neexistuje žiadne vynucované pravidlo pomenovania, ale každá
tabuľka, ktorá už v projekte Xuda je, dodržiava jednu konvenciu: každé pole sa začína krátkym kódom
samotnej tabuľky, takže ORD - Orders vytvorí ORD_Id, ORD_Total, ORD_Status. Názvy polí
tak zostanú jednoznačné, keď sa dotaz, výraz alebo importný súbor musí odvolávať na viac tabuliek
naraz.
Označenie poľa ako povinného
Pole nesie príznak povinnosti, ktorý nastavíte pri jeho definovaní vedľa jeho typu a komentára, aby ste zaznamenali, že riadok sa nemá ukladať bez hodnoty na tomto mieste.
Tabuľky majú vlastný stav aktívna/archivovaná
Nezávisle od archivovania jedného riadka (mäkké zmazanie, pozri Dopytovanie dát cez API) môže byť aj samotná tabuľka ako uzol Studia aktívna alebo archivovaná. Karta Dáta v dashboarde uvádza tabuľky projektu ako karty s prepínaním medzi Aktívne a Archivované, pričom každá karta ukazuje názov tabuľky a jej aktuálny počet riadkov. Archivovanie tabuľky tu je akcia na strane Studia na uzle, je to iná operácia než archivovanie riadkov v nej.