Forespørg og skriv app-data
Læs rækker fra en Studio-tabel, og tilføj en, udefra runtime, med de samme to metoder, en kørende app selv kalder.
dbs_read og dbs_create er de samme to kald, et javascript- eller api-program foretager under kørsel
gennem xu.dbs_read(...) og xu.dbs_create(...), og de kan nås direkte med en konto-API-nøgle, så
din egen backend kan læse og skrive et projekts Studio-tabel uden at gå gennem runtime
overhovedet. Se JavaScript Framework for den side af de samme
metoder, der ligger inde i projektet, og Udviklingsplatform for resten af data_module.
table_id er tabelnodens eget _id, aldrig dens visningsnavn. get_progs med
menu_type: "table" lister alle tabeller i et projekt som {_id, properties: {menuName}}-par, den
billigste måde at koble et navn, du kan læse, til det id, de to metoder skal bruge.
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.
Gennemgang
Læs en side med rækker
from/to er et rækkeinterval (from er forskydningen, to - from er sidestørrelsen), og begge er
valgfrie: udelad dem, og du får tabellens standardside. Alle andre filtre (row_id, query,
sortModel, archived) er også valgfrie.
2. Tilføj en række
table_data er et almindeligt objekt med tabellens egne felt-id'er som nøgler, de kolonne-id'er, Studio tildelte,
da tabellen blev bygget, ikke generiske navne. Læs først en række tilbage med trin 1, hvis du ikke er sikker
på, hvad en given tabels felter hedder.
Svaret
dbs_read pakker tabellens plugin-resultat ind og lægger tabellens egen samlede optælling oveni:
Hver række er { id, value }: id er rækkens eget dokument-id (det, row_id i et senere kald eller
dbs_update/dbs_delete forventer), value er feltdataene med samme nøgler, som table_data
blev sendt med. total_rows tæller denne side; total_table_count er hele tabellen (kun aktive rækker,
medmindre archived: true blev sendt), det tal, en "Side 1 af N"-kontrol ville læse.
dbs_create svarer med skrivningen, ikke rækken:
Læs den nye række tilbage med dbs_read (row_id sat til data.id), hvis du har brug for dens gemte value,
for dette kald giver den ikke tilbage. Hvis du sender et array som table_data i stedet for ét objekt, indsættes hvert
element som sin egen række i ét kald, og id/rev kommer i så fald tilbage pr. række og ikke én gang.