Preskočiť na obsah
Overené

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í.

Úplná referencia schémy

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.

Číslo nikdy neodmietne zápis

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.