שאילתה וכתיבה של נתוני אפליקציה
קריאת שורות מטבלת Studio והוספת שורה, מחוץ לסביבת ההרצה, באותן שתי שיטות שאפליקציה רצה קוראת להן בעצמה.
dbs_read ו-dbs_create הן אותן שתי קריאות שתוכנית javascript או api מבצעת בזמן הרצה
דרך xu.dbs_read(...) ו-xu.dbs_create(...), נגישות ישירות עם מפתח API של חשבון כדי
שה-backend שלכם יוכל לקרוא ולכתוב לטבלת Studio של פרויקט בלי לעבור דרך סביבת ההרצה
בכלל. ראו JavaScript Framework לצד שבתוך הפרויקט של אותן
שיטות, ו-פלטפורמת פיתוח לשאר data_module.
table_id הוא ה-_id של צומת הטבלה עצמו, אף פעם לא שם התצוגה שלה. get_progs עם
menu_type: "table" מפרטת כל טבלה בפרויקט כזוגות {_id, properties: {menuName}}, הדרך
הזולה ביותר למפות שם שאפשר לקרוא אל המזהה ששתי השיטות האלה צריכות.
שיטות
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 עוטפת את תוצאת התוסף של הטבלה ומוסיפה עליה את הספירה הכוללת של הטבלה עצמה:
כל שורה היא { id, value }: 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 חוזרים לכל שורה במקרה כזה ולא פעם אחת.