Ugrás a tartalomhoz
Ellenőrizve

Adatok lekérése

Mentett, hívható lekérdezés, amely egy adatforráson keresztül rekordokat olvas, és visszaadja azoknak, aki hívta.

A Get Data program egy mentett olvasás. Legyen az űrlap, amely egy rekordot keres, rács, amely szűrt listát húz, vagy szkript, amely sorokat kér le, hogy számoljon velük, az olvasás egy Get Data program: egy adatforrás, a visszaadandó mezők halmaza, és a lekérés körül elsülő életciklus-események.

Tulajdonságok

A studio_meta.parentId alapértelmezetten programs (vagy egy alatta lévő mappa).

progDataSource

A teljes alak az Adatforrás oldalon található. A Get Data program szinte mindig dataSourceType: "table" értéket állít be, plusz vagy dataSourceFilterModelType: "index" értéket egyetlen rekordhoz, vagy "query" értéket szűrt listához.

progFields

progEvents

A Get Data a szokásos életciklus fölé rekordonkénti eseményeket ad:

Get Data program hívása

Munkafolyamatból a get_data művelet futtatja. A paramétereket mezőazonosító szerint párosítjuk, mindegyik vagy statikus value, vagy fx kifejezés:

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

Kidolgozott példa

Mutasson rá egy táblát

A dataSourceTableId megnevezi a céltáblát; a dataSourceFilterModelType az index (egy rekord) vagy a query (szűrt halmaz) közül választ.

Deklarálja, mi jön vissza

A data.type: "table" típusú progFields bejegyzések minden egyező soron visszaadják az adott oszlopot; a virtual mező ehelyett bemeneti paraméter.

Hívja munkafolyamatból

get_data, a name.prog ennek a programnak az azonosítójára állítva, a name.parameters a hívó értékeit a program virtuális mezőire képezi.

Hozzon létre egy Get Data csomópontot a Programok alatt, állítsa be az Adatforrás lapját (tábla, index vagy lekérdezés, rendezés), majd a Mezők rácsát a paraméterekhez és a visszaadott oszlopokhoz.

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