Interoghează și scrie date de aplicație
Citește rânduri dintr-un tabel Studio și adaugă unul, din afara runtime-ului, cu aceleași două metode pe care le apelează o aplicație în execuție.
dbs_read și dbs_create sunt aceleași două apeluri pe care un program javascript sau api le
face la runtime prin xu.dbs_read(...) și xu.dbs_create(...), accesibile direct cu o cheie API de
cont, astfel încât propriul tău backend să poată citi și scrie un tabel Studio al unui proiect fără
să treacă deloc prin runtime. Vezi JavaScript Framework pentru partea
din interiorul proiectului a acelorași metode și Development platform
pentru restul lui data_module.
table_id este _id-ul propriu al nodului tabelului, niciodată numele afișat. get_progs cu
menu_type: "table" listează fiecare tabel dintr-un proiect ca perechi {_id, properties: {menuName}},
cea mai ieftină cale de a asocia un nume pe care îl poți citi cu id-ul de care au nevoie aceste două
metode.
Metode
DBS Read
Reads records from an app table with optional row range, single-row lookup, sorting, filtering, and archived-record selection.
DBS Create
Creates a new record in the specified app table from the provided key-value table data.
Parcurgere
Citește o pagină de rânduri
from/to este un interval de rânduri (from este decalajul, to - from este dimensiunea
paginii), iar ambele sunt opționale, omite-le și primești pagina implicită a tabelului. Toate
celelalte filtre (row_id, query, sortModel, archived) sunt de asemenea opționale.
2. Adaugă un rând
table_data este un obiect simplu având drept chei id-urile câmpurilor proprii ale tabelului,
id-urile de coloană atribuite de Studio la construirea tabelului, nu nume generice. Citește mai întâi
un rând cu pasul 1 dacă nu ești sigur cum se numesc câmpurile unui anumit tabel.
Răspunsul
dbs_read învelește rezultatul pluginului tabelului și adaugă deasupra numărul total propriu al
tabelului:
Fiecare rând este { id, value }: id este id-ul documentului propriu al rândului (ce așteaptă
row_id într-un apel ulterior sau dbs_update/dbs_delete), value este datele câmpurilor, cu
aceleași chei cu care a fost trimis table_data. total_rows numără această pagină;
total_table_count este întregul tabel (doar rândurile active, dacă nu s-a trimis archived: true),
numărul pe care l-ar citi un control „Pagina 1 din N”.
dbs_create răspunde cu scrierea, nu cu rândul:
Citește rândul nou înapoi cu dbs_read (row_id setat la data.id) dacă ai nevoie de value-ul
stocat, acest apel nu îl returnează. Dacă trimiți un șir pentru table_data în loc de un singur
obiect, fiecare element este inserat ca rând propriu într-un singur apel, iar id/rev revin în
acest caz pe fiecare rând, nu o singură dată.