Dotazování na data aplikace a jejich zápis
Čtěte řádky tabulky Studia a přidejte jeden, mimo runtime, stejnými dvěma metodami, které volá běžící aplikace sama.
dbs_read a dbs_create jsou tytéž dvě volání, která program javascript nebo api provádí za běhu
přes xu.dbs_read(...) a xu.dbs_create(...), dosažitelná přímo s klíčem API účtu, takže váš
vlastní backend může číst a zapisovat tabulku Studia projektu, aniž by procházel runtimem.
Stranu uvnitř projektu týchž metod najdete v části JavaScript Framework
a zbytek data_module v části Vývojářská platforma.
table_id je vlastní _id uzlu tabulky, nikdy její zobrazovaný název. get_progs s
menu_type: "table" vypíše každou tabulku projektu jako dvojice {_id, properties: {menuName}}, což je
nejlevnější způsob, jak převést čitelný název na ID, které tyto dvě metody potřebují.
Metody
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.
Postup
Přečíst stránku řádků
from/to je rozsah řádků (from je posun, to - from je velikost stránky) a obě jsou
volitelné, vynechte je a dostanete výchozí stránku tabulky. Každý další filtr (row_id, query,
sortModel, archived) je také volitelný.
2. Přidat řádek
table_data je prostý objekt s klíči podle vlastních ID polí tabulky, ID sloupců, která Studio přidělilo,
když byla tabulka vytvořena, ne obecných názvů. Nejste-li si jisti, jak se pole dané tabulky jmenují,
nejprve si přečtěte řádek krokem 1.
Odpověď
dbs_read obalí výsledek pluginu tabulky a navrch přidá celkový počet tabulky:
Každý řádek je { id, value }: id je ID dokumentu řádku (to, co očekává row_id v pozdějším volání
nebo dbs_update/dbs_delete), value jsou data polí s klíči stejně, jak byla odeslána v table_data.
total_rows počítá tuto stránku; total_table_count je celá tabulka (jen aktivní řádky,
pokud nebylo odesláno archived: true), číslo, které by četl ovladač „Stránka 1 z N“.
dbs_create odpovídá zápisem, ne řádkem:
Potřebujete-li uloženou value nového řádku, přečtěte ho zpět přes dbs_read (row_id nastavte na data.id),
toto volání ji nevrací. Pošlete-li pro table_data místo jednoho objektu pole, vloží se každý
prvek jako samostatný řádek jedním voláním a id/rev se v tom případě vrací po řádcích, ne jednou.