Função Revert

Aplica-se a: aplicativos Canvas

Atualiza e limpa erros dos registros de uma fonte de dados.

Descrição

A função Revert atualiza uma fonte de dados inteira ou um único registro na fonte de dados. Você verá as alterações feitas por outros usuários.

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

Se a função Errors reportar um conflito após um Patch ou outra operação de dados, use a função Revert no registro para começar com a versão conflitante e reaplique a alteração.

reverter não tem valor de retorno. Você só pode usá-la em uma fórmula de comportamento.

Sintaxe

reverter( DataSource [, Registro ] )

• DataSource – Obrigatório. A fonte de dados que você deseja atualizar.
• Registro - Opcional. O registro que você deseja reverter. Se você não especificar um registro, toda a fonte de dados será revertida.

Exemplo

Neste exemplo, você reverterá a fonte de dados chamada IceCream, que começa com os dados nesta tabela:

Um usuário em outro dispositivo muda a propriedade Quantity no registro Strawberry para 400. Aproximadamente no mesmo momento, altere a mesma propriedade do mesmo registro para 500, sem saber da outra alteração.

Use a função Patch para atualizar o registro:
Patch( IceCream, LookUp( IceCream, Sabor = "Morango" ), { Quantidade: 500 } )

Verifique a tabela Errors e encontre um erro:

Registro	Coluna	Mensagem	Erro
{ ID: 1, Sabor: "Morango", Quantidade: 300 }	em branco	"O registro que você está tentando modificar foi modificado por outro usuário. Reverta o registro e tente novamente."	ErrorKind.Conflito

Com base na coluna Erro, você tem um botão Recarregar para o qual a propriedade OnSelect está definida como esta fórmula:
reverter( Sorvete, LookUp( Sorvete, Sabor = "Morango" ) )

Depois de selecionar o botão Recarregar, a tabela Errors está vazia e o novo valor de Strawberry é carregado:

Reaplique a alteração sobre a alteração anterior, e a alteração será bem-sucedida, pois o conflito foi resolvido.