Permet de créer et de supprimer des collections, ainsi que d’ajouter des enregistrements à une source de données.

Description

Collect

La fonction Collect ajoute des enregistrements à une source de données. Les éléments ajoutés sont du type :

  • Une valeur unique : la valeur est placée dans le champ Value d’un nouvel enregistrement. Toutes les autres propriétés sont vides.

  • Un enregistrement : chaque propriété nommée est placée dans la propriété correspondante d’un nouvel enregistrement. Toutes les autres propriétés sont laissées vides.

  • Une table : chaque enregistrement de la table est ajouté sous forme d’enregistrement séparé de la source de données, comme décrit ci-dessus. La table n’est pas ajoutée à un enregistrement sous forme de table imbriquée. Pour cela, incluez tout d’abord la table dans un enregistrement.

Si vous utilisez une collection, d’autres colonnes sont créées si nécessaire. Les colonnes d’autres sources de données sont définies par la source de données et aucune nouvelle colonne ne peut être ajoutée.

Si la source de données n’existe pas, une collection est créée.

Les collections sont parfois utilisées pour contenir les variables globales ou effectuer une copie temporaire d’une source de données. Les applications PowerApps dépendent de formules recalculées automatiquement lorsque l’utilisateur interagit avec une application. Les collections ne proposent pas cet avantage et peuvent compliquer la création et la compréhension de votre application. Avant d’utiliser une collection de cette manière, examinez l’utilisation des variables.

Vous pouvez également utiliser la fonction Patch pour créer des enregistrements dans une source de données.

La fonction Collect renvoie la source de données modifiée en tant que table. La fonction Collect peut uniquement être utilisée dans une formule de comportement.

Clear

La fonction Clear supprime tous les enregistrements d’une collection, à l’exception des colonnes.

Notez que Clear fonctionne uniquement sur les collections et non sur d’autres sources de données. Utilisez RemoveIf( DataSource, true ) dans ce deuxième cas. Soyez prudent, car vous supprimez alors tous les enregistrements de la zone de stockage de la source de données, ce qui peut avoir une incidence sur d’autres utilisateurs.

Utilisez la fonction Remove pour supprimer les enregistrements de manière sélective.

Aucune valeur n’est renvoyée avec la fonction Clear. qui peut uniquement être utilisée dans une formule de comportement.

ClearCollect

La fonction ClearCollect supprime tous les enregistrements d’une collection, puis ajoute un autre jeu d’enregistrements à la même collection. ClearCollect regroupe Clear et Collect dans une même fonction.

ClearCollect renvoie la collection modifiée en tant que table. La fonction ClearCollect peut uniquement être utilisée dans une formule de comportement.

Syntaxe

Collect( DataSource, Item, ... )

  • *DataSource* : requis. Source de données à laquelle ajouter des données. Si elle n’existe pas déjà, une nouvelle collection est créée.
  • *Item(s)* : requis. Un ou plusieurs enregistrements ou tables à ajouter à la source de données.

Clear( Collection )

  • *Collection* : requis. Collection à effacer.

ClearCollect( Collection, Item, ... )

  • *Collection* : requis. Collection à effacer et à laquelle vous voulez ajouter des données.
  • *Item(s)* : requis. Un ou plusieurs enregistrements ou tables à ajouter à la source de données.

Exemples

Suppression et ajout d’enregistrements à une source de données

Dans ces exemples, vous devez effacer une collection appelée IceCream puis y ajouter des éléments. La source de données commence par le contenu suivant :

Formule Description Résultat
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } ) Efface toutes les données à partir de la collection IceCream, puis ajoute un enregistrement qui inclut une quantité de glace à la fraise.

La source de données IceCream a également été modifiée.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } ) Ajoute deux enregistrements à la collection IceCream avec une certaine quantité de glace à la pistache et de glace à l’orange.

La source de données IceCream a également été modifiée.
Clear( IceCream ) Supprime tous les enregistrements à partir de la collection IceCream.

La source de données IceCream a également été modifiée.

Étape par étape

  1. Ajoutez un bouton, puis définissez sa propriété OnSelect en utilisant la fonction suivante :
    Collect(Products, "Europa", "Ganymede", "Callisto")

    Cette fonction crée une collection appelée Products qui contient une ligne pour chacun des trois noms de produits.

  2. Appuyez sur F5, cliquez sur le bouton, puis appuyez sur la touche ÉCHAP pour revenir à l’espace de conception.

  3. (facultatif) Pour afficher un aperçu de la collection que vous avez créée, cliquez sur Collections dans l’onglet Contenu.