Clear

Syntaxe

Paramètres

Description

Cette fonction permet de supprimer tous les enregistrements d'une collection.

Remarques

• La fonction Clear permet de supprimer tous les enregistrements présents dans une collection locale sans pour autant la supprimer elle-même. La structure de la collection, c'est-à-dire ses colonnes, est conservée intacte, ce qui facilite une future réutilisation. Cela s'avère particulièrement utile dans les scénarios où l'on souhaite réinitialiser temporairement des données sans devoir recréer la collection.
• Clear est souvent utilisée dans des scénarios de réinitialisation d'interface, par exemple lorsqu'un utilisateur souhaite recommencer un formulaire ou vider une liste de résultats. Cela permet de remettre l'application dans un état neutre ou initial sans perturber la logique de l'application. Cette fonction améliore ainsi l'expérience utilisateur tout en simplifiant la logique de remise à zéro.
• Il est important de noter que Clear ne supprime pas la définition de la collection, mais uniquement ses enregistrements. Cela signifie que les formules faisant référence à cette collection ne génèrent pas d'erreur, car la collection continue d'exister. Cela permet de garantir une continuité logique dans l'application, même après un nettoyage de données.
• Clear peut être utilisée conjointement avec d'autres fonctions comme Collect ou Patch, pour rafraîchir complètement les données d'une collection. Par exemple, on peut effacer la collection puis la re-remplir avec des données mises à jour, ce qui garantit que seules les dernières données sont affichées. Cela est utile lors de synchronisations avec des sources de données distantes ou après des actions utilisateurs.
• Cette fonction est également très utile lors de tests ou débogages : elle permet de vider une collection temporairement pour observer le comportement d'autres parties de l'application. On peut ainsi tester les réactions des formules, galeries ou conditions sans données présentes. Cela fait de Clear un outil précieux dans le développement et la maintenance d'applications Power Apps.
• En termes de performances, Clear est plus rapide que RemoveIf ou Remove, car elle efface tout d'un seul coup, sans avoir à évaluer de conditions. Elle est donc préférée pour des nettoyages globaux, surtout lorsque les volumes de données sont importants. Cela contribue à une meilleure réactivité de l'application.
• Attention toutefois : une fois la fonction Clear exécutée, les données effacées sont perdues de manière irréversible, sauf si elles sont rechargées ou sauvegardées au préalable. Il est donc recommandé de prévoir une confirmation utilisateur dans certains contextes, afin d'éviter les suppressions accidentelles. Cela permet de préserver l'intégrité des données manipulées temporairement.
• Enfin, Clear ne s'applique qu'aux collections locales, c'est-à-dire celles créées via Collect, ClearCollect, ou LoadData. Elle n'a aucun effet direct sur les sources de données à distances comme SharePoint, Dataverse ou SQL Server. Cela garantit que les modifications effectuées via Clear restent limitées à l'environnement local de l'application.