Fonction Revert

S’applique à : Applications canevas

Actualise et efface les erreurs des enregistrements d’une source de données.

Description

La fonction Revert actualise une source de données complète ou un enregistrement unique de cette source de données. Les modifications apportées par les autres utilisateurs sont alors visibles.

Pour les enregistrements rétablis, la fonction Revert efface également de la table les erreurs renvoyées par la fonction Errors.

Si la fonction Errors signale un conflit après l’exécution de la fonction Patch ou d’une autre opération sur les données, appliquez la fonction Revert à l’enregistrement pour démarrer avec la version conflictuelle et réappliquez le changement.

Aucune valeur n’est renvoyée par la fonction Revert. Vous pouvez uniquement l’utiliser dans une formule de comportement.

Syntaxe

Revert( DataSource [, Record ] )

• DataSource : obligatoire. Source de données à rétablir.
• Record : facultatif. Enregistrement à rétablir. Si vous ne spécifiez pas d’enregistrement, la source de données complète est rétablie.

Exemple

Dans cet exemple, vous allez rétablir la source de données nommée IceCream, qui commence par les données de cette table :

Un utilisateur d’un autre appareil modifie la propriété Quantity de l’enregistrement Strawberry pour lui donner la valeur 400. À peu près au même moment, vous modifiez la même propriété du même enregistrement pour lui donner la valeur 500, sans rien savoir de l’autre modification.

Vous utilisez la fonction Patch pour mettre à jour l’enregistrement :
Patch( IceCream, LookUp( IceCream, Flavor = "Strawberry" ), { Quantity: 500 } )

Vous vérifiez la table Errors et trouvez une erreur :

Enregistrement	Colonne	Message	Erreur
{ ID: 1, Flavor: "Strawberry", Quantity: 300 }	blank	« L’enregistrement que vous essayez de modifier a été modifié par un autre utilisateur. Rétablissez l’enregistrement et réessayez. »	ErrorKind.Conflict

Selon la colonne Error, vous avez un bouton Reload pour lequel la propriété OnSelect est définie sur cette formule :
Revert( IceCream, LookUp( IceCream, Flavor = "Strawberry" ) )

Après que vous avez sélectionné le bouton Reload, la table Errors est vide, et la nouvelle valeur pour Strawberry a été chargée :

Vous réappliquez votre modification par-dessus le changement précédent, et votre modification réussit du fait que le conflit a été résolu.