Gå til indhold
Bekræftet

Hent data

En gemt, kaldbar forespørgsel, der læser poster gennem en datakilde og giver dem tilbage til den, der kaldte den.

Et Hent data-program er en gemt læsning. Uanset om det er en formular, der slår én post op, et gitter, der trækker en filtreret liste, eller et script, der henter rækker for at regne på dem, er læsningen et Hent data-program: en datakilde, et sæt felter, der skal returneres, og de livscyklushændelser, der udløses omkring hentningen.

Egenskaber

studio_meta.parentId er som standard programs (eller en mappe under den).

progDataSource

Den fulde form findes på siden Datakilde. Et Hent data-program sætter næsten altid dataSourceType: "table" plus enten dataSourceFilterModelType: "index" for én post eller "query" for en filtreret liste.

progFields

progEvents

Hent data tilføjer hændelser pr. post oven på den almindelige livscyklus:

Kald et Hent data-program

Fra en workflow kører handlingen get_data det. Parametre matches efter felt-id, hver enten en statisk value eller et fx-udtryk:

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

Eksempel

Peg det på en tabel

dataSourceTableId angiver måltabellen. dataSourceFilterModelType vælger index (én post) eller query (et filtreret sæt).

Erklær, hvad der kommer tilbage

progFields-poster med data.type: "table" returnerer den kolonne på hver matchende række. Et virtual-felt er i stedet en inputparameter.

Kald det fra en workflow

get_data med name.prog sat til dette programs id og name.parameters, der kobler kalderens værdier til programmets virtuelle felter.

Opret en Hent data-node under Programmer, indstil dens fane Datakilde (tabel, indeks eller forespørgsel, sortering) og derefter dens gitter Felter til parametre og returnerede kolonner.

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