Tabulka
Definice jedné datové entity, jejích sloupců a indexů, uložená přes zásuvný databázový ovladač.
Tabulka (Table) definuje jednu datovou entitu: její sloupce, indexy sloužící k vyhledání řádků a databázový ovladač, který ji ukládá. Na rozdíl od programu Tabulka nenese žádné workflow, události ani UI, jejím celým kontraktem je schéma. Každé čtení a zápis v aplikaci Xuda nakonec míří na Tabulku přes zdroj dat programu Získat data, Nastavit data, Dávka nebo Komponenty.
Vlastnosti
Tabulka leží pod studio_meta.parentId: "database" (nebo ve složce vnořené pod ní).
tableFields
Tabulka pojmenovaná "ORD - Orders" dává předponu každému sloupci: ORD_Id, ORD_Total, ORD_Status. Názvy polí tak zůstanou jednoznačné, jakmile je v jednom výrazu víc tabulek, a je to konvence, kterou sledují všechny existující tabulky v projektu.
tableIndexes
Tabulka potřebuje aspoň jedno pole, než může nést index. Samotný index je povinný jen u tabulek na nenativním databázovém ovladači, vlastní engine platformy (@xuda.io/xuda-dbs-plugin-xuda) přijme tabulku bez indexů, ačkoli v praxi každá tabulka, kterou Komponenta nebo program set_data může navázat na jediný záznam, k tomu potřebuje jedinečný index <TBL>_Id.
Použití tabulky
- Čtení nebo zápis řádku:
progDataSource.dataSourceTableIdprogramu Získat data, Nastavit data nebo Dávka pojmenovává_idtéto tabulky. - Přímá vazba Komponenty: stejná dvojice
dataSourceTableId/dataSourceIndexId, vložená na Komponentu místo samostatného programu. - Ze skriptu:
xu.dbs_create,xu.dbs_read,xu.dbs_update,xu.dbs_delete, volané s_idtabulky, nikdy s jejím názvem.
Pracovní příklad
Namodelujte sloupce
Jedna tabulka na entitu, jedna tříznaková předpona na tabulku: STU_Student_Id, STU_Full_Name.
Přidejte jedinečný index na id
Dejte každé tabulce jedinečný index na jejím poli <TBL>_Id. Komponenty, které vážou jediný záznam podle klíče, a programy set_data v režimu aktualizace nebo smazání, cílový řádek určují přes tento index.
Namiřte na ni zdroj dat
dataSourceTableId programu Získat data nebo Nastavit data pojmenovává _id této tabulky; dataSourceIndexId pojmenovává jedno z id v tableIndexes.
Pod Databází ve stromu Studia přidejte tabulku, pak přidejte řádky do její mřížky Pole (id, typ, povinné) a její mřížky Indexy (název, klíče, jedinečné). Karta Údaje na stejném uzlu zobrazuje a upravuje řádky přímo.
Tabulka nemá zdrojovou podobu .xu, projekty xuda-cli ji deklarují jako soubor .table.json5 (toto je tento soubor, zobrazený jako JSON).