Tabuľka
Definícia jednej dátovej entity, jej stĺpcov a indexov, uložená cez zásuvný databázový ovládač.
Tabuľka definuje jednu dátovú entitu: jej stĺpce, indexy použité na vyhľadávanie riadkov a databázový ovládač, ktorý ju ukladá. Na rozdiel od programu Tabuľka nenesie žiadny pracovný postup, udalosti ani UI, jej schéma je celá zmluva. Každé čítanie a zápis v aplikácii Xuda nakoniec ukazuje na Tabuľku cez Získať dáta, Nastaviť dáta, Batch alebo zdroj dát Komponentu.
Vlastnosti
Tabuľka sedí pod studio_meta.parentId: "database" (alebo pod priečinkom vnoreným pod ním).
tableFields
Tabuľka s názvom "ORD - Orders" dáva predponu každému stĺpcu: ORD_Id, ORD_Total, ORD_Status. Udržiava názvy polí jednoznačné, keď je vo výraze niekoľko tabuliek, a je to konvencia, ktorú dodržiava každá existujúca tabuľka v projekte.
tableIndexes
Tabuľka potrebuje aspoň jedno pole, než môže niesť index. Samotný index je povinný len pre tabuľky na nenatívnom databázovom ovládači, vlastné jadro platformy (@xuda.io/xuda-dbs-plugin-xuda) prijme tabuľku s nulou indexov, hoci v praxi každá tabuľka, ktorú môže Komponent alebo program set_data viazať na jeden záznam, na to potrebuje jedinečný index <TBL>_Id.
Používanie tabuľky
- Čítanie alebo zápis riadka:
progDataSource.dataSourceTableIdprogramu Získať dáta, Nastaviť dáta alebo Batch pomenúva_idtejto tabuľky. - Priama väzba Komponentu: rovnaká dvojica
dataSourceTableId/dataSourceIndexId, vložená do Komponentu namiesto samostatného programu. - Zo skriptu:
xu.dbs_create,xu.dbs_read,xu.dbs_update,xu.dbs_delete, volané s_idtabuľky, nikdy s jej názvom.
Ukážkový príklad
Namodelujte stĺpce
Jedna tabuľka na entitu, jedna 3-písmenová predpona na tabuľku: STU_Student_Id, STU_Full_Name.
Pridajte jedinečný index na id
Dajte každej tabuľke jedinečný index na jej poli <TBL>_Id. Komponenty, ktoré viažu jeden záznam podľa kľúča, a programy set_data v režime aktualizácie alebo odstránenia nájdu cieľový riadok cez tento index.
Nasmerujte naň zdroj dát
dataSourceTableId programu Získať dáta alebo Nastaviť dáta pomenúva _id tejto tabuľky; dataSourceIndexId pomenúva jedno z id v tableIndexes.
Pod Databázou v strome Studia pridajte tabuľku, potom pridajte riadky do jej mriežky Polia (id, typ, povinné) a mriežky Indexy (názov, kľúče, jedinečný). Karta Dáta na tom istom uzle zobrazuje a upravuje riadky priamo.
Tabuľka nemá zdrojovú formu .xu, projekty xuda-cli ju deklarujú namiesto toho ako súbor .table.json5 (toto je ten súbor, zobrazený ako JSON).