Naar de inhoud springen
Geverifieerd

Gegevens ophalen

Een opgeslagen, aanroepbare query die records leest via een datasource en ze teruggeeft aan wie hem aanriep.

Een programma Gegevens ophalen is een opgeslagen leesactie. Of het nu een formulier is dat één record opzoekt, een raster dat een gefilterde lijst ophaalt, of een script dat rijen ophaalt om iets mee te berekenen: de leesactie is een programma Gegevens ophalen: een datasource, een set velden om terug te geven en de levenscyclusgebeurtenissen rond het ophalen.

Eigenschappen

studio_meta.parentId staat standaard op programs (of een map eronder).

progDataSource

De volledige vorm staat op de pagina Datasource. Een programma Gegevens ophalen stelt vrijwel altijd dataSourceType: "table" in, plus dataSourceFilterModelType: "index" voor één record of "query" voor een gefilterde lijst.

progFields

progEvents

Gegevens ophalen voegt gebeurtenissen per record toe bovenop de gebruikelijke levenscyclus:

Een programma Gegevens ophalen aanroepen

Vanuit een workflow voert de actie get_data het uit. Parameters worden op veld-id gekoppeld, elk een statische value of een fx-expressie:

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

Uitgewerkt voorbeeld

Wijs het naar een tabel

dataSourceTableId noemt de doeltabel; dataSourceFilterModelType kiest index (één record) of query (een gefilterde set).

Declareer wat terugkomt

progFields-vermeldingen met data.type: "table" geven die kolom terug op elke overeenkomende rij; een virtual-veld is in plaats daarvan een invoerparameter.

Roep het aan vanuit een workflow

get_data met name.prog ingesteld op de id van dit programma, en name.parameters die waarden van de aanroeper koppelt aan de virtuele velden van het programma.

Maak een knooppunt Gegevens ophalen onder Programma's, stel het tabblad Datasource in (tabel, index of query, sortering), daarna het raster Velden voor parameters en teruggegeven kolommen.

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