Hopp til innholdet
Bekreftet

Tabell

Definisjonen av én dataenhet, kolonnene og indeksene, lagret gjennom en utskiftbar databasedriver.

En Tabell definerer én dataenhet: kolonnene, indeksene som brukes til å slå opp rader, og hvilken databasedriver som lagrer den. I motsetning til et program har en Tabell ingen arbeidsflyt, ingen hendelser og ingen UI, skjemaet er hele kontrakten. Hver lesing og skriving i en Xuda-app peker til slutt på en Tabell gjennom en Get Data-, Set Data-, Batch- eller Component-datakilde.

Egenskaper

Tabellen ligger under studio_meta.parentId: "database" (eller en mappe nestet under den).

tableFields

Gi kolonnene et tabellprefiks

En tabell som heter "ORD - Orders" gir hver kolonne prefiks: ORD_Id, ORD_Total, ORD_Status. Det holder feltnavn entydige når flere tabeller står i samme uttrykk, og det er konvensjonen hver eksisterende tabell i et prosjekt følger.

tableIndexes

En tabell trenger minst ett felt før den kan ha en indeks. En indeks i seg selv er bare obligatorisk for tabeller på en annen databasedriver enn den innebygde. Plattformens egen motor (@xuda.io/xuda-dbs-plugin-xuda) godtar en tabell uten indekser, men i praksis trenger hver tabell som en Component eller et set_data-program kan binde til én enkelt post en unik <TBL>_Id-indeks for å gjøre det.

Å bruke en tabell

  • Les eller skriv en rad: progDataSource.dataSourceTableId i et Get Data-, Set Data- eller Batch-program navngir denne tabellens _id.
  • Bind en Component direkte: det samme paret dataSourceTableId / dataSourceIndexId, innebygd på Component-en i stedet for et eget program.
  • Fra et skript: xu.dbs_create, xu.dbs_read, xu.dbs_update, xu.dbs_delete, kalt med tabellens _id, aldri navnet.

Eksempel

Modeller kolonnene

Én tabell per enhet, ett prefiks på 3 bokstaver per tabell: STU_Student_Id, STU_Full_Name.

Legg til en unik indeks på id-en

Gi hver tabell en unik indeks på sitt <TBL>_Id-felt. Components som binder en enkelt post med nøkkel, og set_data-programmer i oppdaterings- eller slettemodus, finner målraden gjennom denne indeksen.

Pek en datakilde mot den

dataSourceTableId i et Get Data- eller Set Data-program navngir denne tabellens _id. dataSourceIndexId navngir en av id-ene i tableIndexes.

Under Database i Studio-treet legger du til en tabell, og så rader i Felt-rutenettet (id, type, påkrevd) og Indekser-rutenettet (navn, nøkler, unik). Fanen Data på samme node viser og redigerer rader direkte.

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

En tabell har ingen .xu-kildeform, xuda-cli-prosjekter deklarerer den som en .table.json5-fil i stedet (dette er den filen, vist som 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"] } }
  ]
}