Preskočiť na obsah
Overené

Zdroj dát

Zdieľaný tvar väzby, ktorý programu alebo komponentu hovorí, odkiaľ pochádzajú jeho dáta a ako ich filtrovať.

Zdroj dát je progDataSource, objekt, ktorý hovorí, odkiaľ pochádzajú dáta programu alebo komponentu: tabuľka, vložené pole, surový JSON alebo CSV, alebo URL, plus ako ich filtrovať, triediť a či ich udržiavať živé. Nie je to niečo, čo vytvoríte samostatne v dnešnom Studiu, je to sekcia, ktorú nesie každý Získať dáta, Nastaviť dáta a komponent pracujúci s dátami, a všetky tri ju čítajú a zapisujú cez presne ten istý tvar a presne ten istý runtime resolver.

progDataSource

runAt pri zdroji dát

Zdroj dát sa vyhodnotí ako "" (zdedí sa od nadradeného programu), client (v prehliadači) alebo server (cez službu datasource_create runtime, čo drží privilegované dopyty mimo klienta). Runtime prepíše uloženú hodnotu na client bezpodmienečne v dvoch prípadoch: vo vnútri programu Globálne premenné a keď relácia beží v app_computing_mode: "main".

Dva tvary, ten istý objekt

Jeden záznam podľa kľúča (formulár):

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" } } }
}

Filtrovaný zoznam (mriežka):

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

Ukážkový príklad

Vyberte režim

Vyhľadanie jedného záznamu podľa jeho kľúča: režim index plus dataSourceIndexId. Filtrovanie zoznamu podľa podmienky: režim query plus filterModelMongoFx.

Nasmerujte ho na tabuľku

dataSourceTableId je _id cieľovej Tabuľky, nikdy nie jej názov.

Zapnite realtime tam, kde na tom záleží

dataSourceRealtime: true udržiava viazanú mriežku v súlade, keď sa pod ňou menia riadky, len na natívnom databázovom ovládači.

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>

Blok <datasource> v .xu je tá istá informácia ako progDataSource, v skrátenom zápise, ktorý xuda-cli skompiluje do tvaru JSON Studia.

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