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

מקור נתונים

צורת הקישור המשותפת שאומרת לתוכנית או לרכיב מאיפה הנתונים שלהם מגיעים ואיך לסנן אותם.

מקור נתונים הוא progDataSource, האובייקט שאומר מאיפה הנתונים של תוכנית או של רכיב מגיעים: טבלה, מערך מוטמע, JSON או CSV גולמיים, או כתובת URL, וכן איך לסנן אותם, למיין אותם והאם לשמור אותם חיים. זה לא משהו שיוצרים בנפרד ב-Studio של היום, זה מקטע שכל תוכנית קבלת נתונים, שמירת נתונים ורכיב שמודע לנתונים נושאים, ושלושתם קוראים וכותבים את המקטע הזה דרך אותה צורה בדיוק ואותו מפענח סביבת ריצה בדיוק.

progDataSource

runAt במקור נתונים

מקור נתונים נפתר ל-"" (ירושה מהתוכנית ההורה), client (בדפדפן) או server (דרך שירות datasource_create של סביבת הריצה, שמשאיר שאילתות מורשות מחוץ ללקוח). סביבת הריצה דורסת את הערך השמור ל-client ללא תנאי בשני מקרים: בתוך תוכנית גלובליים, וכשהמושב רץ ב-app_computing_mode: "main".

שתי צורות, אותו אובייקט

רשומה בודדת לפי מפתח (טופס):

json
{
  "dataSourceType": "table", "dataSourceFilterModelType": "index",
  "dataSourceTableId": "392_tbl_…", "dataSourceIndexId": "<index-uuid>",
  "dataSourceIndexesObj": { "<index-uuid>": { "ORD_Id": { "from": "@order_id_in", "to": "@order_id_in", "key": "ORD_Id" } } }
}

רשימה מסוננת (רשת):

json
{
  "dataSourceType": "table", "dataSourceFilterModelType": "query",
  "dataSourceTableId": "392_tbl_…",
  "filterModelMongoFx": "({ ORD_Status: { $eq: @status_v } })",
  "dataSourceRealtime": true
}

דוגמת עבודה

לבחור את המצב

איתור רשומה אחת לפי המפתח שלה: מצב index ועוד dataSourceIndexId. סינון רשימה לפי תנאי: מצב query ועוד filterModelMongoFx.

להפנות אותו לטבלה

dataSourceTableId הוא ה-_id של טבלת היעד, ולעולם לא שמה.

להפעיל זמן אמת איפה שזה חשוב

dataSourceRealtime: true שומר על רשת מקושרת מסונכרנת כששורות משתנות מתחתיה, בדרייבר מסד הנתונים המקורי בלבד.

xml
<datasource lang="json5">
{
  type: "table",
  table: "student_profiles_table",
  filter: {
    mode: "query",
    queryField: "@campus_query_v"
  },
  output: "student_entries_v",
  direction: "asc",
  realtime: true,
  limit: 25
}
</datasource>

בלוק <datasource> ב-.xu הוא אותו מידע כמו progDataSource, בקיצור ש-xuda-cli מהדר אל צורת ה-JSON של Studio.

json
"progDataSource": {
  "dataSourceType": "table",
  "dataSourceTableId": "5b1_tbl_a953848a71c5",
  "dataSourceFilterModelType": "index",
  "dataSourceIndexId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "dataSourceSort": "STU_Full_Name",
  "dataSourceRealtime": true
}