Przejdź do treści
Zweryfikowano

Źródło danych

Wspólny kształt powiązania, który mówi programowi lub komponentowi, skąd pochodzą jego dane i jak je filtrować.

Źródło danych to progDataSource, obiekt, który mówi, skąd pochodzą dane programu lub komponentu: z tabeli, tablicy wbudowanej, surowego JSON lub CSV albo z adresu URL, a także jak je filtrować, sortować i czy utrzymywać je na żywo. Nie tworzy się go samodzielnie we współczesnym Studio: to sekcja, którą niesie każdy program Get Data, Set Data i każdy Component obsługujący dane, a wszystkie trzy czytają i zapisują tę sekcję przez dokładnie ten sam kształt i dokładnie ten sam resolver środowiska uruchomieniowego.

progDataSource

runAt w źródle danych

Źródło danych rozstrzyga "" (dziedzicz od programu nadrzędnego), client (w przeglądarce) albo server (przez usługę środowiska uruchomieniowego datasource_create, co trzyma uprzywilejowane zapytania poza klientem). Środowisko uruchomieniowe bezwarunkowo nadpisuje zapisaną wartość na client w dwóch przypadkach: wewnątrz programu Zmienne globalne i gdy sesja działa w app_computing_mode: "main".

Dwa kształty, ten sam obiekt

Pojedynczy rekord po kluczu (formularz):

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

Przefiltrowana lista (siatka):

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

Przykład krok po kroku

Wybierz tryb

Wyszukanie jednego rekordu po jego kluczu: tryb index plus dataSourceIndexId. Filtrowanie listy według warunku: tryb query plus filterModelMongoFx.

Wskaż tabelę

dataSourceTableId to _id docelowej Tabeli, nigdy jej nazwa.

Włącz czas rzeczywisty tam, gdzie ma to znaczenie

dataSourceRealtime: true utrzymuje powiązaną siatkę zsynchronizowaną, gdy wiersze zmieniają się pod nią, tylko w natywnym sterowniku bazy danych.

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> w .xu to ta sama informacja co progDataSource, w skróconym zapisie, który xuda-cli kompiluje do kształtu JSON Studio.

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