Collect

Syntaxe

Paramètres

Description

Cette fonction permet de créer une collection d'enregistrements.

Remarques

• La fonction Collect est utilisée pour ajouter des éléments à une collection, qui est une structure de données temporaire en mémoire. Cela permet d'entreposer et de manipuler des ensembles d'enregistrements localement, sans interagir immédiatement avec une source de données externe. Elle est souvent utilisée pour gérer des données dans des écrans ou pour créer des listes dynamiques.
• Collect peut être utilisée avec une source de données existante ou simplement pour construire une collection à la volée. Par exemple, si aucune collection n'existe avec le nom spécifié, Power Fx la crée automatiquement. Cela permet une grande flexibilité dans le prototypage rapide d'applications.
• Chaque appel à Collect ajoute les éléments spécifiés à la collection, sans supprimer les éléments existants. C'est l'opposé de ClearCollect, effaçant d'abord la collection avant d'y insérer de nouveaux éléments. Cela permet d'ajouter progressivement des enregistrements à une liste ou de constituer une file d'attente.
• Les éléments ajoutés via Collect peuvent être des enregistrements simples ou complexes, comme des objets contenant plusieurs champs. Cela permet de modéliser des structures riches à l'intérieur d'une application sans dépendre immédiatement d'une base de données. Cette souplesse est particulièrement utile pour les formulaires ou les tableaux dynamiques.
• Une utilisation courante de Collect est de capter des réponses utilisateur (dans un quiz, un formulaire, une commande) et de les stocker temporairement. Cela permet de les manipuler, les valider ou les envoyer plus tard à une base via un enregistrement groupé. Ainsi, l'application est plus fluide et réactive pour l'utilisateur.
• Attention : les collections créées avec Collect sont volatiles, c'est-à-dire qu'elles sont perdues dès que l'utilisateur quitte l'application. Pour conserver les données, il faut les enregistrer manuellement dans une source persistante comme SharePoint ou Dataverse. Cela implique une logique d'enregistrement complémentaire.
• Collect peut également être utilisée dans des boucles ou des événements répétitifs, par exemple en réponse à un clic ou à une saisie. Il faut alors veiller à ne pas dupliquer inutilement les données ou surcharger la mémoire avec trop d'éléments. Une bonne gestion de la logique conditionnelle s'impose.
• En résumé, Collect est une fonction clé pour gérer des données temporaires dans une application Power Fx. Elle permet de créer des expériences dynamiques et interactives, tout en préparant des données en vue d'un traitement ou d'un enregistrement ultérieur. Son usage est simple, mais il faut bien gérer la persistance et la croissance des collections.