Funzione Revert in PowerAppsRevert function in PowerApps

Aggiorna e cancella gli errori relativi ai record di un'origine dati.Refreshes and clears errors for the records of a data source.

DescrizioneDescription

La funzione Revert aggiorna un'intera origine dati o un singolo record nell'origine dati.The Revert function refreshes an entire data source or a single record in that data source. Si vedranno le modifiche apportate da altri utenti.You'll see changes that other users made.

Per i record ripristinati, Revert cancella anche eventuali errori dalla tabella restituita dalla funzione Errors.For the records reverted, Revert also clears any errors from the table that the Errors function returned.

Se la funzione Errors segnala un conflitto dopo un'operazione Patch o altre operazioni di dati, ripristinare (Revert) il record per iniziare con la versione in conflitto e riapplicare la modifica.If the Errors function reports a conflict after a Patch or other data operation, Revert the record to start with the conflicting version and reapply the change.

Revert non restituisce alcun valore.Revert has no return value. Può essere usata solo in una formula di comportamento.You can use it only in a behavior formula.

SintassiSyntax

Revert( DataSource [, Record ] )Revert( DataSource [, Record ] )

  • OrigineDati: obbligatorio.DataSource – Required. L'origine dati da ripristinare.The data source that you want to revert.
  • Record: facoltativo.Record - Optional. Il record da ripristinare.The record that you want to revert. Se non si specifica un record, verrà ripristinata l'intera origine dati.If you don't specify a record, the entire data source is reverted.

EsempioExample

In questo esempio si ripristinerà l'origine dati denominata IceCream, che inizia con i dati della tabella seguente:In this example, you'll revert the data source named IceCream, which starts with the data in this table:

Un utente su un altro dispositivo cambia la proprietà Quantity del record Strawberry in 400.A user on another device changes the Quantity property of the Strawberry record to 400. Nello stesso momento, l'utente cambia la stessa proprietà dello stesso record in 500, non essendo al corrente dell'altra modifica.At about the same time, you change the same property of the same record to 500, not knowing about the other change.

Viene usata la funzione Patch per aggiornare il record:You use the Patch function to update the record:
Patch( IceCream, First( Filter( IceCream, Flavor = "Strawberry" ) ), { Quantity: 500 } )Patch( IceCream, First( Filter( IceCream, Flavor = "Strawberry" ) ), { Quantity: 500 } )

Viene verificata la tabella Errors e si trova un errore:You check the Errors table and find an error:

RecordRecord ColonnaColumn MessaggioMessage ErroreError
{ ID: 1, Flavor: "Strawberry", Quantity: 300 }{ ID: 1, Flavor: "Strawberry", Quantity: 300 } vuotablank "The record you are trying to modify has been modified by another user. Please revert the record and try again." (Il record che si sta provando a modificare è stato modificato da un altro utente. Ripristinare il record e riprovare.)"The record you are trying to modify has been modified by another user. Please revert the record and try again." ErrorKind.ConflictErrorKind.Conflict

In base alla colonna Error è presente un pulsante Ricarica per il quale la proprietà OnSelect è impostata su questa formula:Based on the Error column, you have a Reload button for which the OnSelect property to set to this formula:
Revert( IceCream, First( Filter( IceCream, Flavor = "Strawberry" ) ) )Revert( IceCream, First( Filter( IceCream, Flavor = "Strawberry" ) ) )

Dopo aver selezionato il pulsante Ricarica, la tabella Errors è vuota ed è caricato il nuovo valore di Strawberry:After you select the Reload button, the Errors table is empty, and the new value for Strawberry has been loaded:

Riapplicare la modifica su quella precedente. La modifica avrà esito positivo perché è stato risolto il conflitto.You reapply your change on top of the previous change, and your change succeed because the conflict has been resolved.