Fråga och skriv appdata
Läs rader från en Studio-tabell, och lägg till en, utanför körmiljön, med samma två metoder som en körande app själv anropar.
dbs_read och dbs_create är samma två anrop som ett javascript- eller api-program gör under
körning genom xu.dbs_read(...) och xu.dbs_create(...), nåbara direkt med en API-nyckel för kontot
så att din egen backend kan läsa och skriva ett projekts Studio-tabell utan att gå via körmiljön
alls. Se JavaScript Framework för sidan inuti projektet av samma
metoder, och Utvecklingsplattform för resten av data_module.
table_id är tabellnodens eget _id, aldrig dess visningsnamn. get_progs med
menu_type: "table" listar varje tabell i ett projekt som par av {_id, properties: {menuName}},
det billigaste sättet att koppla ett namn du kan läsa till det id som de här två metoderna behöver.
Metoder
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.
Genomgång
Läs en sida med rader
from/to är ett radintervall (from är förskjutningen, to - from är sidstorleken), och båda är
valfria, utelämna dem så får du tabellens standardsida. Alla andra filter (row_id, query,
sortModel, archived) är också valfria.
2. Lägg till en rad
table_data är ett vanligt objekt med tabellens egna fält-id som nycklar, de kolumn-id som Studio
tilldelade när tabellen byggdes, inte generiska namn. Läs tillbaka en rad med steg 1 först om du
inte är säker på vad en viss tabells fält heter.
Svaret
dbs_read omsluter tabellens pluginresultat och lägger till tabellens eget totala antal ovanpå:
Varje rad är { id, value }: id är radens eget dokument-id (det som row_id i ett senare anrop,
eller dbs_update/dbs_delete, förväntar sig), value är fältdatan med samma nycklar som
table_data skickades med. total_rows räknar den här sidan; total_table_count är hela tabellen
(bara aktiva rader, om inte archived: true skickades), det tal som en kontroll av typen "Sida 1 av
N" skulle läsa.
dbs_create svarar med skrivningen, inte raden:
Läs tillbaka den nya raden med dbs_read (row_id satt till data.id) om du behöver dess sparade
value, det här anropet ekar den inte. Om du skickar en array för table_data i stället för ett
objekt läggs varje element in som en egen rad i ett anrop, och då kommer id/rev tillbaka per rad
i stället för en gång.