Syntaxe
|
Remove( DataSource, Record1 [, Record2, ... ] [, RemoveFlags.All ] )
|
|
Remove( DataSource, Table [, RemoveFlags.All ] )
|
Paramètres
| Nom |
Description |
| DataSource |
Ce paramètre représente la source de données à partir de laquelle les enregistrements doivent être supprimés. Il peut s'agir d'une table liée, d'une liste ou d'une autre source de données. |
| Record1 |
Ce paramètre représente un ou plusieurs enregistrements que l'on souhaite supprimer de la source de données spécifiée. Plusieurs enregistrements peuvent être fournis sous forme de liste ou d'arguments séparés par des virgules. |
| Table |
Ce paramètre représente une table entière à partir de laquelle tous les enregistrements peuvent être supprimés. Cela est utilisé lorsque vous souhaitez supprimer tous les enregistrements d'une table spécifique. |
| RemoveFlags.All |
Ce paramètre est optionnel. Il permet de spécifier si l'on souhaite supprimer tous les enregistrements correspondant à la condition ou à la table donnée. Sans ce paramètre, la fonction supprime les enregistrements un par un, mais avec RemoveFlags.All, elle supprime tous les enregistrements d'une table ou correspondant à un critère donné. |
Description
Cette fonction permet de supprimer un ou plusieurs enregistrements d'une source de données.
Remarques
- Fonction essentielle pour la gestion des données dynamiques dans les applications : Remove est une fonction incontournable lorsque l'on souhaite
supprimer des données de manière programmatique depuis une interface utilisateur. Elle permet d'éliminer des enregistrements précis d'une source de données connectée, ce
étant crucial dans les applications où les utilisateurs doivent gérer des éléments (comme des tâches, contacts, commandes,...).
- Supporte la suppression multiple dans un seul appel : La fonction peut accepter plusieurs enregistrements comme arguments, ce qui permet de supprimer
plusieurs éléments d'un coup. Cela améliore les performances par rapport à l'utilisation répétée de Remove dans une boucle et rend le code plus concis et lisible.
- Doit être utilisée avec précaution, car la suppression est définitive : Contrairement à un système de corbeille ou d'archivage, Remove supprime
directement les données de la source. Il est donc conseillé de vérifier la validité de la sélection avant d'exécuter la fonction, ou de prévoir une confirmation
utilisateur pour éviter des suppressions accidentelles.
- Combine bien avec des filtres ou des sélections interactives : On peut combiner Remove avec des fonctions comme
Filter, LookUp pour cibler précisément les
enregistrements à supprimer. Cela permet une interaction fluide avec des éléments sélectionnés dans des galeries, des tableaux ou des formulaires.
- Le paramètre RemoveFlags.All ajoute de la puissance dans certains cas : L'option RemoveFlags.All permet de supprimer tous les enregistrements répondant à
un certain critère sans devoir les itérer individuellement. Cela est particulièrement utile pour vider complètement une table ou supprimer un sous-ensemble d'enregistrements
avec efficacité.
- Peut échouer en cas de permissions insuffisantes ou de connexions instables : Comme pour toute opération sur des sources de données, la fonction
Remove est soumise à des règles de sécurité et à la disponibilité du service distant. Si l'utilisateur n'a pas les droits de suppression ou si la connexion échoue,
la fonction renverra une erreur qu'il faut gérer correctement.
- S'utilise aussi bien sur des collections locales que des sources à distances : On peut utiliser Remove pour supprimer des éléments d'une collection
locale (ClearCollect/Collect) ou d'une source comme SharePoint,
Dataverse ou SQL. Cela rend la fonction très polyvalente dans tous
les types d'applications Power Apps.
- Non transactionnelle : attention aux suppressions partielles : Lorsque Remove est utilisé sur plusieurs enregistrements, il ne garantit pas une
suppression atomique. Si l'opération échoue au milieu, certains enregistrements peuvent être supprimés et d'autres non, ce qui peut entraîner un état de données incohérent. Il
est parfois judicieux de tester chaque suppression et de capturer les éventuelles erreurs.
Dernière mise à jour : Jeudi, le 1 Mai 2025