Aller au contenu
Vérifié

Obtenir des données

Une requête enregistrée et appelable qui lit des enregistrements via une source de données et les renvoie à qui l'a appelée.

Un programme Obtenir des données est une lecture enregistrée. Qu'il s'agisse d'un formulaire cherchant un enregistrement, d'une grille récupérant une liste filtrée ou d'un script allant chercher des lignes pour calculer quelque chose, la lecture est un programme Obtenir des données : une source de données, un ensemble de champs à renvoyer et les événements de cycle de vie qui se déclenchent autour de la récupération.

Propriétés

studio_meta.parentId vaut par défaut programs (ou un dossier sous celui-ci).

progDataSource

La forme complète figure sur la page Source de données. Un programme Obtenir des données définit presque toujours dataSourceType: "table" plus soit dataSourceFilterModelType: "index" pour un seul enregistrement, soit "query" pour une liste filtrée.

progFields

progEvents

Obtenir des données ajoute des événements par enregistrement au cycle de vie habituel :

Appeler un programme Obtenir des données

Depuis un workflow, l'action get_data l'exécute. Les paramètres sont associés par identifiant de champ, chacun étant soit une value statique, soit une expression fx :

json
{
  "id": "1", "data": {
    "action": "get_data",
    "name": { "prog": "97a_gtd_…", "properties": {}, "parameters": { "class_id": { "fx": "@glb_class_id" } } },
    "enabled": true
  }, "props": {}
}

Exemple concret

Pointez-le vers une table

dataSourceTableId désigne la table cible ; dataSourceFilterModelType choisit index (un enregistrement) ou query (un ensemble filtré).

Déclarez ce qui revient

Les entrées progFields avec data.type: "table" renvoient cette colonne pour chaque ligne correspondante ; un champ virtual est un paramètre d'entrée.

Appelez-le depuis un workflow

get_data avec name.prog défini sur l'identifiant de ce programme, et name.parameters associant les valeurs de l'appelant aux champs virtuels du programme.

Créez un nœud Obtenir des données sous Programmes, définissez son onglet Source de données (table, index ou requête, tri), puis sa grille Champs pour les paramètres et les colonnes renvoyées.

xml
<meta lang="json5">
{
  id: "load_student_classes",
  menuTitle: "Load Student Roster"
}
</meta>

<params lang="json5">
{
  in: { campus_in: "string" },
  out: { student_entries_v: "array" }
}
</params>

<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>
json
{
  "properties": { "menuType": "get_data", "menuName": "Load Students By Class", "runAt": "" },
  "progDataSource": {
    "dataSourceType": "table",
    "dataSourceTableId": "5b1_tbl_a953848a71c5",
    "dataSourceFilterModelType": "index",
    "dataSourceIndexId": "a1b2c3d4-…",
    "dataSourceSort": "STU_Full_Name",
    "dataSourceRealtime": true
  },
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "class_id", "type": "virtual" }, "props": { "fieldType": "string" } },
    { "id": "c3d4e5f6-…", "data": { "field_id": "STU_Full_Name", "type": "table" }, "props": { "fieldType": "string" } }
  ]
}