Aller au contenu
Power Platform Hub Parler à un expertUn expert

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 OnVisible de l’écran qui en a besoin. Un OnStart chargé ralentit l’ouverture de toute l’application.
  • Gardez la même structure de colonnes dans tous les Collect d’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.

Parlons de votre besoin

Décrivez ce qui vous fait perdre du temps. Nos experts vous disent quel outil convient.

  1. Vous décrivez votre besoinRéponse sous 48 h ouvrées.
  2. On en parle 40 minutesL’échange est offert.
  3. Vous voyez une maquetteAvant tout engagement.
  4. Votre outil est livréDe 4 à 6 semaines.
Ce qui vous intéresse (plusieurs choix possibles)

Vos informations servent seulement à répondre à votre demande.