Fonctions Collect, Clear et ClearCollect dans PowerAppsCollect, Clear, and ClearCollect functions in PowerApps

Permet de créer et de supprimer des collections, ainsi que d’ajouter des enregistrements à une source de données.Creates and clears collections and adds records to any data source.

DescriptionDescription

CollectCollect

La fonction Collect ajoute des enregistrements à une source de données.The Collect function adds records to a data source. Les éléments ajoutés sont du type :The items to be added can be:

  • Une valeur unique : la valeur est placée dans le champ Value d’un nouvel enregistrement.A single value: The value is placed in the Value field of a new record. Toutes les autres propriétés sont vides.All other properties are left blank.
  • Un enregistrement : chaque propriété nommée est placée dans la propriété correspondante d’un nouvel enregistrement.A record: Each named property is placed in the corresponding property of a new record. Toutes les autres propriétés sont laissées vides.All other properties are left blank.
  • 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.A table: Each record of the table is added as a separate record of the data source as described above. La table n’est pas ajoutée à un enregistrement sous forme de table imbriquée.The table is not added as a nested table to a record. Pour cela, incluez tout d’abord la table dans un enregistrement.To accomplish this, wrap the table in a record first.

Si vous utilisez une collection, d’autres colonnes sont créées si nécessaire.When used with a collection, additional columns will be created as needed. 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.The columns for other data sources are fixed by the data source and new columns cannot be added.

Si la source de données n’existe pas, une collection est créée.If the data source doesn't already exist, a collection is created.

Les collections sont parfois utilisées pour contenir les variables globales ou effectuer une copie temporaire d’une source de données.Collections are sometimes used to hold global variables or make a temporary copy of a data source. Les applications PowerApps dépendent de formules recalculées automatiquement lorsque l’utilisateur interagit avec une application.PowerApps are based on formulas that automatically recalculate as the user interacts with an app. Les collections ne proposent pas cet avantage et peuvent compliquer la création et la compréhension de votre application.Collections do not enjoy this benefit and their use can make your app harder to create and understand. Avant d’utiliser une collection de cette manière, examinez l’utilisation des variables.Before using a collection in this manner, review working with variables.

Vous pouvez également utiliser la fonction Patch pour créer des enregistrements dans une source de données.You can also use the Patch function to create records in a data source.

La fonction Collect renvoie la source de données modifiée en tant que table.Collect returns the modified data source as a table. La fonction Collect peut uniquement être utilisée dans une formule de comportement.Collect can only be used in a behavior formula.

ClearClear

La fonction Clear supprime tous les enregistrements d’une collection,The Clear function deletes all the records of a collection. à l’exception des colonnes.The columns of the collection will remain.

Notez que Clear fonctionne uniquement sur les collections et non sur d’autres sources de données.Note that Clear only operates on collections and not other data sources. Utilisez RemoveIf( DataSource; true ) dans ce deuxième cas.You can use RemoveIf( DataSource; true ) for this purpose. 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.Use caution as this will remove all records from the data source's storage and can affect other users.

Utilisez la fonction Remove pour supprimer les enregistrements de manière sélective.You can use the Remove function to selectively remove records.

Aucune valeur n’est renvoyée avec la fonction Clear.Clear has no return value. qui peut uniquement être utilisée dans une formule de comportement.It can only be used in a behavior formula.

ClearCollectClearCollect

La fonction ClearCollect supprime tous les enregistrements d’une collection, puis ajoute un autre jeu d’enregistrements à la même collection.The ClearCollect function deletes all the records from a collection and then adds a different set of records to the same collection. ClearCollect regroupe Clear et Collect dans une même fonction.With a single function, ClearCollect offers the combination of Clear and then Collect.

ClearCollect renvoie la collection modifiée en tant que table.ClearCollect returns the modified collection as a table. La fonction ClearCollect peut uniquement être utilisée dans une formule de comportement.ClearCollect can only be used in a behavior formula.

SyntaxeSyntax

Collect( DataSource; Item; ... )Collect( DataSource; Item; ... )

  • DataSource – Requis.DataSource – Required. Source de données à laquelle ajouter des données.The data source that you want to add data to. Si elle n’existe pas déjà, une nouvelle collection est créée.If it does not already exist, a new collection is created.
  • Item(s)  : requis.Item(s) - Required. Un ou plusieurs enregistrements ou tables à ajouter à la source de données.One or more records or tables to add to the data source.

Clear( Collection )Clear( Collection )

  • Collection : requis.Collection – Required. Collection à effacer.The collection that you want to clear.

ClearCollect( Collection; Item; ... )ClearCollect( Collection; Item; ... )

  • Collection : requis.Collection – Required. Collection à effacer et à laquelle vous voulez ajouter des données.The collection that you want to clear and then add data to.
  • Item(s)  : requis.Item(s) - Required. Un ou plusieurs enregistrements ou tables à ajouter à la source de données.One or more records or tables to add to the data source.

