Zum Inhalt springen
Geprüft

Get Data

Eine gespeicherte, aufrufbare Abfrage, die Datensätze über eine Datenquelle liest und an den Aufrufer zurückgibt.

Ein Get-Data-Programm ist ein gespeicherter Lesezugriff. Ob ein Formular einen Datensatz nachschlägt, ein Raster eine gefilterte Liste zieht oder ein Skript Zeilen holt, um damit etwas zu berechnen: Der Lesezugriff ist ein Get-Data-Programm, bestehend aus einer Datenquelle, einer Reihe von Feldern, die zurückgegeben werden, und den Lebenszyklus-Ereignissen, die rund um das Abrufen ausgelöst werden.

Eigenschaften

studio_meta.parentId ist standardmäßig programs (oder ein Ordner darunter).

progDataSource

Die vollständige Form steht auf der Seite Datenquelle. Ein Get-Data-Programm setzt fast immer dataSourceType: "table" plus entweder dataSourceFilterModelType: "index" für einen einzelnen Datensatz oder "query" für eine gefilterte Liste.

progFields

progEvents

Get Data ergänzt den üblichen Lebenszyklus um Ereignisse pro Datensatz:

Ein Get-Data-Programm aufrufen

Aus einem Workflow führt die Aktion get_data es aus. Parameter werden nach Feld-ID zugeordnet, jeder entweder als statischer value oder als fx-Ausdruck:

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

Praxisbeispiel

Auf eine Tabelle richten

dataSourceTableId nennt die Ziel-Tabelle; dataSourceFilterModelType wählt index (ein Datensatz) oder query (eine gefilterte Menge).

Festlegen, was zurückkommt

progFields-Einträge mit data.type: "table" geben diese Spalte für jede passende Zeile zurück; ein virtual-Feld ist stattdessen ein Eingabeparameter.

Aus einem Workflow aufrufen

get_data mit name.prog auf die ID dieses Programms gesetzt, name.parameters ordnet Werte des Aufrufers den virtuellen Feldern des Programms zu.

Lege unter Programme einen Get-Data-Knoten an, richte seinen Tab Datenquelle ein (Tabelle, Index oder Abfrage, Sortierung) und dann sein Raster Felder für Parameter und zurückgegebene Spalten.

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