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:
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.