Aller au contenu
Vérifié

Source de données

La forme de liaison partagée qui indique à un programme ou à un composant d'où viennent ses données et comment les filtrer.

Une source de données est progDataSource, l'objet qui dit d'où viennent les données d'un programme ou d'un composant : une table, un tableau en ligne, du JSON ou du CSV bruts, ou une URL, ainsi que la façon de les filtrer, de les trier et s'il faut les garder en direct. Ce n'est pas quelque chose que l'on crée seul dans le Studio actuel : c'est une section que porte chaque programme Obtenir des données, Définir des données et chaque Composant manipulant des données, et les trois lisent et écrivent cette section avec exactement la même forme et exactement le même résolveur du runtime.

progDataSource

runAt sur une source de données

Une source de données se résout en "" (hérité du programme parent), client (dans le navigateur) ou server (via le service datasource_create du runtime, qui garde les requêtes privilégiées hors du client). Le runtime remplace inconditionnellement la valeur stockée par client dans deux cas : dans un programme Globals, et quand la session s'exécute en app_computing_mode: "main".

Deux formes, même objet

Un seul enregistrement par clé (un formulaire) :

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

Liste filtrée (une grille) :

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

Exemple concret

Choisissez le mode

Chercher un enregistrement par sa clé : mode index plus dataSourceIndexId. Filtrer une liste selon une condition : mode query plus filterModelMongoFx.

Pointez-la vers une table

dataSourceTableId est le _id de la Table cible, jamais son nom.

Activez le temps réel là où c'est utile

dataSourceRealtime: true garde une grille liée synchronisée quand les lignes changent en dessous, avec le pilote de base de données natif uniquement.

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>

Le bloc <datasource> de .xu contient la même information que progDataSource, dans le raccourci que xuda-cli compile vers la forme JSON de Studio.

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