Funzione Revert

Si applica a: App canvas

Aggiorna e cancella gli errori relativi ai record di un'origine dati.

Descrizione

La funzione Revert aggiorna un'intera origine dati o un singolo record nell'origine dati. Si vedranno le modifiche apportate da altri utenti.

Per i record ripristinati, Revert cancella anche eventuali errori dalla tabella restituita dalla funzione Errors.

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.

Revert non restituisce alcun valore. Può essere usata solo in una formula di comportamento.

Sintassi

Revert( DataSource [, Record ] )

  • DataSource: obbligatorio. L'origine dati da ripristinare.
  • Record: facoltativo. Il record da ripristinare. Se non si specifica un record, verrà ripristinata l'intera origine dati.

Esempio

In questo esempio si ripristinerà l'origine dati denominata IceCream, che inizia con i dati della tabella seguente:

Esempio IceCream.

Un utente su un altro dispositivo cambia la proprietà Quantity del record Strawberry in 400. Nello stesso momento, l'utente cambia la stessa proprietà dello stesso record in 500, non essendo al corrente dell'altra modifica.

Viene usata la funzione Patch per aggiornare il record:
Patch( IceCream, LookUp( IceCream, Flavor = "Strawberry" ), { Quantity: 500 } )

Viene verificata la tabella Errors e si trova un errore:

Record Istogramma Messaggio Errore
{ ID: 1, Flavor: "Strawberry", Quantity: 300 } blank "Il record che si sta tentando di modificare è oggetto di modifiche da parte di un altro utente. Ripristinare il record e riprovare." ErrorKind.Conflict

In base alla colonna Error è presente un pulsante Ricarica per il quale la proprietà OnSelect è impostata su questa formula:
Revert( IceCream, LookUp( IceCream, Flavor = "Strawberry" ) )

Dopo aver selezionato il pulsante Ricarica, la tabella Errors è vuota ed è caricato il nuovo valore di Strawberry:

Nuovo valore per il gelato alla fragola.

Riapplicare la modifica su quella precedente. La modifica avrà esito positivo perché è stato risolto il conflitto.

Modifiche riapplicate con conflitto risolto.