Tabela
Definicja jednej encji danych, jej kolumn i indeksów, przechowywanej przez wymienny sterownik bazy danych.
Tabela definiuje jedną encję danych: jej kolumny, indeksy używane do wyszukiwania wierszy i sterownik bazy danych, który ją przechowuje. W odróżnieniu od programu Tabela nie niesie przepływu pracy, zdarzeń ani interfejsu; jej schemat jest całą umową. Każdy odczyt i zapis w aplikacji Xuda ostatecznie wskazuje na Tabelę przez Get Data, Set Data, Batch lub źródło danych Component.
Właściwości
Tabela leży pod studio_meta.parentId: "database" (albo folderem zagnieżdżonym pod nim).
tableFields
Tabela o nazwie "ORD - Orders" poprzedza każdą kolumnę: ORD_Id, ORD_Total, ORD_Status. Dzięki temu nazwy pól pozostają jednoznaczne, gdy w jednym wyrażeniu jest kilka tabel, i jest to konwencja, której trzyma się każda istniejąca tabela w projekcie.
tableIndexes
Tabela potrzebuje co najmniej jednego pola, zanim będzie mogła mieć indeks. Sam indeks jest obowiązkowy tylko dla tabel na nienatywnym sterowniku bazy danych; własny silnik platformy (@xuda.io/xuda-dbs-plugin-xuda) przyjmuje tabelę bez żadnych indeksów, choć w praktyce każda tabela, którą Component lub program set_data może powiązać z pojedynczym rekordem, potrzebuje do tego unikalnego indeksu <TBL>_Id.
Korzystanie z tabeli
- Odczyt lub zapis wiersza:
progDataSource.dataSourceTableIdprogramu Get Data, Set Data lub Batch wskazuje_idtej tabeli. - Powiązanie Component bezpośrednio: ta sama para
dataSourceTableId/dataSourceIndexId, osadzona w Component zamiast w osobnym programie. - Ze skryptu:
xu.dbs_create,xu.dbs_read,xu.dbs_update,xu.dbs_delete, wywoływane z_idtabeli, nigdy z jej nazwą.
Przykład krok po kroku
Zamodeluj kolumny
Jedna tabela na encję, jeden 3-literowy prefiks na tabelę: STU_Student_Id, STU_Full_Name.
Dodaj unikalny indeks na identyfikatorze
Daj każdej tabeli unikalny indeks na jej polu <TBL>_Id. Component, które wiążą pojedynczy rekord po kluczu, i programy set_data w trybie aktualizacji lub usuwania znajdują docelowy wiersz przez ten indeks.
Wskaż na nią źródło danych
dataSourceTableId programu Get Data lub Set Data wskazuje _id tej tabeli; dataSourceIndexId wskazuje jeden z identyfikatorów w tableIndexes.
W Bazie danych w drzewie Studio dodaj tabelę, a potem dodaj wiersze do jej siatki Pola (identyfikator, typ, wymagane) i siatki Indeksy (nazwa, klucze, unikalny). Karta Dane na tym samym węźle pokazuje i edytuje wiersze bezpośrednio.
Tabela nie ma formy źródłowej .xu; projekty xuda-cli deklarują ją jako plik .table.json5 (to jest ten plik, pokazany jako JSON).