ClearCollect

Syntaxe

Paramètres

Description

Cette fonction permet de supprimer tous les enregistrements d'une collection et ajoute un ensemble différent d'enregistrements.

Remarques

• La fonction ClearCollect combine deux opérations : elle commence par effacer tous les enregistrements d'une collection, puis ajoute de nouveaux éléments. C'est une fonction très pratique pour réinitialiser et recharger une collection en une seule étape, ce qui réduit la complexité du code. Elle est souvent utilisée lors du rafraîchissement de données locales à partir d'une source externe.
• En utilisant ClearCollect, on s'assure que la collection ne contient aucune donnée obsolète provenant d'une opération précédente. Cela garantit l'exactitude et la fiabilité des données affichées dans l'application, surtout dans des interfaces dynamiques. Cette fonction est donc essentielle pour maintenir des données à jour dans des composantes tels que les galeries ou les formulaires.
• Le premier paramètre de ClearCollect est toujours le nom de la collection, pouvant être nouvelle ou déjà existante. Si la collection n'existait pas auparavant, elle est automatiquement créée avec la structure correspondant aux éléments fournis. Cela permet une création et une initialisation rapide des collections sans autre étape préalable.
• Le ou les items passés en deuxième paramètre peuvent provenir d'une table, d'un enregistrement ou même d'une requête. Cela rend ClearCollect extrêmement flexible, car on peut charger des données issues de sources diverses : statiques, dynamiques ou connectées. Elle peut par exemple servir à charger des résultats d'une requête filtrée depuis Dataverse ou SharePoint.
• Contrairement à la fonction Collect, ClearCollect s'assure que les anciennes données sont supprimées avant d'insérer les nouvelles. Cela évite l'accumulation involontaire de doublons ou d'éléments devenus obsolètes. C'est une fonction idéale pour des scénarios où seule la dernière version des données doit être conservée.
• Lorsque ClearCollect est utilisée avec des données volumineuses, elle peut impacter les performances si elle est exécutée trop fréquemment. Il est donc recommandé de l'utiliser de manière optimisée, en évitant les appels répétés sans nécessité. Par exemple, l'exécuter uniquement après une modification utilisateur ou une mise à jour de données réelles.
• Cette fonction ne s'applique qu'aux collections locales, c'est-à-dire à des structures de données qui résident uniquement dans la mémoire de l'application. Elle n'affecte en aucun cas les sources de données distantes, ce qui garantit une séparation claire entre les données temporaires et les données persistantes. Cela limite les risques d'erreurs ou de suppressions accidentelles de données dans les bases connectées.
• ClearCollect est souvent utilisée en conjonction avec des galeries pour afficher dynamiquement des listes filtrées ou triées. En rechargeant la collection avec de nouveaux critères, l'interface s'actualise automatiquement sans redémarrage de l'application. Cela permet de construire des interfaces utilisateur interactives et réactives avec un minimum de code.