Přeskočit na obsah
Ověřeno

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

Dejte sloupcům předponu kódu tabulky

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.dataSourceTableId programu Získat data, Nastavit data nebo Dávka pojmenovává _id té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 _id tabulky, 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.

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"] }
  ]
}

Tabulka nemá zdrojovou podobu .xu, projekty xuda-cli ji deklarují jako soubor .table.json5 (toto je tento soubor, zobrazený jako 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"] } }
  ]
}