Interroger et écrire les données d'une application
Lisez des lignes d'une table Studio et ajoutez-en une, depuis l'extérieur du runtime, avec les deux mêmes méthodes qu'une application en cours d'exécution appelle elle-même.
dbs_read et dbs_create sont les deux mêmes appels qu'un programme javascript ou api effectue à l'exécution
via xu.dbs_read(...) et xu.dbs_create(...), accessibles directement avec une clé API de compte pour que votre
propre backend puisse lire et écrire une table Studio d'un projet sans passer du tout par le runtime. Consultez
JavaScript Framework pour le côté intégré au projet des mêmes méthodes, et
Plateforme de développement pour le reste de data_module.
table_id est le _id du nœud de la table, jamais son nom d'affichage. get_progs avec
menu_type: "table" liste chaque table d'un projet sous forme de paires {_id, properties: {menuName}}, le moyen le
plus économique de passer d'un nom que vous savez lire à l'identifiant dont ces deux méthodes ont besoin.
Méthodes
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.
Pas à pas
Lire une page de lignes
from/to est une plage de lignes (from est le décalage, to - from est la taille de la page), et les deux sont
facultatifs : omettez-les et vous obtenez la page par défaut de la table. Tous les autres filtres (row_id, query,
sortModel, archived) sont aussi facultatifs.
2. Ajouter une ligne
table_data est un objet simple indexé par les propres identifiants de champ de la table, les identifiants de
colonne que Studio a attribués à la création de la table, et non des noms génériques. Relisez d'abord une ligne avec
l'étape 1 si vous ne savez pas comment s'appellent les champs d'une table donnée.
La réponse
dbs_read enveloppe le résultat du plugin de la table et y ajoute le total de lignes de la table :
Chaque ligne est { id, value } : id est l'identifiant de document propre à la ligne (ce qu'attend row_id dans un
appel ultérieur, ou dbs_update/dbs_delete), value est la donnée des champs indexée de la même façon que
table_data a été envoyé. total_rows compte cette page ; total_table_count compte toute la table (lignes actives
seulement, sauf si archived: true a été envoyé), le nombre que lirait un contrôle « Page 1 sur N ».
dbs_create répond avec l'écriture, pas avec la ligne :
Relisez la nouvelle ligne avec dbs_read (row_id défini sur data.id) si vous avez besoin de sa value
enregistrée : cet appel ne la renvoie pas. Envoyer un tableau pour table_data au lieu d'un seul objet insère chaque
élément comme sa propre ligne en un seul appel ; id/rev reviennent alors par ligne et non une seule fois.