Saltar al contenido
Verificada

Get Data

Una consulta guardada y invocable que lee registros a través de una fuente de datos y se los devuelve a quien la llamó.

Un programa Get Data es una lectura guardada. Ya sea un formulario que busca un registro, una cuadrícula que obtiene una lista filtrada o un script que trae filas para calcular algo con ellas, la lectura es un programa Get Data: una fuente de datos, un conjunto de campos que devolver y los eventos del ciclo de vida que se disparan alrededor de la obtención.

Propiedades

studio_meta.parentId es por defecto programs (o una carpeta bajo él).

progDataSource

La forma completa está en la página Fuente de datos. Un programa Get Data casi siempre establece dataSourceType: "table" más dataSourceFilterModelType: "index" para un único registro o "query" para una lista filtrada.

progFields

progEvents

Get Data añade eventos por registro al ciclo de vida habitual:

Llamar a un programa Get Data

Desde un flujo de trabajo, la acción get_data lo ejecuta. Los parámetros se emparejan por id de campo, cada uno con un value estático o una expresión fx:

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

Ejemplo práctico

Apúntalo a una tabla

dataSourceTableId nombra la tabla de destino; dataSourceFilterModelType elige index (un registro) o query (un conjunto filtrado).

Declara lo que devuelve

Las entradas de progFields con data.type: "table" devuelven esa columna en cada fila coincidente; un campo virtual es un parámetro de entrada.

Llámalo desde un flujo de trabajo

get_data con name.prog establecido en el id de este programa, y name.parameters asignando los valores de quien llama a los campos virtuales del programa.

Crea un nodo Get Data en Programas, configura su pestaña Fuente de datos (tabla, índice o consulta, orden) y luego su cuadrícula de Campos para los parámetros y las columnas devueltas.

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