Přeskočit na obsah
Ověřeno

Zdroj dat

Sdílený tvar vazby, který programu nebo komponentě říká, odkud pocházejí její data a jak je filtrovat.

Zdroj dat (Datasource) je progDataSource, objekt, který říká, odkud pocházejí data programu nebo komponenty: tabulka, vložené pole, surový JSON nebo CSV, nebo URL, a také jak je filtrovat, třídit a zda je udržovat živá. V dnešním Studiu se nevytváří samostatně, je to sekce, kterou nese každý program Získat data, Nastavit data a Komponenta pracující s daty, a všechny tři ji čtou a zapisují přes úplně stejný tvar a úplně stejný běhový překladač.

progDataSource

runAt u zdroje dat

Zdroj dat se vyhodnocuje "" (zdědí se od nadřazeného programu), client (v prohlížeči) nebo server (přes službu datasource_create běhového prostředí, která drží privilegované dotazy mimo klienta). Běhové prostředí přepíše uloženou hodnotu na client bezpodmínečně ve dvou případech: uvnitř programu Globálních proměnných a když relace běží v app_computing_mode: "main".

Dva tvary, stejný objekt

Jeden záznam podle klíče (formulář):

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ý seznam (mřížka):

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

Pracovní příklad

Vyberte režim

Vyhledání jednoho záznamu podle klíče: režim index plus dataSourceIndexId. Filtrování seznamu podle podmínky: režim query plus filterModelMongoFx.

Namiřte ho na tabulku

dataSourceTableId je _id cílové Tabulky, nikdy její název.

Zapněte realtime tam, kde na tom záleží

dataSourceRealtime: true udržuje navázanou mřížku v synchronizaci, když se pod ní mění řádky, jen na nativním databázovém ovladač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 tatáž informace jako progDataSource, ve zkrácené podobě, kterou xuda-cli zkompiluje 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
}