Zapytaj o dane aplikacji i zapisz je
Odczytaj wiersze z tabeli Studio i dodaj jeden, spoza środowiska uruchomieniowego, tymi samymi dwiema metodami, które wywołuje działająca aplikacja.
dbs_read i dbs_create to te same dwa wywołania, które program javascript lub api wykonuje w
czasie działania przez xu.dbs_read(...) i xu.dbs_create(...), osiągalne bezpośrednio kluczem API
konta, żeby Twój własny backend mógł czytać i zapisywać tabelę Studio projektu w ogóle bez
przechodzenia przez środowisko uruchomieniowe. Zobacz Framework JavaScript,
żeby poznać stronę tych samych metod wewnątrz projektu, oraz Platforma programistyczna,
żeby poznać resztę data_module.
table_id to własne _id węzła tabeli, nigdy jej nazwa wyświetlana. get_progs z
menu_type: "table" wylistuje każdą tabelę w projekcie jako pary {_id, properties: {menuName}},
najtańszy sposób, żeby przełożyć czytelną nazwę na identyfikator, którego potrzebują te dwie metody.
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.
Krok po kroku
Odczytaj stronę wierszy
from/to to zakres wierszy (from to przesunięcie, to - from to rozmiar strony), a oba są
opcjonalne: pomiń je, a dostaniesz domyślną stronę tabeli. Każdy inny filtr (row_id, query,
sortModel, archived) też jest opcjonalny.
2. Dodaj wiersz
table_data to zwykły obiekt kluczowany własnymi identyfikatorami pól tabeli, identyfikatorami
kolumn, które Studio przypisało przy budowaniu tabeli, a nie ogólnymi nazwami. Jeśli nie jesteś
pewien, jak nazywają się pola danej tabeli, najpierw odczytaj wiersz krokiem 1.
Odpowiedź
dbs_read opakowuje wynik wtyczki tabeli i dodaje na wierzchu łączną liczbę wierszy samej tabeli:
Każdy wiersz to { id, value }: id to własny identyfikator dokumentu wiersza (tego oczekuje
row_id w późniejszym wywołaniu albo dbs_update/dbs_delete), value to dane pól kluczowane
tak samo, jak wysłano table_data. total_rows zlicza tę stronę; total_table_count to cała
tabela (tylko aktywne wiersze, chyba że wysłano archived: true), liczba, którą odczytałby
element „Strona 1 z N".
dbs_create odpowiada zapisem, a nie wierszem:
Odczytaj nowy wiersz z powrotem przez dbs_read (row_id ustawione na data.id), jeśli
potrzebujesz jego zapisanej wartości value, bo to wywołanie jej nie zwraca. Wysłanie tablicy w
table_data zamiast jednego obiektu wstawia każdy element jako osobny wiersz w jednym wywołaniu,
a id/rev wracają wtedy dla każdego wiersza, a nie raz.