דילוג לתוכן
אומת

שאילתה וכתיבה של נתוני אפליקציה

קריאת שורות מטבלת Studio והוספת שורה, מחוץ לסביבת ההרצה, באותן שתי שיטות שאפליקציה רצה קוראת להן בעצמה.

dbs_read ו-dbs_create הן אותן שתי קריאות שתוכנית javascript או api מבצעת בזמן הרצה דרך xu.dbs_read(...) ו-xu.dbs_create(...), נגישות ישירות עם מפתח API של חשבון כדי שה-backend שלכם יוכל לקרוא ולכתוב לטבלת Studio של פרויקט בלי לעבור דרך סביבת ההרצה בכלל. ראו JavaScript Framework לצד שבתוך הפרויקט של אותן שיטות, ו-פלטפורמת פיתוח לשאר data_module.

איך מוצאים table_id

table_id הוא ה-_id של צומת הטבלה עצמו, אף פעם לא שם התצוגה שלה. get_progs עם menu_type: "table" מפרטת כל טבלה בפרויקט כזוגות {_id, properties: {menuName}}, הדרך הזולה ביותר למפות שם שאפשר לקרוא אל המזהה ששתי השיטות האלה צריכות.

שיטות

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 עוטפת את תוצאת התוסף של הטבלה ומוסיפה עליה את הספירה הכוללת של הטבלה עצמה:

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 הוא מזהה המסמך של השורה עצמה (מה ש-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 חוזרים לכל שורה במקרה כזה ולא פעם אחת.

שגיאות

הבא