Saltar para o conteúdo
Verificado

Fonte de dados

A forma de associação partilhada que diz a um programa ou a um componente de onde vêm os seus dados e como filtrá-los.

Uma fonte de dados é progDataSource, o objeto que diz de onde vêm os dados de um programa ou de um componente: uma tabela, um array em linha, JSON ou CSV em bruto, ou um URL, além de como filtrá-los, ordená-los e se os mantém em direto. Não é algo que se crie sozinho no Studio atual, é uma secção que todos os programas Obter Dados, Definir Dados e os Componentes com dados trazem, e os três leem e escrevem essa secção através da mesma forma e do mesmo resolvedor de runtime.

progDataSource

runAt numa fonte de dados

Uma fonte de dados resolve "" (herdar do programa pai), client (no navegador) ou server (através do serviço datasource_create do runtime, mantendo as consultas privilegiadas fora do cliente). O runtime substitui incondicionalmente o valor guardado por client em dois casos: dentro de um programa Globais e quando a sessão está a correr em app_computing_mode: "main".

Duas formas, o mesmo objeto

Registo único por chave (um formulário):

json
{
  "dataSourceType": "table", "dataSourceFilterModelType": "index",
  "dataSourceTableId": "392_tbl_…", "dataSourceIndexId": "<index-uuid>",
  "dataSourceIndexesObj": { "<index-uuid>": { "ORD_Id": { "from": "@order_id_in", "to": "@order_id_in", "key": "ORD_Id" } } }
}

Lista filtrada (uma grelha):

json
{
  "dataSourceType": "table", "dataSourceFilterModelType": "query",
  "dataSourceTableId": "392_tbl_…",
  "filterModelMongoFx": "({ ORD_Status: { $eq: @status_v } })",
  "dataSourceRealtime": true
}

Exemplo prático

Escolha o modo

Procurar um registo pela sua chave: modo index mais dataSourceIndexId. Filtrar uma lista por uma condição: modo query mais filterModelMongoFx.

Aponte-a para uma tabela

dataSourceTableId é o _id da Tabela de destino, nunca o seu nome.

Ative o tempo real onde interessa

dataSourceRealtime: true mantém uma grelha associada sincronizada à medida que as linhas mudam por baixo dela, apenas no controlador de base de dados nativo.

xml
<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>

O bloco <datasource> do .xu é a mesma informação que progDataSource, na forma abreviada que o xuda-cli compila para a forma JSON do Studio.

json
"progDataSource": {
  "dataSourceType": "table",
  "dataSourceTableId": "5b1_tbl_a953848a71c5",
  "dataSourceFilterModelType": "index",
  "dataSourceIndexId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "dataSourceSort": "STU_Full_Name",
  "dataSourceRealtime": true
}