Power Apps
Gérer les collections de données dans Power Apps
Une collection garde des données en mémoire le temps d’utiliser l’application : panier de commande, liste de référence, lot de lignes à envoyer. Voici comment la créer, la modifier et l’enregistrer.
Une collection Power Apps est un tableau de données temporaire, gardé dans la mémoire de l’application le temps de son utilisation. Elle sert à préparer des lignes avant de les enregistrer, comme un panier de commande, ou à garder sous la main une liste de référence pour que les écrans répondent sans attendre le réseau. Quand l’application se ferme, son contenu disparaît, sauf si vous l’avez enregistré ailleurs.
À quoi sert une collection dans une application d’entreprise
Prenons un magasinier qui prépare une demande de réassort sur une tablette. Il ajoute douze références une par une, corrige une quantité, retire une ligne, puis envoie le tout. Si chaque geste écrivait directement dans SharePoint ou Dataverse, les acheteurs verraient une demande à moitié remplie, et chaque clic attendrait une réponse du serveur. Avec une collection, rien n’arrive dans la base avant la validation, et l’écran réagit tout de suite.
Les usages les plus courants sont les suivants :
- un panier ou une liste de lignes à composer avant envoi ;
- une liste de référence (produits, sites, motifs) chargée une seule fois au lieu d’être relue à chaque écran ;
- un lot de modifications à envoyer d’un coup vers la source de données ;
- des saisies à conserver quand le réseau manque, sur un chantier ou dans un entrepôt.
Une collection n’est pas toujours le bon outil. C’est une copie : si la source change, la collection ne suit pas, alors qu’une formule reliée à la source se recalcule seule. Pour afficher et filtrer une liste, une galerie branchée directement sur la source de données suffit le plus souvent. Microsoft fait la même mise en garde dans sa documentation de Collect, Clear et ClearCollect.
Créer une collection avec Collect et ClearCollect
Les formules de cette page sont écrites avec la virgule. Dans une interface en français, selon la langue ou les réglages régionaux, le séparateur devient le point-virgule (;), et le point-virgule qui enchaîne deux formules devient un double point-virgule (;;).
Une collection n’a pas besoin d’être déclarée : elle naît au premier Collect. Ces fonctions s’écrivent uniquement dans une propriété qui déclenche une action, par exemple OnSelect d’un bouton, OnVisible d’un écran ou OnStart de l’application. Elles ne fonctionnent pas dans Items ni dans Text.
Collect(Panier, {Produit: "Gants de sécurité", Quantite: 2})
Cette formule ajoute une ligne à la collection Panier, et la crée si elle n’existe pas encore. Les colonnes Produit et Quantite viennent de l’enregistrement fourni, c’est-à-dire de la fiche écrite entre accolades. Chaque nouveau clic ajoute une ligne de plus sans toucher aux précédentes.
ClearCollect(ClientsParis, Filter(Clients, Ville = "Paris"))
Celle-ci vide d’abord ClientsParis, puis y copie les clients parisiens de la source Clients. C’est la bonne fonction pour rafraîchir une copie : relancée dix fois, elle ne crée aucun doublon, alors que Collect en créerait.
| Fonction | Effet | À utiliser pour |
|---|---|---|
Collect |
Ajoute des lignes à ce qui existe déjà | Composer un panier, cumuler des saisies |
ClearCollect |
Vide la collection, puis ajoute des lignes | Rafraîchir une copie d’une source |
Clear |
Vide la collection, ses colonnes restent | Repartir de zéro, libérer de la mémoire |
Pour contrôler le contenu pendant la construction, ouvrez le volet Variables de Power Apps Studio, rubrique Collections : il montre les lignes présentes et leurs colonnes.
Modifier, retirer et lire les lignes
Patch(Panier, LookUp(Panier, Produit = "Gants de sécurité"), {Quantite: 5})
LookUp trouve la première ligne dont le produit correspond, puis Patch change sa quantité. Les autres colonnes de la ligne ne bougent pas. La fonction Patch s’utilise de la même façon sur une vraie source de données.
Remove(Panier, ThisItem)
Placée dans OnSelect d’une icône de corbeille, à l’intérieur d’une galerie, cette formule retire la ligne sur laquelle l’utilisateur a appuyé. ThisItem désigne la ligne affichée à cet endroit de la liste.
RemoveIf(Panier, Quantite <= 0)
Ici, toutes les lignes qui répondent à la condition disparaissent d’un coup, sans avoir à les chercher une par une.
Pour lire une collection, les fonctions habituelles s’appliquent. Aucune ne modifie les données : elles renvoient un résultat que vous affichez où vous voulez.
Filter(Panier, Quantite > 10 && Produit <> "Gants de sécurité")
Sort(Panier, Produit)
SortByColumns(Panier, "Produit", SortOrder.Descending)
CountRows(Panier)
Sum(Panier, Quantite)
La première ligne garde les quantités supérieures à 10 pour tous les produits sauf un : && veut dire « et », || veut dire « ou ». Les deux suivantes trient, la seconde par ordre décroissant. Attention à la syntaxe : l’ordre s’écrit SortOrder.Descending, et non Descending seul comme dans de nombreux anciens tutoriels. Les deux dernières comptent les lignes et additionnent les quantités.
Afficher la collection, puis enregistrer son contenu
Une collection se branche comme n’importe quelle source. Dans la propriété Items d’une galerie, écrivez Panier. Dans une étiquette placée à l’intérieur de la galerie, ThisItem.Produit affiche le produit de chaque ligne. Les listes déroulantes et les zones de liste acceptent aussi une collection, ce qui est pratique pour une liste de motifs chargée au démarrage.
Pour retenir la ligne choisie et la réutiliser dans un panneau de détail, une variable de contexte complète bien la collection :
UpdateContext({ligneChoisie: ThisItem})
La variable ligneChoisie garde toute la ligne : ligneChoisie.Produit affiche son produit sur le même écran. Pour la lire depuis un autre écran, utilisez Set, qui crée une variable globale.
Reste le moment où le panier doit devenir de vraies données. La formule suivante crée une ligne dans la table Commandes pour chaque ligne du panier :
ForAll(
Panier,
Patch(
Commandes,
Defaults(Commandes),
{Titre: ThisRecord.Produit, Quantite: ThisRecord.Quantite}
)
)
ForAll parcourt le panier, Defaults(Commandes) prépare une ligne neuve avec les valeurs par défaut de la table, et ThisRecord désigne la ligne du panier en cours de traitement. Si les colonnes portent exactement les mêmes noms des deux côtés, Collect(Commandes, Panier) suffit.
Un conseil tiré de la pratique : n’enchaînez pas Clear(Panier) juste derrière sans réfléchir. Si la source refuse une ligne, parce qu’un champ obligatoire est vide ou qu’un droit manque, cette ligne serait perdue. Quand aucune saisie ne doit se perdre, prévoyez un contrôle après l’envoi avant de vider le panier. Pour un écran de saisie simple, sans lignes multiples, un formulaire relié à la source est plus sûr et plus rapide à construire.
Limites à connaître : lignes, mémoire, hors connexion
La limite de lignes récupérées
On lit souvent qu’une collection est limitée à 2 000 lignes. Ce n’est pas tout à fait ça. La limite porte sur ce que Power Apps va chercher quand une requête ne peut pas être traitée par la source : c’est le principe de la délégation, qui fait travailler le serveur plutôt que l’appareil. Or Collect et ClearCollect ne sont pas délégables : ils ne récupèrent que les premières lignes de la source, 500 par défaut, et jusqu’à 10 000 après réglage (l’ancien plafond était de 2 000, d’où ce chiffre encore très répandu). Ce réglage se trouve dans Paramètres, Général, Limite de lignes de données. Le relever ne règle pas tout : l’application peut ralentir, et les lignes au-delà de la limite restent ignorées.
Le piège est là : sur une table de 50 000 lignes, ClearCollect(Copie, Clients) ne provoque aucune erreur à l’exécution, mais la copie est incomplète, et tout ce que vous calculez ensuite est faux. Pour le détecter pendant les essais, Microsoft conseille de régler temporairement la limite sur 1 : tout ce qui ne se délègue pas renvoie alors une seule ligne, ce qui se voit immédiatement. Le détail figure dans la présentation de la délégation par Microsoft.
Une fois en mémoire, une collection n’a plus besoin de délégation : tout le langage de formules s’applique à ses lignes, sans avertissement.
La mémoire de l’appareil
Le vrai plafond d’une collection, c’est la mémoire disponible. Microsoft indique qu’il faut s’attendre en général à une mémoire disponible de 30 à 70 Mo, variable selon l’appareil et la complexité de l’application. Les photos pèsent vite lourd. Chargez uniquement les colonnes utiles (la fonction ShowColumns sert à cela), et videz avec Clear ce qui ne sert plus.
Le hors connexion et la fermeture de l’application
Une collection déjà chargée reste utilisable sans réseau, mais elle disparaît à la fermeture de l’application. Pour la garder, enregistrez-la sur l’appareil :
SaveData(Panier, "PanierLocal")
LoadData(Panier, "PanierLocal", true)
La première ligne écrit la collection sous le nom PanierLocal. La seconde la recharge au démarrage suivant ; le true évite une erreur quand rien n’a encore été enregistré. LoadData ajoute les lignes à la collection : appelez d’abord Clear si vous voulez repartir d’une collection vide.
Ces fonctions ont des limites précises, décrites dans la documentation de SaveData et LoadData :
- 1 Mo de données au maximum dans un navigateur et dans Teams ; pas de limite fixe sur l’application mobile, seulement la mémoire de l’appareil ;
- elles ne se testent pas dans Power Apps Studio : publiez l’application et essayez-la sur un téléphone ;
- dans un navigateur, les données sont stockées en clair : aucune donnée sensible à cet endroit.
Le renvoi vers la source au retour du réseau n’a rien d’automatique : c’est à vous de l’écrire, comme avec la formule ForAll plus haut.
Quelques habitudes qui évitent les ennuis
- Nommez vos collections de façon reconnaissable, par exemple
colPanier, pour les distinguer d’une table de la source dans la barre de formule. - Regroupez les chargements dans
OnVisiblede l’écran qui en a besoin. UnOnStartchargé ralentit l’ouverture de toute l’application. - Gardez la même structure de colonnes dans tous les
Collectd’une même collection : un nom de colonne mal écrit crée une nouvelle colonne, et non une erreur. - Ne multipliez pas les copies de la même table. Chaque copie est une donnée de plus qui peut vieillir sans que personne le voie.
Les collections s’apprennent mieux sur un petit projet concret : si vous débutez, commencez par construire une première application Canvas, puis ajoutez-y un panier.
Quand faire appel à un expert pour vos collections
Un panier ou une liste de référence de quelques centaines de lignes se construisent très bien seul, avec les formules de cette page. Les choses se compliquent quand la collection porte une vraie saisie hors connexion à resynchroniser, car il faut alors arbitrer entre deux personnes qui ont modifié la même fiche. C’est aussi le cas quand vos tables dépassent largement la limite de lignes de l’application et que des résultats deviennent faux sans prévenir. À ce stade, un regard extérieur sur l’organisation des données évite de reconstruire l’application plus tard : c’est un sujet à confier à une équipe habituée aux applications métier construites avec Power Apps.
Questions fréquentes
Quelle est la différence entre Collect et ClearCollect ?
Collect ajoute des lignes à celles qui existent déjà, ce qui peut créer des doublons si vous le relancez sur les mêmes données. ClearCollect vide d’abord la collection, puis la remplit. Utilisez le premier pour composer une liste au fil des clics, le second pour rafraîchir une copie.
Comment enregistrer durablement le contenu d’une collection ?
Il faut l’écrire dans une vraie source de données, comme SharePoint, Dataverse ou SQL Server. ForAll combiné à Patch crée une ligne par élément, et Collect suffit si les colonnes portent les mêmes noms. SaveData garde les données sur l’appareil seulement : personne d’autre ne les voit.
Peut-on utiliser plusieurs collections dans une même application ?
Oui, autant que nécessaire, chacune sous son propre nom. Une application courante en compte plusieurs : un panier, une liste de motifs, une liste de sites. Surveillez simplement la mémoire totale, qui dépend de l’appareil.
Comment compter les éléments d’une collection ?
CountRows(Panier) renvoie le nombre total de lignes. Pour compter seulement une partie, combinez avec un filtre : CountRows(Filter(Panier, Quantite > 10)). Sur une collection, ce résultat est toujours complet, puisque les lignes sont déjà en mémoire.
Les collections fonctionnent-elles sans connexion ?
Une collection déjà chargée se lit et se modifie sans réseau, mais elle ne survit pas à la fermeture de l’application. Avec SaveData et LoadData, elle reste sur l’appareil d’une session à l’autre. L’envoi vers la source au retour du réseau reste à écrire, et il ne gère pas seul les conflits de modification.
À lire ensuite
- Concevoir une navigation fluide entre écransPasser d’un écran à l’autre sans se perdre : une navigation claire fait adopter une application Power Apps. Fonctions, menu, paramètres et pièges.8 min
- Concevoir des formulaires intuitifs dans Power AppsUn formulaire clair donne des données propres, un formulaire confus donne des ressaisies. Comment choisir les contrôles, organiser les champs et valider les saisies avec de vraies formules.9 min
- Comprendre et optimiser la délégation dans Power AppsSans délégation, une application Power Apps ne regarde que les premières lignes et peut donner un résultat faux sans prévenir. Comment le repérer et le corriger.9 min
- Intégrer la caméra dans vos applications Power AppsPrendre une photo depuis une application et la ranger avec le bon dossier : inspection, réclamation, chantier. Le bon contrôle, les formules et les pièges.8 min