Hopp til innholdet
Bekreftet

Hent data

En lagret, kallbar spørring som leser poster gjennom en datakilde og gir dem tilbake til den som kalte den.

Et Hent data-program er en lagret lesing. Enten det er et skjema som slår opp én post, et rutenett som henter en filtrert liste, eller et skript som henter rader for å regne ut noe, er lesingen et Hent data-program: en datakilde, et sett felt som skal returneres, og livssyklushendelsene som utløses rundt hentingen.

Egenskaper

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

progDataSource

Hele formen står på siden Datakilde. Et Hent data-program setter nesten alltid dataSourceType: "table" pluss enten dataSourceFilterModelType: "index" for én post eller "query" for en filtrert liste.

progFields

progEvents

Hent data legger til hendelser per post oppå den vanlige livssyklusen:

Å kalle et Hent data-program

Fra en arbeidsflyt kjører handlingen get_data det. Parametere matches etter felt-id, hver enten en statisk value eller et fx-uttrykk:

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

Eksempel

Pek den mot en tabell

dataSourceTableId navngir måltabellen. dataSourceFilterModelType velger index (én post) eller query (et filtrert sett).

Deklarer hva som kommer tilbake

progFields-oppføringer med data.type: "table" returnerer den kolonnen på hver rad som treffer. Et virtual-felt er i stedet en inndataparameter.

Kall det fra en arbeidsflyt

get_data med name.prog satt til dette programmets id, og name.parameters som kobler kallerens verdier til programmets virtuelle felt.

Opprett en Hent data-node under Programmer, sett fanen Datakilde (tabell, indeks eller spørring, sortering), og så Felt-rutenettet for parametere og returnerte 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" } }
  ]
}