Vai al contenuto
Verificata

Leggi dati

Una query salvata e richiamabile che legge record tramite un'origine dati e li restituisce a chi l'ha chiamata.

Un programma Leggi dati è una lettura salvata. Che sia un modulo che cerca un singolo record, una griglia che estrae un elenco filtrato o uno script che recupera righe per calcolarci qualcosa, la lettura è un programma Leggi dati: un'origine dati, un insieme di campi da restituire e gli eventi del ciclo di vita che scattano attorno al recupero.

Proprietà

studio_meta.parentId ha come valore predefinito programs (o una cartella al suo interno).

progDataSource

La forma completa è nella pagina Origine dati. Un programma Leggi dati imposta quasi sempre dataSourceType: "table" più dataSourceFilterModelType: "index" per un singolo record oppure "query" per un elenco filtrato.

progFields

progEvents

Leggi dati aggiunge eventi per singolo record al normale ciclo di vita:

Chiamare un programma Leggi dati

Da un workflow, l'azione get_data lo esegue. I parametri vengono abbinati per id di campo, ciascuno come value statico o come espressione fx:

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

Esempio pratico

Puntalo a una tabella

dataSourceTableId indica la tabella di destinazione; dataSourceFilterModelType sceglie index (un record) o query (un insieme filtrato).

Dichiara cosa torna indietro

Le voci di progFields con data.type: "table" restituiscono quella colonna per ogni riga corrispondente; un campo virtual è invece un parametro di input.

Chiamalo da un workflow

get_data con name.prog impostato sull'id di questo programma, name.parameters che associa i valori del chiamante ai campi virtuali del programma.

Crea un nodo Leggi dati sotto Programmi, imposta la sua scheda Origine dati (tabella, indice o query, ordinamento), poi la sua griglia Campi per i parametri e le colonne restituite.

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