Vai al contenuto
Verificata

Origine dati

La forma di associazione condivisa che dice a un programma o a un componente da dove arrivano i suoi dati e come filtrarli.

Un'origine dati è progDataSource, l'oggetto che dice da dove arrivano i dati di un programma o di un componente: una tabella, un array inline, JSON o CSV grezzo oppure un URL, più come filtrarli, ordinarli e se mantenerli aggiornati in tempo reale. Non è qualcosa che si crea da solo nell'attuale Studio: è una sezione che ogni programma Leggi dati, Imposta dati e ogni Componente che usa dati porta con sé, e tutti e tre leggono e scrivono quella sezione con la stessa identica forma e lo stesso identico risolutore di runtime.

progDataSource

runAt su un'origine dati

Un'origine dati risolve "" (eredita dal programma padre), client (nel browser) o server (tramite il servizio datasource_create del runtime, che tiene le query privilegiate fuori dal client). Il runtime sovrascrive in modo incondizionato il valore memorizzato con client in due casi: dentro un programma Variabili globali e quando la sessione gira in app_computing_mode: "main".

Due forme, lo stesso oggetto

Singolo record per chiave (un modulo):

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

Elenco filtrato (una griglia):

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

Esempio pratico

Scegli la modalità

Cercare un record per la sua chiave: modalità index più dataSourceIndexId. Filtrare un elenco con una condizione: modalità query più filterModelMongoFx.

Puntala a una tabella

dataSourceTableId è il _id della Tabella di destinazione, mai il suo nome.

Attiva il tempo reale dove serve

dataSourceRealtime: true mantiene sincronizzata una griglia associata mentre le righe cambiano sotto di essa, solo sul driver di database nativo.

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>

Il blocco <datasource> di .xu contiene le stesse informazioni di progDataSource, nella forma abbreviata che xuda-cli compila nella forma JSON di Studio.

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