ExemplesExamples

Suppression et ajout d’enregistrements à une source de donnéesClearing and adding records to a data source

Dans ces exemples, vous devez effacer une collection appelée IceCream puis y ajouter des éléments.In these examples, you'll erase and add to a collection that's named IceCream. La source de données commence par le contenu suivant :The data source begins with these contents:

Exemple de source de données

FormuleFormula DescriptionDescription RésultatResult
ClearCollect( IceCream; { Flavor: "Strawberry"; Quantity: 300 } )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.Clears all data from the IceCream collection and then adds a record that includes a quantity of strawberry ice cream. table avec un enregistrement Table with one record

La collection Icecream a également été modifiée.The IceCream collection has also been modified.
Collect( IceCream; { Flavor: "Pistachio"; Quantity: 40 }; { Flavor: "Orange"; Quantity: 200 } )Collect( IceCream; { Flavor: "Pistachio"; Quantity: 40 }; { Flavor: "Orange"; Quantity: 200 } ) Ajoute deux enregistrements à la collection Icecream qui inclut une quantité de pistachio et de glace orange.Adds two records to the IceCream collection that includes a quantity of pistachio and orange ice cream. table avec deux enregistrementsTable with two records

La collection Icecream a également été modifiée.The IceCream collection has also been modified.
Clear( IceCream )Clear( IceCream ) Supprime tous les enregistrements à partir de la collection IceCream.Removes all records from the IceCream collection. la table videEmpty table

La collection Icecream a également été modifiée.The IceCream collection has also been modified.

Pour obtenir des exemples pas à pas de création d’un regroupement, consultez créer et mettre à jour un regroupement.For step-by-step examples of how to create a collection, see Create and update a collection.

Enregistrements et tablesRecords and tables

Ces exemples examinent la manière dont les arguments d’enregistrement et de table à collecter et ClearCollect sont gérés.These examples examine how record and table arguments to Collect and ClearCollect are handled.

FormuleFormula DescriptionDescription RésultatResult
ClearCollect (IceCream; { Flavor : "Chocolate"; Quantity : 100 }; { Flavor : "vanille"; Quantity : 200 })ClearCollect( IceCream; { Flavor: "Chocolate"; Quantity: 100 }; { Flavor: "Vanilla"; Quantity: 200 } ) Effacez toutes les données, puis ajoutez deux enregistrements à la collection Icecream qui inclut une quantité de chocolat et de glace vanille.Clear all data and then adds two records to the IceCream collection that includes a quantity of chocolate and vanilla ice cream. Les enregistrements à ajouter sont fournis en tant qu’arguments individuels à la fonction.The records to be added are provided as individual arguments to the function. les enregistrements de chocolat et vanille ajoutés au regroupementChocolate and Vanilla records added to collection

La collection Icecream a également été modifiée.The IceCream collection has also been modified.
ClearCollect (IceCream; table ({ Flavor : "Chocolate"; Quantity : 100 }; { Flavor : "vanille"; Quantity : 200 }))ClearCollect( IceCream; Table( { Flavor: "Chocolate"; Quantity: 100 }; { Flavor: "Vanilla"; Quantity: 200 } ) ) Identique à l’exemple précédent, sauf que les enregistrements sont combinés dans une table et transmis par le biais d’un seul argument.Same as the previous example except that the records are combined in a table and passed in through a single argument. Le contenu de la table est un enregistrement extrait par enregistrement avant d’être ajouté à la collection Icecream .The contents of the table are extracted record by record before being added to the IceCream collection. les enregistrements de chocolat et vanille ajoutés au regroupementChocolate and Vanilla records added to collection

La collection Icecream a également été modifiée.The IceCream collection has also been modified.
ClearCollect (IceCream;
{ MyFavorites : table ({ Flavor : "Chocolate"; Quantity : 100 }; { Flavor : "vanille"; Quantity : 200 })})
ClearCollect( IceCream;
{ MyFavorites: Table( { Flavor: "Chocolate"; Quantity: 100 }; { Flavor: "Vanilla"; Quantity: 200 } ) } )
Identique à l’exemple précédent, sauf que la table est incluse dans un wrapper dans un enregistrement.Same as the previous example except that the table is wrapped in a record. Les enregistrements de la table ne sont pas extraits et, à la place, la table entière est ajoutée en tant que sous-table de l’enregistrement.The records of the table are not extracted and instead the entire table is added as a sub-table of the record. les enregistrements de chocolat et vanille ajoutés au regroupementChocolate and Vanilla records added to collection

La collection Icecream a également été modifiée.The IceCream collection has also been modified.