Saltar para o conteúdo
Verificado

Obter Dados

Uma consulta guardada e chamável que lê registos através de uma fonte de dados e os devolve a quem a chamou.

Um programa Obter Dados é uma leitura guardada. Seja um formulário a procurar um registo, uma grelha a obter uma lista filtrada ou um script a ir buscar linhas para calcular algo com elas, a leitura é um programa Obter Dados: uma fonte de dados, um conjunto de campos a devolver e os eventos de ciclo de vida que disparam em torno da obtenção.

Propriedades

studio_meta.parentId assume por predefinição programs (ou uma pasta dentro dele).

progDataSource

A forma completa está na página Fonte de dados. Um programa Obter Dados define quase sempre dataSourceType: "table" mais dataSourceFilterModelType: "index" para um único registo ou "query" para uma lista filtrada.

progFields

progEvents

O Obter Dados acrescenta eventos por registo ao ciclo de vida habitual:

Chamar um programa Obter Dados

A partir de um fluxo de trabalho, a ação get_data executa-o. Os parâmetros são associados pelo id do campo, cada um com um value estático ou uma expressão fx:

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

Exemplo prático

Aponte-o para uma tabela

dataSourceTableId indica a tabela de destino; dataSourceFilterModelType escolhe index (um registo) ou query (um conjunto filtrado).

Declare o que volta

As entradas de progFields com data.type: "table" devolvem essa coluna em cada linha correspondente; um campo virtual é, em vez disso, um parâmetro de entrada.

Chame-o a partir de um fluxo de trabalho

get_data com name.prog definido para o id deste programa e name.parameters a mapear os valores de quem chama para os campos virtuais do programa.

Crie um nó Obter Dados em Programas, defina o seu separador Fonte de dados (tabela, índice ou consulta, ordenação) e depois a sua grelha de Campos para os parâmetros e as colunas devolvidas.

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