Partilhar via


Revert Função

Aplica-se a: Aplicativos de tela

Atualiza e limpa os erros dos registos de uma origem de dados.

Descrição

A Revert função atualiza uma fonte de dados inteira ou um único registro nessa fonte de dados. Verá as alterações efetuadas por outros utilizadores.

Para os registros revertidos, Revert também limpa quaisquer erros da tabela que a função Erros retornou.

Se a função Erros relatar um conflito após um patch ou outra operação de dados, Revert o registro será iniciado com a versão conflitante e reaplicará a alteração.

Revert não tem valor de retorno. Só pode utilizá-la numa fórmula de comportamento.

Sintaxe

Revert( Fonte de Dados [, Record ] )

  • DataSource – Obrigatório. A origem de dados que quer reverter.
  • Registro - Opcional. O registo que quer reverter. Se não especificar um registo, a origem de dados será revertida na totalidade.

Exemplo

Neste exemplo, reverterá a origem de dados com o nome IceCream, que começa com os dados desta tabela:

Exemplo de IceCream.

Um utilizador que está a utilizar outro dispositivo altera a propriedade Quantity do registo Strawberry para 400. Quase simultaneamente, altera a mesma propriedade do mesmo registo para 500 sem saber que já ocorreu uma outra alteração.

Utiliza a função Patch para atualizar o registo:
Patch( IceCream, LookUp( IceCream, Flavor = "Morango"), { Quantidade: 500 } )

Ao verificar a tabela Errors, encontra um erro:

Registo Coluna Mensagem Erro
{ ID: 1, Sabor: "Morango", Quantidade: 300 } em branco "O registo que está a tentar modificar foi modificado por outro utilizador. Reverta o registo e tente novamente." ErrorKind.Conflict

De acordo com a coluna Error, existe um botão Reload para o qual a propriedade OnSelect está definida para esta fórmula:
Revert( Sorvete, LookUp( Sorvete, Sabor = "Morango" )

Depois de selecionar o botão Reload, a tabela Erros fica vazia e o novo valor de Strawberry é carregado:

Novo valor para gelado de morango.

Quando voltar a aplicar a alteração sobre a alteração anterior, a sua alteração será bem-sucedida porque o conflito foi resolvido.

Alterações reaplicadas com conflito resolvido.