Μετάβαση στο περιεχόμενο
Επαληθεύτηκε

Ερώτημα και εγγραφή δεδομένων εφαρμογής

Διαβάστε γραμμές από έναν πίνακα του 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

Το table_id είναι το ίδιο το _id του κόμβου του πίνακα, ποτέ το όνομα εμφάνισής του. Το get_progs με menu_type: "table" καταγράφει κάθε πίνακα ενός έργου ως ζεύγη {_id, properties: {menuName}}, ο φθηνότερος τρόπος για να αντιστοιχίσετε ένα όνομα που διαβάζετε με το id που χρειάζονται αυτές οι δύο μέθοδοι.

Μέθοδοι

POST/cpi/dbs_read
user_access

DBS Read

Reads records from an app table with optional row range, single-row lookup, sorting, filtering, and archived-record selection.

POST/cpi/dbs_create
admin

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) είναι επίσης προαιρετικό.

curl -s https://xuda.ai/cpi/dbs_read \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","app_id":"YOUR_APP_ID","table_id":"YOUR_TABLE_ID","from":0,"to":50}'
const res = await fetch('https://xuda.ai/cpi/dbs_read', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    app_id: 'YOUR_APP_ID',
    table_id: 'YOUR_TABLE_ID',
    from: 0,
    to: 50,
  }),
});
const { code, data } = await res.json();
if (code > 0) for (const row of data.rows) console.log(row.id, row.value);
import requests

res = requests.post(
    'https://xuda.ai/cpi/dbs_read',
    json={'api_key': 'YOUR_API_KEY', 'app_id': 'YOUR_APP_ID', 'table_id': 'YOUR_TABLE_ID', 'from': 0, 'to': 50},
)
body = res.json()
if body['code'] > 0:
    for row in body['data']['rows']:
        print(row['id'], row['value'])

2. Προσθέστε μια γραμμή

Το table_data είναι ένα απλό αντικείμενο με κλειδιά τα δικά του αναγνωριστικά πεδίων του πίνακα, τα αναγνωριστικά στηλών που όρισε το Studio όταν χτίστηκε ο πίνακας, όχι γενικά ονόματα. Διαβάστε πρώτα μια γραμμή πίσω με το βήμα 1 αν δεν είστε σίγουροι πώς ονομάζονται τα πεδία ενός συγκεκριμένου πίνακα.

curl -s https://xuda.ai/cpi/dbs_create \
  -H 'content-type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "app_id": "YOUR_APP_ID",
    "table_id": "YOUR_TABLE_ID",
    "table_data": { "CNT_Name": "Priya Shah", "CNT_Email": "[email protected]" }
  }'
const res = await fetch('https://xuda.ai/cpi/dbs_create', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    app_id: 'YOUR_APP_ID',
    table_id: 'YOUR_TABLE_ID',
    table_data: { CNT_Name: 'Priya Shah', CNT_Email: '[email protected]' },
  }),
});
const { code, data } = await res.json();
if (code > 0) console.log(data.id, data.rev);
import requests

res = requests.post(
    'https://xuda.ai/cpi/dbs_create',
    json={
        'api_key': 'YOUR_API_KEY',
        'app_id': 'YOUR_APP_ID',
        'table_id': 'YOUR_TABLE_ID',
        'table_data': {'CNT_Name': 'Priya Shah', 'CNT_Email': '[email protected]'},
    },
)
body = res.json()
if body['code'] > 0:
    print(body['data']['id'], body['data']['rev'])

Η απάντηση

Το dbs_read τυλίγει το αποτέλεσμα του plugin του πίνακα και προσθέτει από πάνω το δικό του συνολικό πλήθος του πίνακα:

json
{
  "code": 1,
  "data": {
    "rows": [
      {
        "id": "dbs-392_tbl_a91f0e_7c2b9a11",
        "value": { "CNT_Name": "Priya Shah", "CNT_Email": "[email protected]" }
      }
    ],
    "total_rows": 1,
    "opt": { "...": "the query options this read actually ran, echoed back for reference" },
    "total_table_count": 42
  }
}

Κάθε γραμμή είναι { id, value }: το id είναι το id του ίδιου του εγγράφου της γραμμής (αυτό που περιμένει το row_id σε μεταγενέστερη κλήση, ή τα dbs_update/dbs_delete), και το value είναι τα δεδομένα των πεδίων με τα ίδια κλειδιά με τα οποία στάλθηκε το table_data. Το total_rows μετρά αυτή τη σελίδα: το total_table_count είναι ολόκληρος ο πίνακας (μόνο ενεργές γραμμές, εκτός αν στάλθηκε archived: true), ο αριθμός που θα διάβαζε ένα στοιχείο ελέγχου «Σελίδα 1 από N».

Το dbs_create απαντά με την εγγραφή, όχι με τη γραμμή:

json
{
  "code": 1,
  "data": {
    "ok": true,
    "id": "dbs-392_tbl_a91f0e_7c2b9a11",
    "rev": "1-9f8e7d6c5b4a3f2e1d0c"
  }
}

Διαβάστε τη νέα γραμμή πίσω με το dbs_read (με το row_id ίσο με data.id) αν χρειάζεστε το αποθηκευμένο value της: αυτή η κλήση δεν το επιστρέφει. Αν στείλετε έναν πίνακα για το table_data αντί για ένα αντικείμενο, κάθε στοιχείο εισάγεται ως δική του γραμμή σε μία κλήση, και τα id/rev επιστρέφονται ανά γραμμή σε αυτή την περίπτωση και όχι μία φορά.

Σφάλματα

Επόμενο