Naar de inhoud springen
Geverifieerd

Datasource

De gedeelde bindingsvorm die een programma of een component vertelt waar zijn gegevens vandaan komen en hoe ze gefilterd worden.

Een datasource is progDataSource, het object dat zegt waar de gegevens van een programma of een component vandaan komen: een tabel, een inline array, ruwe JSON of CSV, of een URL, plus hoe ze gefilterd en gesorteerd worden en of ze live blijven. Het is niet iets wat je in de huidige Studio zelfstandig aanmaakt, het is een onderdeel dat elk programma Gegevens ophalen, Gegevens instellen en elke gegevensbewuste Component bevat, en alle drie lezen en schrijven dat onderdeel met exact dezelfde vorm en exact dezelfde runtime-resolver.

progDataSource

runAt op een datasource

Een datasource wordt opgelost als "" (overnemen van zijn bovenliggende programma), client (in de browser) of server (via de service datasource_create van de runtime, zodat bevoorrechte queries van de client af blijven). De runtime overschrijft de opgeslagen waarde onvoorwaardelijk naar client in twee gevallen: binnen een programma Globale variabelen, en als de sessie draait in app_computing_mode: "main".

Twee vormen, hetzelfde object

Eén record op sleutel (een formulier):

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

Gefilterde lijst (een raster):

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

Uitgewerkt voorbeeld

Kies de modus

Eén record opzoeken op zijn sleutel: modus index plus dataSourceIndexId. Een lijst filteren op een voorwaarde: modus query plus filterModelMongoFx.

Wijs hem naar een tabel

dataSourceTableId is de _id van de doeltabel, nooit zijn naam.

Zet realtime aan waar het ertoe doet

dataSourceRealtime: true houdt een gebonden raster gesynchroniseerd als rijen eronder veranderen, alleen op het eigen databasestuurprogramma.

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>

Het blok <datasource> in .xu is dezelfde informatie als progDataSource, in de verkorte vorm die xuda-cli compileert naar de JSON-vorm van Studio.

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