Função que carrega a fonte de dados 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.

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