App-Daten abfragen und schreiben
Lies Zeilen aus einer Studio-Tabelle und füge eine hinzu, von außerhalb der Runtime, mit denselben zwei Methoden, die eine laufende App selbst aufruft.
dbs_read und dbs_create sind dieselben zwei Aufrufe, die ein javascript- oder api-Programm zur Laufzeit
über xu.dbs_read(...) und xu.dbs_create(...) macht, direkt mit einem Konto-API-Schlüssel erreichbar, sodass
dein eigenes Backend die Studio-Tabelle eines Projekts lesen und beschreiben kann, ohne die Runtime
zu durchlaufen. Die projektinterne Seite derselben Methoden findest du unter JavaScript-Framework,
den Rest von data_module unter Entwicklungsplattform.
table_id ist die eigene _id des Tabellenknotens, nie sein Anzeigename. get_progs mit
menu_type: "table" listet jede Tabelle eines Projekts als {_id, properties: {menuName}}-Paare auf, der
günstigste Weg, einen lesbaren Namen der ID zuzuordnen, die diese beiden Methoden brauchen.
Methoden
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.
Schritt für Schritt
Eine Seite mit Zeilen lesen
from/to ist ein Zeilenbereich (from ist der Offset, to - from ist die Seitengröße), und beide sind
optional. Lässt du sie weg, bekommst du die Standardseite der Tabelle. Jeder andere Filter (row_id, query,
sortModel, archived) ist ebenfalls optional.
2. Eine Zeile hinzufügen
table_data ist ein einfaches Objekt, geschlüsselt nach den eigenen Feld-IDs der Tabelle, den Spalten-IDs, die Studio beim
Erstellen der Tabelle vergeben hat, nicht nach generischen Namen. Lies zuerst mit Schritt 1 eine Zeile zurück, wenn du nicht sicher bist,
wie die Felder einer bestimmten Tabelle heißen.
Die Antwort
dbs_read verpackt das Ergebnis des Tabellen-Plugins und ergänzt die eigene Gesamtanzahl der Tabelle:
Jede Zeile ist { id, value }: id ist die eigene Dokument-ID der Zeile (was row_id bei einem späteren Aufruf oder
dbs_update/dbs_delete erwartet), value sind die Felddaten, geschlüsselt wie table_data
gesendet wurde. total_rows zählt diese Seite, total_table_count die ganze Tabelle (nur aktive Zeilen,
außer archived: true wurde gesendet), die Zahl, die ein Steuerelement "Seite 1 von N" lesen würde.
dbs_create antwortet mit dem Schreibvorgang, nicht mit der Zeile:
Lies die neue Zeile mit dbs_read zurück (row_id auf data.id gesetzt), wenn du ihren gespeicherten value brauchst,
dieser Aufruf gibt ihn nicht zurück. Sendest du für table_data ein Array statt eines Objekts, wird jedes
Element in einem Aufruf als eigene Zeile eingefügt, id/rev kommen dann pro Zeile zurück statt einmal.