Naar de inhoud springen
Geverifieerd

Tabel

De definitie van één gegevensentiteit, zijn kolommen en zijn indexen, opgeslagen via een verwisselbaar databasestuurprogramma.

Een Tabel definieert één gegevensentiteit: zijn kolommen, de indexen waarmee rijen worden opgezocht en welk databasestuurprogramma hem opslaat. Anders dan een programma heeft een Tabel geen workflow, geen gebeurtenissen en geen UI, zijn schema is het hele contract. Elke leesactie en schrijfactie in een Xuda-app wijst uiteindelijk naar een Tabel via een datasource van Gegevens ophalen, Gegevens instellen, Batch of Component.

Eigenschappen

De tabel staat onder studio_meta.parentId: "database" (of een map die daaronder genest is).

tableFields

Geef kolommen een tabelcode als voorvoegsel

Een tabel met de naam "ORD - Orders" geeft elke kolom een voorvoegsel: ORD_Id, ORD_Total, ORD_Status. Het houdt veldnamen ondubbelzinnig zodra meerdere tabellen in dezelfde expressie staan, en het is de conventie die elke bestaande tabel in een project volgt.

tableIndexes

Een tabel heeft minstens één veld nodig voordat hij een index kan hebben. Een index zelf is alleen verplicht voor tabellen op een niet-eigen databasestuurprogramma; de eigen engine van het platform (@xuda.io/xuda-dbs-plugin-xuda) accepteert een tabel zonder indexen, al heeft in de praktijk elke tabel die een Component of een set_data-programma aan één record kan binden een unieke <TBL>_Id-index nodig om dat te doen.

Een tabel gebruiken

  • Een rij lezen of schrijven: de progDataSource.dataSourceTableId van een programma Gegevens ophalen, Gegevens instellen of Batch noemt de _id van deze tabel.
  • Een Component direct binden: hetzelfde paar dataSourceTableId / dataSourceIndexId, ingebed op de Component in plaats van in een los programma.
  • Vanuit een script: xu.dbs_create, xu.dbs_read, xu.dbs_update, xu.dbs_delete, aangeroepen met de _id van de tabel, nooit met zijn naam.

Uitgewerkt voorbeeld

Modelleer de kolommen

Eén tabel per entiteit, één voorvoegsel van 3 letters per tabel: STU_Student_Id, STU_Full_Name.

Voeg een unieke index op de id toe

Geef elke tabel een unieke index op zijn <TBL>_Id-veld. Components die één record op sleutel binden, en set_data-programma's in de modus bijwerken of verwijderen, bepalen de doelrij via deze index.

Wijs een datasource ernaar

De dataSourceTableId van een programma Gegevens ophalen of Gegevens instellen noemt de _id van deze tabel; dataSourceIndexId noemt een van de id's in tableIndexes.

Voeg onder Database in de Studio-boom een tabel toe, en voeg dan rijen toe aan zijn raster Velden (id, type, verplicht) en zijn raster Indexen (naam, sleutels, uniek). Het tabblad Gegevens op hetzelfde knooppunt toont en bewerkt rijen direct.

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

Een tabel heeft geen bronvorm in .xu, xuda-cli-projecten declareren hem in plaats daarvan als een bestand .table.json5 (dit is dat bestand, getoond als 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"] } }
  ]
}