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

Image Removed Servidor

Image Removed 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).

Image Removed

Figura 1 - Bloco Carregar fonte de dados

Image RemovedFigura 2 - dados da fonte de dados User Inserida no componente formulário após o retorno da função da figura 1

Image Added

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.

Image Added

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.

Image Added

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.

Image Added

Figura 2.2 - Resultado de execução da função da Figura 2