Tabelle
Die Definition einer Dateneinheit, ihrer Spalten und Indizes, gespeichert über einen austauschbaren Datenbanktreiber.
Eine Tabelle definiert eine Dateneinheit: ihre Spalten, die Indizes zum Nachschlagen von Zeilen und den Datenbanktreiber, der sie speichert. Anders als ein Programm trägt eine Tabelle keinen Workflow, keine Ereignisse und keine UI, ihr Schema ist der gesamte Vertrag. Jedes Lesen und Schreiben in einer Xuda-App zeigt letztlich über Get Data, Set Data, Batch oder die Datenquelle einer Komponente auf eine Tabelle.
Eigenschaften
Die Tabelle liegt unter studio_meta.parentId: "database" (oder einem darin verschachtelten Ordner).
tableFields
Eine Tabelle namens "ORD - Orders" präfixt jede Spalte: ORD_Id, ORD_Total, ORD_Status. So bleiben Feldnamen eindeutig, sobald mehrere Tabellen im selben Ausdruck stehen, und es ist die Konvention, der jede vorhandene Tabelle in einem Projekt folgt.
tableIndexes
Eine Tabelle braucht mindestens ein Feld, bevor sie einen Index tragen kann. Ein Index selbst ist nur für Tabellen auf einem nicht nativen Datenbanktreiber Pflicht, die eigene Engine der Plattform (@xuda.io/xuda-dbs-plugin-xuda) akzeptiert eine Tabelle ohne Index, doch in der Praxis braucht jede Tabelle, die eine Komponente oder ein set_data-Programm an einen einzelnen Datensatz binden kann, dafür einen eindeutigen Index <TBL>_Id.
Eine Tabelle verwenden
- Eine Zeile lesen oder schreiben:
progDataSource.dataSourceTableIdeines Get-Data-, Set-Data- oder Batch-Programms nennt die_iddieser Tabelle. - Eine Komponente direkt binden: dasselbe Paar
dataSourceTableId/dataSourceIndexId, statt in einem eigenen Programm in die Komponente eingebettet. - Aus einem Skript:
xu.dbs_create,xu.dbs_read,xu.dbs_update,xu.dbs_delete, aufgerufen mit der_idder Tabelle, nie mit ihrem Namen.
Praxisbeispiel
Die Spalten modellieren
Eine Tabelle pro Einheit, ein 3-Buchstaben-Präfix pro Tabelle: STU_Student_Id, STU_Full_Name.
Einen eindeutigen Index auf die ID legen
Gib jeder Tabelle einen eindeutigen Index auf ihr Feld <TBL>_Id. Komponenten, die einen einzelnen Datensatz über den Schlüssel binden, und set_data-Programme im Update- oder Löschmodus lösen die Zielzeile über diesen Index auf.
Eine Datenquelle darauf richten
dataSourceTableId eines Get-Data- oder Set-Data-Programms nennt die _id dieser Tabelle; dataSourceIndexId nennt eine der IDs in tableIndexes.
Füge unter Datenbank im Studio-Baum eine Tabelle hinzu und dann Zeilen zu ihrem Raster Felder (ID, Typ, Pflichtfeld) und ihrem Raster Indizes (Name, Schlüssel, eindeutig). Der Tab Daten am selben Knoten zeigt und bearbeitet Zeilen direkt.
Eine Tabelle hat keine .xu-Quellform, xuda-cli-Projekte deklarieren sie stattdessen als Datei .table.json5 (das ist diese Datei, als JSON gezeigt).