Kysele ja kirjoita sovellusdataa
Lue rivejä Studio-taulukosta ja lisää yksi suorituksen ulkopuolelta samoilla kahdella metodilla, joita käynnissä oleva sovellus itse kutsuu.
dbs_read ja dbs_create ovat samat kaksi kutsua, joita javascript- tai api-ohjelma tekee suorituksen aikana kutsuilla xu.dbs_read(...) ja xu.dbs_create(...). Ne ovat tavoitettavissa suoraan tilin API-avaimella, jotta oma taustajärjestelmäsi voi lukea ja kirjoittaa projektin Studio-taulukkoa kulkematta suorituksen läpi lainkaan. Katso JavaScript Framework, miten samat metodit näkyvät projektin sisällä, ja Kehitysalusta data_module:n loppuosalle.
table_id on taulukkosolmun oma _id, ei koskaan sen näyttönimi. get_progs arvolla menu_type: "table" listaa jokaisen projektin taulukon {_id, properties: {menuName}}-pareina, halvin tapa yhdistää lukemasi nimi tunnukseen, jota nämä kaksi metodia tarvitsevat.
Metodit
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.
Läpikäynti
Lue sivu rivejä
from/to on rivialue (from on siirtymä, to - from on sivun koko), ja molemmat ovat valinnaisia: jätä ne pois, niin saat taulukon oletussivun. Kaikki muut suodattimet (row_id, query, sortModel, archived) ovat myös valinnaisia.
2. Lisää rivi
table_data on tavallinen objekti, jonka avaimet ovat taulukon omat kenttätunnukset, sarakkeiden tunnukset, jotka Studio antoi taulukkoa rakennettaessa, ei yleisiä nimiä. Lue ensin rivi takaisin vaiheella 1, jos et ole varma, mitä tietyn taulukon kenttiä kutsutaan.
Vastaus
dbs_read kietoo taulukon lisäosan tuloksen ja lisää sen päälle taulukon oman kokonaismäärän:
Jokainen rivi on { id, value }: id on rivin oma dokumenttitunnus (sitä myöhempi row_id tai dbs_update/dbs_delete odottaa), value on kenttädata samoilla avaimilla kuin table_data lähetettiin. total_rows laskee tämän sivun; total_table_count on koko taulukko (vain aktiiviset rivit, ellei archived: true lähetetty), luku, jonka "Sivu 1 / N" -ohjain lukisi.
dbs_create vastaa kirjoituksella, ei rivillä:
Lue uusi rivi takaisin dbs_read:lla (row_id asetettuna arvoon data.id), jos tarvitset sen tallennetun value:n, sillä tämä kutsu ei kaiuta sitä. Jos lähetät table_data:ksi objektin sijaan taulukon, jokainen alkio lisätään omana rivinään yhdellä kutsulla, ja id/rev palaavat tällöin rivikohtaisesti eikä kerran.