Gå til indhold
Bekræftet

Datakilde

Den delte bindingsform, der fortæller et program eller en komponent, hvor dens data kommer fra, og hvordan de filtreres.

En datakilde er progDataSource, det objekt, der siger, hvor et programs eller en komponents data kommer fra: en tabel, et indlejret array, rå JSON eller CSV eller en URL, plus hvordan de filtreres, sorteres, og om de skal holdes live. Den er ikke noget, du opretter for sig selv i dagens Studio, den er en sektion, som hvert Hent data, Sæt data og datafølsomme Komponent bærer, og alle tre læser og skriver den sektion gennem præcis den samme form og præcis den samme runtime-opløser.

progDataSource

runAt på en datakilde

En datakilde opløses som "" (arv fra sit overordnede program), client (i browseren) eller server (gennem runtimes tjeneste datasource_create, som holder privilegerede forespørgsler væk fra klienten). Runtime tilsidesætter den gemte værdi til client ubetinget i to tilfælde: inde i et Globaler-program og når sessionen kører i app_computing_mode: "main".

To former, samme objekt

Én post efter nøgle (en 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" } } }
}

Filtreret liste (et gitter):

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

Eksempel

Vælg tilstanden

Slå én post op efter dens nøgle: index-tilstand plus dataSourceIndexId. Filtrér en liste efter en betingelse: query-tilstand plus filterModelMongoFx.

Peg den på en tabel

dataSourceTableId er måltabellens _id, aldrig dens navn.

Slå realtime til, hvor det betyder noget

dataSourceRealtime: true holder et bundet gitter i synk, når rækker ændres under det, kun på den oprindelige databasedriver.

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>

Blokken <datasource> i .xu er de samme oplysninger som progDataSource, i den stenografi, som xuda-cli kompilerer ned til Studio-JSON-formen.

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