Ερώτημα και εγγραφή δεδομένων εφαρμογής
Διαβάστε γραμμές από έναν πίνακα του Studio, και προσθέστε μία, από έξω από το runtime, με τις ίδιες δύο μεθόδους που καλεί και μια εφαρμογή που εκτελείται.
Τα dbs_read και dbs_create είναι οι ίδιες δύο κλήσεις που κάνει ένα πρόγραμμα javascript ή api κατά το runtime μέσω των xu.dbs_read(...) και xu.dbs_create(...), προσβάσιμες απευθείας με ένα κλειδί API λογαριασμού, ώστε το δικό σας backend να διαβάζει και να γράφει σε έναν πίνακα Studio ενός έργου χωρίς να περνά καθόλου από το runtime. Δείτε το JavaScript Framework για την πλευρά εντός έργου των ίδιων μεθόδων, και την Πλατφόρμα ανάπτυξης για το υπόλοιπο του data_module.
Το table_id είναι το ίδιο το _id του κόμβου του πίνακα, ποτέ το όνομα εμφάνισής του. Το get_progs με menu_type: "table" καταγράφει κάθε πίνακα ενός έργου ως ζεύγη {_id, properties: {menuName}}, ο φθηνότερος τρόπος για να αντιστοιχίσετε ένα όνομα που διαβάζετε με το id που χρειάζονται αυτές οι δύο μέθοδοι.
Μέθοδοι
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.
Οδηγός βήμα προς βήμα
Διαβάστε μια σελίδα γραμμών
Το from/to είναι ένα εύρος γραμμών (το from είναι η μετατόπιση, το to - from είναι το μέγεθος της σελίδας), και τα δύο είναι προαιρετικά: αν τα παραλείψετε παίρνετε την προεπιλεγμένη σελίδα του πίνακα. Κάθε άλλο φίλτρο (row_id, query, sortModel, archived) είναι επίσης προαιρετικό.
2. Προσθέστε μια γραμμή
Το table_data είναι ένα απλό αντικείμενο με κλειδιά τα δικά του αναγνωριστικά πεδίων του πίνακα, τα αναγνωριστικά στηλών που όρισε το Studio όταν χτίστηκε ο πίνακας, όχι γενικά ονόματα. Διαβάστε πρώτα μια γραμμή πίσω με το βήμα 1 αν δεν είστε σίγουροι πώς ονομάζονται τα πεδία ενός συγκεκριμένου πίνακα.
Η απάντηση
Το dbs_read τυλίγει το αποτέλεσμα του plugin του πίνακα και προσθέτει από πάνω το δικό του συνολικό πλήθος του πίνακα:
Κάθε γραμμή είναι { id, value }: το id είναι το id του ίδιου του εγγράφου της γραμμής (αυτό που περιμένει το row_id σε μεταγενέστερη κλήση, ή τα dbs_update/dbs_delete), και το value είναι τα δεδομένα των πεδίων με τα ίδια κλειδιά με τα οποία στάλθηκε το table_data. Το total_rows μετρά αυτή τη σελίδα: το total_table_count είναι ολόκληρος ο πίνακας (μόνο ενεργές γραμμές, εκτός αν στάλθηκε archived: true), ο αριθμός που θα διάβαζε ένα στοιχείο ελέγχου «Σελίδα 1 από N».
Το dbs_create απαντά με την εγγραφή, όχι με τη γραμμή:
Διαβάστε τη νέα γραμμή πίσω με το dbs_read (με το row_id ίσο με data.id) αν χρειάζεστε το αποθηκευμένο value της: αυτή η κλήση δεν το επιστρέφει. Αν στείλετε έναν πίνακα για το table_data αντί για ένα αντικείμενο, κάθε στοιχείο εισάγεται ως δική του γραμμή σε μία κλήση, και τα id/rev επιστρέφονται ανά γραμμή σε αυτή την περίπτωση και όχι μία φορά.