Přeskočit na obsah
Ověřeno

Získat data

Uložený, volatelný dotaz, který čte záznamy přes zdroj dat a vrací je tomu, kdo ho zavolal.

Program Získat data (Get Data) je uložené čtení. Ať jde o formulář, který vyhledává jeden záznam, mřížku, která tahá filtrovaný seznam, nebo skript, který načítá řádky, aby s nimi něco spočítal, čtení je program Získat data: zdroj dat, sada polí k vrácení a události životního cyklu, které se spouštějí kolem načítání.

Vlastnosti

studio_meta.parentId je ve výchozím stavu programs (nebo složka pod ním).

progDataSource

Úplný tvar je na stránce Zdroj dat. Program Získat data téměř vždy nastavuje dataSourceType: "table" plus buď dataSourceFilterModelType: "index" pro jeden záznam, nebo "query" pro filtrovaný seznam.

progFields

progEvents

Získat data přidává k obvyklému životnímu cyklu události pro jednotlivé záznamy:

Volání programu Získat data

Z workflow ho spouští akce get_data. Parametry se přiřazují podle id pole, každý buď statickou hodnotou value, nebo výrazem fx:

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

Pracovní příklad

Namiřte ho na tabulku

dataSourceTableId pojmenovává cílovou tabulku; dataSourceFilterModelType vybírá index (jeden záznam) nebo query (filtrovanou sadu).

Deklarujte, co se vrací

Položky progFields s data.type: "table" vracejí tento sloupec na každém odpovídajícím řádku; pole virtual je místo toho vstupní parametr.

Zavolejte ho z workflow

get_data s name.prog nastaveným na id tohoto programu, name.parameters mapuje hodnoty volajícího na virtuální pole programu.

Vytvořte uzel Získat data pod Programy, nastavte jeho kartu Zdroj dat (tabulka, index nebo dotaz, řazení) a pak jeho mřížku Pole pro parametry a vrácené sloupce.

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