ClearData

Syntaxe

Paramètres

Description

Cette fonction permet de supprimer les données mises en cache pour une source de données.

Remarques

• La fonction ClearData() permet de supprimer les données mises en cache dans l'application, qu'il s'agisse de toutes les données ou d'une source spécifique. Elle est particulièrement utile lorsqu'on souhaite forcer le rechargement des données depuis leur source d'origine, par exemple une base Dataverse ou SharePoint. Cela évite l'utilisation de données périmées ou erronées conservées localement.
• Lorsque la fonction est appelée sans paramètre, ClearData() tente de vider tout le cache des données persistées localement. C'est une opération puissante pouvant avoir un impact global sur l'application, notamment en réinitialisant toutes les sources de données mises en cache. Elle doit donc être utilisée avec précaution dans des scénarios bien définis.
• En spécifiant un nom de source de données en paramètre, comme dans ClearData("NomSource"), la suppression est ciblée. Cela permet de conserver le cache des autres sources, tout en mettant à jour seulement celle qui est concernée. Ce comportement granulaire est idéal pour des applications qui interagissent avec plusieurs connecteurs.
• ClearData est couramment utilisée pour résoudre des problèmes de synchronisation ou de rafraîchissement de données. Par exemple, si les modifications apportées à une source ne sont pas immédiatement visibles dans l'app, cette fonction force leur relecture. Elle est donc un outil de diagnostic et de maintenance précieux pour les développeurs Power Apps.
• Cette fonction est particulièrement utile dans les applications en mode offline, reposant sur le cache local pour fonctionner sans connexion réseau. En réinitialisant le cache, ClearData prépare l'application à un nouveau cycle de synchronisation dès que la connectivité est rétablie. Elle joue ainsi un rôle important dans la gestion de la cohérence des données entre les modes hors ligne et en ligne.
• L'usage de ClearData n'a aucun effet destructif sur les données sources elles-mêmes, comme celles dans une base SQL ou une liste SharePoint. Elle ne supprime que les copies locales mises en mémoire ou stockées dans l'espace d'isolation de l'app. Cela garantit une utilisation sûre dans des contextes critiques, sans altérer les données d'entreprise.
• Pour que ClearData() fonctionne correctement, la source de données ciblée doit être configurée pour l'utilisation du cache persistant (via SaveData / LoadData). Si aucune donnée n'a été mise en cache, la fonction n'aura aucun effet observable. Elle complète donc logiquement les fonctions de sauvegarde et de chargement local.
• Il est recommandé d'utiliser ClearData dans des contextes contrôlés, comme lors d'un clic sur un bouton "Réinitialiser" ou dans des scénarios de débogage. Une utilisation excessive peut dégrader les performances, car les données devront être rechargées intégralement depuis leur source externe. Il faut donc l'intégrer dans une logique cohérente de gestion du cycle de vie des données.