Preskočiť na obsah
Overené

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

Dajte stĺpcom predponu s kódom tabuľky

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.dataSourceTableId programu Získať dáta, Nastaviť dáta alebo Batch pomenúva _id tejto 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 _id tabuľ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.

json
{
  "id": "student_profiles_table",
  "menuTitle": "Student Profiles Table",
  "fields": [
    { "field_id": "student_id", "type": "string" },
    { "field_id": "full_name", "type": "string" },
    { "field_id": "campus", "type": "string" }
  ],
  "indexes": [
    { "id": "student_idx", "name": "Student", "keys": ["student_id"] },
    { "id": "campus_idx", "name": "Campus", "keys": ["campus"] }
  ]
}

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

json
{
  "properties": {
    "menuType": "table",
    "menuName": "STU - Students",
    "databaseSocket": "@xuda.io/xuda-dbs-plugin-xuda"
  },
  "tableFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "STU_Student_Id" }, "props": { "fieldType": "string", "mandatory": true } },
    { "id": "c3d4e5f6-…", "data": { "field_id": "STU_Full_Name" }, "props": { "fieldType": "string", "mandatory": true } }
  ],
  "tableIndexes": [
    { "id": "a1b2c3d4-…", "data": { "name": "Index_0", "unique": true, "keys": ["STU_Student_Id"] } }
  ]
}