Função que atualiza o registro ativo da fonte de dados.
![](/download/attachments/197528015/AtualizarRegistroCorrentBlocoFuncao.png?version=1&modificationDate=1719586627000&api=v2)
Figura 1 - Bloco Atualizar registro corrente
Compatibilidade
- Bloco cliente: cronapi.screen.refreshActiveRecord()
- Bloco servidor: cronapi.screen.refreshActiveRecord() - executado a partir da chamada do bloco cliente.
Retorno
O 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: Fonte de dados / Datasource
- Exemplo: Aluno
Exemplo
A função da figura 2 atualiza o registro ativo da fonte de dados.
![](/download/attachments/197528015/AtualizarRegistroCorrentBloco.png?version=1&modificationDate=1719586627000&api=v2)
Figura 2 - Bloco Atualizar registro corrente
Imagine que o registro da figura 2.1 está sendo editado ao mesmo tempo por 2 pessoas diferentes. Assim que a pessoa 1 editar e salvar o registro, a pessoa 2 pode clicar no botão "Atualizar Registro Editado" para atualizar os campos automaticamente, sem a necessidade de atualizar a página. A figura 2.1 apresenta os registros da fonte de dados "Aluno" antes da atualização. Atualizaremos o campo "Nota" do primeiro registro.
![](/download/attachments/197528015/AtualizarRegistroCorrentAluno.png?version=1&modificationDate=1719586627000&api=v2)
Figura 2.1 - Grade exibindo os registros antes da atualização
Para simular o segundo usuário, duplicamos a página aluno e demos o nome de "Aluno 2" e atualizamos nota do primeiro registro.
![](/download/attachments/197528015/AtualizarRegistroCorrentAluno2Editando.png?version=1&modificationDate=1719586627000&api=v2)
Figura 2.2 - Editando o registro
Voltando a página original, podemos atualizar o registro que editamos apenas chamando a função criada na figura 2, sem a necessidade de atualizar toda a página.
![](/download/attachments/197528015/AtualizarRegistroCorrentAlunoResultado.png?version=1&modificationDate=1719586627000&api=v2)
Figura 2.3 - Registro atualizado