Dotazovať a zapisovať dáta aplikácie
Čítajte riadky z tabuľky Studio a pridávajte ich zvonka runtime, tými istými dvoma metódami, aké volá samotná bežiaca aplikácia.
dbs_read a dbs_create sú tie isté dve volania, aké program javascript alebo api robí za
behu cez xu.dbs_read(...) a xu.dbs_create(...), dostupné priamo s API kľúčom účtu, takže váš
vlastný backend môže čítať a zapisovať do tabuľky Studio projektu bez toho, aby prechádzal
runtime. Stranu tých istých metód vo vnútri projektu nájdete v časti
JavaScript Framework a zvyšok data_module v časti
Development platform.
table_id je vlastné _id uzla tabuľky, nikdy nie jej zobrazovaný názov. get_progs s
menu_type: "table" vypíše každú tabuľku v projekte ako dvojice {_id, properties: {menuName}},
čo je najlacnejší spôsob, ako priradiť čitateľný názov k ID, ktoré tieto dve metódy potrebujú.
Methods
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.
Walkthrough
Read a page of rows
from/to je rozsah riadkov (from je posun, to - from je veľkosť stránky) a obe sú
voliteľné, ak ich vynecháte, dostanete predvolenú stránku tabuľky. Každý ďalší filter (row_id,
query, sortModel, archived) je tiež voliteľný.
2. Add a row
table_data je obyčajný objekt s kľúčmi podľa vlastných ID polí tabuľky, teda ID stĺpcov, ktoré
Studio pridelilo pri zostavení tabuľky, nie všeobecných názvov. Ak si nie ste istí, ako sa polia
danej tabuľky volajú, najprv si prečítajte riadok späť krokom 1.
The response
dbs_read obalí výsledok pluginu tabuľky a navrch pridá vlastný celkový počet tabuľky:
Každý riadok je { id, value }: id je vlastné ID dokumentu riadku (čo očakáva row_id v
neskoršom volaní alebo dbs_update/dbs_delete), value sú dáta polí s rovnakými kľúčmi, aké
sa poslali v table_data. total_rows počíta túto stránku; total_table_count je celá tabuľka
(len aktívne riadky, ak sa neposlalo archived: true), číslo, ktoré by čítal ovládací prvok
„Strana 1 z N“.
dbs_create odpovie zápisom, nie riadkom:
Ak potrebujete uloženú value, prečítajte nový riadok späť cez dbs_read (row_id nastavené
na data.id), toto volanie ju nevracia. Poslanie poľa v table_data namiesto jedného objektu
vloží každý prvok ako samostatný riadok jedným volaním, id/rev sa v tom prípade vrátia na
každý riadok, nie raz.