Ugrás a tartalomhoz
Ellenőrizve

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.

A teljes séma-referencia

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.

A number sosem utasít el írást

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.