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
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.dataSourceTableIdvan een programma Gegevens ophalen, Gegevens instellen of Batch noemt de_idvan 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_idvan 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.
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).