Ugrás a tartalomhoz
Ellenőrizve

Tábla

Egyetlen adatentitás definíciója, az oszlopai és az indexei, cserélhető adatbázis-meghajtón keresztül tárolva.

A Tábla egy adatentitást határoz meg: az oszlopait, a sorok kereséséhez használt indexeket, és azt, hogy melyik adatbázis-meghajtó tárolja. A programmal ellentétben a Tábla nem hordoz munkafolyamatot, eseményt és felületet, a sémája a teljes szerződés. A Xuda-alkalmazás minden olvasása és írása végül egy Táblára mutat egy Get Data, Set Data, Batch vagy Component adatforráson keresztül.

Tulajdonságok

A tábla a studio_meta.parentId: "database" alatt áll (vagy egy alá ágyazott mappában).

tableFields

Előtagozza az oszlopokat egy táblakóddal

Az "ORD - Orders" nevű tábla minden oszlopát előtagozza: ORD_Id, ORD_Total, ORD_Status. Egyértelműen tartja a mezőneveket, amint több tábla kerül ugyanabba a kifejezésbe, és ez az a konvenció, amelyet a projekt minden meglévő táblája követ.

tableIndexes

A táblának legalább egy mezőre van szüksége, mielőtt indexet hordozhat. Maga az index csak a nem natív adatbázis-meghajtón lévő táblákhoz kötelező, a platform saját motorja (@xuda.io/xuda-dbs-plugin-xuda) a nulla indexű táblát is elfogadja, bár a gyakorlatban minden táblának, amelyet egy Component vagy egy set_data program egyetlen rekordhoz tud kötni, ehhez egyedi <TBL>_Id indexre van szüksége.

Tábla használata

  • Sor olvasása vagy írása: a Get Data, Set Data vagy Batch program progDataSource.dataSourceTableId értéke ennek a táblának az _id azonosítóját nevezi meg.
  • Component közvetlen kötése: ugyanaz a dataSourceTableId / dataSourceIndexId pár, külön program helyett a Componentbe ágyazva.
  • Szkriptből: xu.dbs_create, xu.dbs_read, xu.dbs_update, xu.dbs_delete, a tábla _id azonosítójával hívva, soha nem a nevével.

Kidolgozott példa

Modellezze az oszlopokat

Entitásonként egy tábla, táblánként egy 3 betűs előtag: STU_Student_Id, STU_Full_Name.

Adjon egyedi indexet az azonosítóra

Adjon minden táblának egyedi indexet a <TBL>_Id mezőjén. Az egyetlen rekordot kulcs szerint kötő Componentek és a frissítési vagy törlési módú set_data programok ezen az indexen keresztül oldják fel a célsort.

Mutasson rá egy adatforrást

A Get Data vagy Set Data program dataSourceTableId értéke ennek a táblának az _id azonosítóját nevezi meg; a dataSourceIndexId a tableIndexes egyik azonosítóját.

A Studio fájában az Adatbázis alatt adjon hozzá egy táblát, majd adjon sorokat a Mezők rácsához (azonosító, típus, kötelező) és az Indexek rácsához (név, kulcsok, egyedi). Ugyanazon a csomóponton az Adatok lap közvetlenül mutatja és szerkeszti a sorokat.

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

A táblának nincs .xu forrásformája, az xuda-cli projektek helyette .table.json5 fájlként deklarálják (ez az a fájl, JSON-ként mutatva).

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