Função que carrega a fonte de dados
Função que irá carregar uma nova selecionada após uma ação do usuário. Pode ser utilizada em situações em que é preciso inicializar o carregamentos dos registros da fonte de dados substituindo a atual.
Parâmetro
Compatibilidade
Servidor
Cliente
Exemplo
Abaixo (Figura 1), o bloco Carregar fonte de dados recebe no parâmetro Fonte de dados a fonte de dados User, usada para ser carregada no componente formulário após a função ser atribuída a um evento Ao Clicar do componente botão (Figura 2).
Figura 1 - Bloco Carregar fonte de dados
Figura 2 - dados da fonte de dados User Inserida no componente formulário após o retorno da função da figura 1
Figura 1 - Bloco Carregar fonte de dados
Compatibilidade
- Bloco cliente: cronapi.screen.load()
- Bloco servidor: cronapi.screen.load() - executado a partir da chamada do bloco cliente.
Retorno
Bloco não possui retorno.
Parâmetros
Fonte de dados
Componente visual fonte de dados da página referenciada. Para selecionar uma fonte de dados, o bloco deve estar associado a um formulário de referência que contenha o componente fonte de dados correspondente. Consulte o tópico Propriedades do Blockly na documentação de Bloco de programação para mais detalhes.
- Posição: 1
- Inglês: Datasource
- Tipo: Objeto / Object
- Exemplo: "User"
Exemplo
Na função da imagem abaixo, o bloco Carregar fonte de dados irá inicializar o carregamento dos registros da fonte de dados "User". Esses registros serão exibidos em uma lista simples, configurada para apresentar os nomes dos usuários cadastrados e seus e-mails.
Figura 2 - Exemplo de uso do bloco Carregar fonte de dados
Adicionamos a função da Figura 2 ao evento Ao Clicar do botão presente na view. Observe que inicialmente os registros da fonte de dados não são exibidos, visto que ainda não foram carregados.
Figura 2.1 - Botão que executará a função da Figura 2
A imagem abaixo apresenta o resultado de execução da função da Figura 2. Ao executar a função a fonte de dados é carregada e os registros são exibidos para o usuário.
Figura 2.2 - Resultado de execução da função da Figura 2
Nesta página
| Índice |
|---|
Utilização da função
A utilização da função Carregar fonte de dados depende da forma correta de vinculação do bloco de programação ao formulário contendo a fonte dados a ser utilizada.
Para mais informações sobre como vincular uma página ao bloco de programação, acesse o tópico Propriedades do blockly em Bloco de programação.