Tabulky a pole
Sloupce tabulky tvoří uzavřená sada šesti typů, každý se při zápisu přetypuje, plus indexy, díky kterým lze řádek najít.
Tabulka se definuje jednou, ve Xuda Studio, a každé místo, které zobrazuje její data, tedy mřížka ve Studiu, karta Data v dashboardu, program Získat data nebo přímé volání API, čte stejné definice polí.
Tato stránka popisuje pole tak, jak se s nimi setkáte při tvorbě a procházení tabulky. Úplný seznam vlastností, indexy a to, jak program Získat data nebo Nastavit data míří na tabulku, najdete v části Tabulka ve Stavebních blocích.
Šest typů polí, nic jiného
Každé pole tabulky je právě jednoho ze šesti typů. Studio zobrazuje každý vlastní ikonou v
záhlaví mřížky místo textového štítku, protože sloupec je úzký a id pole jako ORD_Total už
zabere většinu šířky:
Sedmý typ neexistuje a vlastní přidat nejde. Pole, které do těchto šesti nezapadá, například
blok formátovaného textu, soubor nebo vztah k jiné tabulce, se modeluje jako string (id, cesta,
blob zakódovaný jako JSON) nebo array/object z nich. Pro nic z toho neexistuje v tabulce
samostatný plnohodnotný typ sloupce.
Co každý typ s hodnotou skutečně dělá
dbs_create i dbs_update před uložením přetypují odeslanou hodnotu podle deklarovaného typu
pole, proto stojí za to vědět přesně, co každé přetypování dělá, místo abyste předpokládali
známý význam:
string
Cokoli, co ještě není řetězec, se převede obyčejným převodem na řetězec. Prázdná nebo chybějící
hodnota se uloží jako "".
number
Uloží se Number(value). Hodnota, kterou nelze převést na konečné číslo, se nahradí 0, zápis
se neodmítne. Prázdná nebo chybějící hodnota se také uloží jako 0.
boolean
Jen pevný seznam tokenů se čte jako true (Y, 1, true, TRUE, ON, YES) a jiný pevný
seznam jako false (N, 0, false, FALSE, OFF, NO). Cokoli jiného, včetně prázdné
hodnoty, se uloží jako false.
object
Řetězec se zpracuje jako JSON5. Hodnota, která už má tvar objektu, se uloží tak, jak je. Prázdná
nebo chybějící hodnota, nebo řetězec, který nejde zpracovat, se uloží jako {}.
array
Řetězec se nejprve zpracuje jako JSON5 a pokud to selže, vyhodnotí se místo toho jako literál
JavaScriptu. Hodnota, která už má tvar pole, se uloží tak, jak je. Prázdná nebo chybějící
hodnota, nebo řetězec, který nezvládne ani jedno zpracování, se uloží jako [].
date
Při zápisu neprobíhá žádné zvláštní zpracování data: jakýkoli řetězec, který pošlete, se uloží
přesně tak, jak byl poslán. Zvolte jeden formát, nejbezpečnější výchozí volbou je ISO 8601
(2026-09-25T00:00:00.000Z), protože platforma pole data nijak nenormalizuje a tabulka se
smíšenými formáty se řadí a filtruje nekonzistentně.
Odeslání hodnoty, která se nedá změnit na platné číslo, do pole number volání neselže, tiše
se uloží 0. Pokud by 0 bylo špatně, číselnou hodnotu si před zápisem ověřte sami.
Pojmenování polí
Kromě jedinečnosti id polí v tabulce není žádné pravidlo vynuceno, ale každá tabulka, která už v
projektu Xuda je, dodržuje jednu konvenci: před každé pole dejte krátký kód samotné tabulky, takže
ORD - Orders vytvoří ORD_Id, ORD_Total, ORD_Status. Názvy polí tak zůstanou jednoznačné,
jakmile se dotaz, výraz nebo importní soubor musí odkazovat na více tabulek najednou.
Označení povinného pole
Pole nese příznak povinnosti, který nastavíte při jeho definici vedle jeho typu a komentáře, aby bylo zaznamenáno, že řádek se nemá ukládat bez hodnoty v tomto poli.
Tabulky mají vlastní stav aktivní/archivováno
Odděleně od toho, že je jednotlivý řádek archivován (jemně smazán, viz Dotazování na data přes API), může být samotná tabulka jako uzel Studia aktivní nebo archivována. Karta Data v dashboardu zobrazuje tabulky projektu jako karty, přepínatelné mezi Aktivní a Archivováno, přičemž každá karta ukazuje název tabulky a aktuální počet řádků. Archivace tabulky zde je akce na straně Studia na uzlu, je to jiná operace než archivace řádků v ní.