Przejdź do treści
Zweryfikowano

Pobierz dane

Zapisane, wywoływalne zapytanie, które czyta rekordy przez źródło danych i zwraca je temu, kto je wywołał.

Program Get Data to zapisany odczyt. Niezależnie od tego, czy to formularz wyszukujący jeden rekord, siatka pobierająca przefiltrowaną listę, czy skrypt pobierający wiersze, aby coś z nich obliczyć, odczyt jest programem Get Data: źródło danych, zestaw pól do zwrócenia i zdarzenia cyklu życia uruchamiane wokół pobierania.

Właściwości

studio_meta.parentId domyślnie ma wartość programs (albo folder pod nim).

progDataSource

Pełny kształt opisuje strona Źródło danych. Program Get Data prawie zawsze ustawia dataSourceType: "table" plus albo dataSourceFilterModelType: "index" dla pojedynczego rekordu, albo "query" dla przefiltrowanej listy.

progFields

progEvents

Get Data dodaje zdarzenia dla pojedynczych rekordów do zwykłego cyklu życia:

Wywoływanie programu Get Data

Z przepływu pracy uruchamia go akcja get_data. Parametry są dopasowywane po identyfikatorze pola, każdy jako statyczne value albo wyrażenie fx:

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

Przykład krok po kroku

Wskaż tabelę

dataSourceTableId nazywa tabelę docelową; dataSourceFilterModelType wybiera index (jeden rekord) albo query (przefiltrowany zbiór).

Zadeklaruj, co wraca

Wpisy progFields z data.type: "table" zwracają tę kolumnę w każdym pasującym wierszu; pole virtual jest zamiast tego parametrem wejściowym.

Wywołaj go z przepływu pracy

get_data z name.prog ustawionym na identyfikator tego programu i name.parameters odwzorowującym wartości wywołującego na pola wirtualne programu.

Utwórz węzeł Get Data w Programach, ustaw jego kartę Źródło danych (tabela, indeks lub zapytanie, sortowanie), a potem jego siatkę Pola dla parametrów i zwracanych kolumn.

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