Função Revert

Aplica-se a: Aplicações de tela

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

Descrição

A função Revert atualiza uma origem de dados completa ou um único registo contido nessa origem de dados. Verá as alterações efetuadas por outros utilizadores.

No caso dos registos revertidos, a função Revert também limpa todos os erros da tabela devolvida pela função Errors.

Se a função Errors indicar a existência de um conflito após a utilização da função Patch ou de outra operação de dados, utilize a função Revert, para reverter o registo e começar com a versão em conflito, e volte a aplicar a alteração.

A função Revert não tem valor devolvido. Só pode utilizá-la numa fórmula de comportamento.

Sintaxe

Revert( DataSource [, Record ] )

• DataSource – Obrigatório. A origem de dados que quer reverter.
• Record – 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:

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 = "Strawberry" ), { Quantity: 500 } )

Ao verificar a tabela Errors, encontra um erro:

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

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

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