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.
ripristinare non ha alcun valore di ritorno. Può essere usata solo in una formula di comportamento.
Sintassi
ripristinare( Origine dati [, Record ] )
- DataSource – Obbligatorio. L'origine dati da ripristinare.
- Registra - 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:
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 = "Fragola" ), { Quantità: 500 } )
Viene verificata la tabella Errors e si trova un errore:
Record | Colonna | Messaggio | Errore |
---|---|---|---|
{ ID: 1, Gusto: "Fragola", Quantità: 300 } | vuoto | "Il record che si sta tentando di modificare è oggetto di modifiche da parte di un altro utente. Ripristinare il record e riprovare." | Tipo di errore.Conflitto |
In base alla colonna Error è presente un pulsante Ricarica per il quale la proprietà OnSelect è impostata su questa formula:
ripristinare( Gelato, LookUp( Gelato, Gusto = "Fragola" ) )
Dopo aver selezionato il pulsante Ricarica, la tabella Errors è vuota ed è caricato il nuovo valore di Strawberry:
Riapplicare la modifica su quella precedente. La modifica avrà esito positivo perché è stato risolto il conflitto.