Přeskočit na obsah
Ověřeno

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

Úplný popis schématu

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

Číslo nikdy nezamítne zápis

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