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

קבלת נתונים

שאילתה שמורה וניתנת לקריאה, שקוראת רשומות דרך מקור נתונים ומחזירה אותן למי שקרא לה.

תוכנית קבלת נתונים היא קריאה שמורה. בין שזה טופס שמאתר רשומה אחת, רשת שמושכת רשימה מסוננת, או סקריפט שמביא שורות כדי לחשב איתן משהו, הקריאה היא תוכנית קבלת נתונים: מקור נתונים, קבוצת שדות להחזרה, ואירועי מחזור החיים שמופעלים סביב האחזור.

מאפיינים

studio_meta.parentId הוא כברירת מחדל programs (או תיקייה תחתיו).

progDataSource

הצורה המלאה נמצאת בדף מקור נתונים. תוכנית קבלת נתונים כמעט תמיד מגדירה dataSourceType: "table" ועוד dataSourceFilterModelType: "index" לרשומה בודדת או "query" לרשימה מסוננת.

progFields

progEvents

קבלת נתונים מוסיפה אירועים לכל רשומה מעל מחזור החיים הרגיל:

קריאה לתוכנית קבלת נתונים

מתוך תהליך עבודה, הפעולה get_data מריצה אותה. פרמטרים מותאמים לפי מזהה שדה, כל אחד value סטטי או ביטוי fx:

json
{
  "id": "1", "data": {
    "action": "get_data",
    "name": { "prog": "97a_gtd_…", "properties": {}, "parameters": { "class_id": { "fx": "@glb_class_id" } } },
    "enabled": true
  }, "props": {}
}

דוגמת עבודה

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

dataSourceTableId מציין את טבלת היעד; dataSourceFilterModelType בוחר index (רשומה אחת) או query (קבוצה מסוננת).

להצהיר מה חוזר

רשומות progFields עם data.type: "table" מחזירות את העמודה הזאת בכל שורה תואמת; שדה virtual הוא פרמטר קלט במקום.

לקרוא לה מתהליך עבודה

get_data עם name.prog שמוגדר למזהה של התוכנית הזאת, ו-name.parameters שממפה ערכי קורא אל השדות הווירטואליים של התוכנית.

יוצרים צומת קבלת נתונים תחת תוכניות, מגדירים את לשונית מקור נתונים שלו (טבלה, אינדקס או שאילתה, מיון), ואז את רשת שדות שלו לפרמטרים ולעמודות מוחזרות.

xml
<meta lang="json5">
{
  id: "load_student_classes",
  menuTitle: "Load Student Roster"
}
</meta>

<params lang="json5">
{
  in: { campus_in: "string" },
  out: { student_entries_v: "array" }
}
</params>

<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>
json
{
  "properties": { "menuType": "get_data", "menuName": "Load Students By Class", "runAt": "" },
  "progDataSource": {
    "dataSourceType": "table",
    "dataSourceTableId": "5b1_tbl_a953848a71c5",
    "dataSourceFilterModelType": "index",
    "dataSourceIndexId": "a1b2c3d4-…",
    "dataSourceSort": "STU_Full_Name",
    "dataSourceRealtime": true
  },
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "class_id", "type": "virtual" }, "props": { "fieldType": "string" } },
    { "id": "c3d4e5f6-…", "data": { "field_id": "STU_Full_Name", "type": "table" }, "props": { "fieldType": "string" } }
  ]
}