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 :
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.