Função que atualiza uma fonte de dados, mantendo ou removendo os filtros aplicados. Pode ser utilizada após operações de CRUD para garantir que os registros sejam exibidos de forma atualizada para os usuários.

Figura 1 - Bloco Atualizar fonte de dados

Compatibilidade

• Bloco cliente: cronapi.screen.refreshDatasource()
• Bloco servidor: cronapi.screen.refreshDatasource() - 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"

Manter filtro(s)?

Permite manter ou remover os filtros existentes na fonte de dados durante a atualização.

• Posição: 2
• Inglês: Keep filter(s)?
• Tipo: Lógico / Boolean
• Exemplo: Verdadeiro

Exemplo

Na função da imagem abaixo, o bloco Atualizar fonte de dados irá atualizar os registros de uma fonte de dados exibidos em uma grade presente na view, mantendo os filtros aplicados.

Figura 2 - Exemplo de uso do bloco Atualizar fonte de dados

A imagem a seguir exibe a grade antes da execução da função da Figura 2. Em uma outra página, foi adicionado um novo usuário à fonte de dados, no entanto, esse novo registro ainda não é exibido na grade. Para exibir o novo usuário, iremos executar a função da Figura 2 por meio do botão "Atualizar fonte de dados".

Figura 2.1 - Grade antes da atualização da fonte de dados

Na Figura 2.2 podemos visualizar a grade após a execução da função da Figura 2 e o novo registro exibido.

Figura 2.2 - Grade após a execução da função da Figura 2