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):
Lista filtrada (uma grelha):
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.
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.