Sari la conținut
Verificat

Sursă de date

Structura comună de legare care spune unui program sau unei componente de unde vin datele și cum să le filtreze.

O sursă de date este progDataSource, obiectul care spune de unde vin datele unui program sau ale unei componente: un tabel, un array inline, JSON sau CSV brut sau un URL, plus cum să le filtreze, să le sorteze și dacă să le țină live. Nu este ceva ce creezi de sine stătător în Studio-ul de azi, este o secțiune pe care o poartă fiecare Get Data, Set Data și componentă care lucrează cu date, iar toate trei citesc și scriu acea secțiune prin exact aceeași structură și exact același rezolvator din runtime.

progDataSource

runAt pe o sursă de date

O sursă de date se rezolvă ca "" (moștenește de la programul părinte), client (în browser) sau server (prin serviciul datasource_create al runtime-ului, ținând interogările privilegiate departe de client). Runtime-ul suprascrie necondiționat valoarea stocată cu client în două cazuri: în interiorul unui program Globale și când sesiunea rulează în app_computing_mode: "main".

Două forme, același obiect

O singură înregistrare după cheie (un formular):

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

Listă filtrată (o grilă):

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

Exemplu lucrat

Alege modul

Căutarea unei singure înregistrări după cheie: modul index plus dataSourceIndexId. Filtrarea unei liste după o condiție: modul query plus filterModelMongoFx.

Îndreapt-o spre un tabel

dataSourceTableId este _id-ul Tabelului țintă, niciodată numele lui.

Pornește realtime unde contează

dataSourceRealtime: true ține o grilă legată sincronizată pe măsură ce rândurile se schimbă dedesubt, doar pe driverul nativ de bază de date.

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>

Blocul <datasource> din .xu conține aceeași informație ca progDataSource, în forma prescurtată pe care xuda-cli o compilează în structura JSON din Studio.

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