Táblák és mezők
A tábla oszlopai hat típusból álló zárt készletből kerülnek ki, mindegyik beíráskor átalakul, plusz az indexek, amelyek egy sort megtalálhatóvá tesznek.
A táblát egyszer, a Xuda Studióban kell megadni, és minden hely, amely az adatait mutatja, a Studio rácsa, az irányítópult Adatok lapja, egy Adatok lekérése program vagy egy közvetlen API-hívás, ugyanazokat a mezőmeghatározásokat olvassa.
Ez az oldal a mezőket úgy tárgyalja, ahogyan egy tábla építésekor és böngészésekor találkozik velük. A tulajdonságok teljes listájáról, az indexekről, és arról, hogyan mutat egy Adatok lekérése vagy Adatok beállítása program egy táblára, lásd a Building Blocks részben a Tábla oldalt.
Hat mezőtípus, más nincs
A tábla minden mezője pontosan egy a hat típus közül. A Studio mindegyiket saját ikonnal mutatja a rács
fejlécében szöveges jelvény helyett, mert egy oszlop keskeny, és egy olyan mezőazonosító, mint az ORD_Total,
már a szélesség nagy részét elfoglalja:
Hetedik típus nincs, és sajátot sem lehet hozzáadni. Az a mező, amely nem fér bele ebbe a hatba, például egy
formázott szövegblokk, egy fájl vagy egy másik táblához fűződő kapcsolat, string típusként (azonosító, útvonal,
JSON-ként kódolt adat) vagy ezek array/object típusú gyűjteményeként van modellezve, ezek egyikéhez sincs
külön, elsőrendű oszloptípus a táblán.
Mit csinál valójában az egyes típus egy értékkel
A dbs_create és a dbs_update is a mező deklarált típusán keresztül alakítja át az elküldött értéket, mielőtt
eltárolja, ezért érdemes pontosan tudni, mit csinál az egyes átalakítás, ahelyett hogy ismerős jelentést
feltételezne:
string
Ami még nem szöveg, azt egyszerű szöveggé alakítással konvertálja. Az üres vagy hiányzó érték ""
formában tárolódik.
number
A Number(value) eredménye tárolódik. Az az érték, amely nem értelmezhető véges számként, 0-ra esik vissza
az írás elutasítása helyett. Az üres vagy hiányzó érték szintén 0-ként tárolódik.
boolean
Csak egy rögzített tokenlista olvasódik true értékként (Y, 1, true, TRUE, ON, YES), és egy másik
rögzített lista false értékként (N, 0, false, FALSE, OFF, NO). Minden más, az üres érték is,
false formában tárolódik.
object
A szöveget JSON5-ként értelmezi. Az objektum alakú érték változatlanul tárolódik. Az üres vagy hiányzó érték,
vagy az a szöveg, amely nem értelmezhető, {} formában tárolódik.
array
A szöveget először JSON5-ként értelmezi, és ha az nem sikerül, JavaScript-literálként értékeli ki. A tömb
alakú érték változatlanul tárolódik. Az üres vagy hiányzó érték, vagy az a szöveg, amelyet egyik értelmezés sem
kezel, [] formában tárolódik.
date
A beíráskor nincs külön dátumkezelés: bármilyen szöveget küld, pontosan úgy tárolódik, ahogy küldte.
Válasszon egy formátumot, az ISO 8601 (2026-09-25T00:00:00.000Z) a legbiztonságosabb alapértelmezés, mert a
platformon semmi sem normalizálja Önnek a dátummezőt, és a vegyes formátumú tábla következetlenül rendez és
szűr.
Ha egy number mezőnek olyan értéket küld, amely nem válhat érvényes számmá, a hívás nem hiúsul meg, hanem
csendben 0-t tárol. Ha a 0 hibás lenne, a szám értékét írás előtt ellenőrizze saját maga.
A mezők elnevezése
Nincs kikényszerített elnevezési szabály azon túl, hogy a mezőazonosítók egyediek legyenek a táblán, de minden
Xuda-projektben már meglévő tábla egy megállapodást követ: minden mező elé a tábla rövid kódját írják, így az
ORD - Orders az ORD_Id, ORD_Total, ORD_Status mezőket adja. Ez egyértelműen tartja a mezőneveket, amikor
egy lekérdezésnek, kifejezésnek vagy importfájlnak egyszerre több táblára kell hivatkoznia.
Mező kötelezővé tétele
A mező kötelező jelzőt hordoz, amelyet a megadásakor állít be a típusa és a megjegyzése mellett, annak rögzítésére, hogy a sort nem szabad érték nélkül menteni ott.
A tábláknak saját aktív/archivált állapotuk van
Attól függetlenül, hogy egy-egy sor archiválva van (puha törlés, lásd Adatok lekérdezése az API-n keresztül), maga a tábla is lehet aktív vagy archivált Studio-csomópontként. Az irányítópult Adatok lapja a projekt tábláit kártyákként listázza, Aktív és Archiválva között váltható, mindegyik kártya a tábla nevét és az aktuális sorszámát mutatja. A tábla archiválása itt a csomóponton végzett Studio-oldali művelet, és más művelet, mint a benne lévő sorok archiválása.