Zum Inhalt springen
Geprüft

Datenquelle

Die gemeinsame Bindungsform, die einem Programm oder einer Komponente sagt, woher ihre Daten kommen und wie sie gefiltert werden.

Eine Datenquelle ist progDataSource, das Objekt, das sagt, woher die Daten eines Programms oder einer Komponente kommen: eine Tabelle, ein Inline-Array, rohes JSON oder CSV oder eine URL, dazu wie sie gefiltert und sortiert werden und ob sie live gehalten werden. Im heutigen Studio legst du sie nicht für sich allein an, sie ist ein Abschnitt, den jedes Get Data, Set Data und jede datenbewusste Komponente trägt, und alle drei lesen und schreiben diesen Abschnitt über exakt dieselbe Form und exakt denselben Laufzeit-Resolver.

progDataSource

runAt bei einer Datenquelle

Eine Datenquelle wird aufgelöst als "" (vom übergeordneten Programm erben), client (im Browser) oder server (über den Dienst datasource_create der Laufzeit, der privilegierte Abfragen vom Client fernhält). Die Laufzeit überschreibt den gespeicherten Wert in zwei Fällen bedingungslos auf client: innerhalb eines Programms für Globale Variablen und wenn die Sitzung in app_computing_mode: "main" läuft.

Zwei Formen, dasselbe Objekt

Einzelner Datensatz über den Schlüssel (ein 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" } } }
}

Gefilterte Liste (ein Raster):

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

Praxisbeispiel

Den Modus wählen

Einen Datensatz über seinen Schlüssel nachschlagen: Modus index plus dataSourceIndexId. Eine Liste nach einer Bedingung filtern: Modus query plus filterModelMongoFx.

Auf eine Tabelle richten

dataSourceTableId ist die _id der Ziel-Tabelle, nie ihr Name.

Realtime dort einschalten, wo es zählt

dataSourceRealtime: true hält ein gebundenes Raster synchron, wenn sich Zeilen darunter ändern, nur beim nativen Datenbanktreiber.

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>

Der .xu-Block <datasource> enthält dieselben Informationen wie progDataSource, in der Kurzform, die xuda-cli in die Studio-JSON-Form kompiliert.

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