Aller au contenu
Power Platform Hub Parler à un expertUn expert

Power Automate

Maîtriser les variables dans Power Automate

Une variable garde une valeur pendant l’exécution d’un flux : un compteur, un total, un récapitulatif. Comment la créer, la modifier et la relire, avec les expressions exactes.

Une variable Power Automate est un espace de stockage temporaire : elle garde une valeur pendant l’exécution d’un flux, et cette valeur peut changer en chemin. Dans une entreprise, elle sert par exemple à additionner des montants, à compter des erreurs ou à construire un récapitulatif avant de l’envoyer. Voici comment la créer, la modifier et la relire, avec les expressions exactes et les pièges les plus courants.

À quoi sert une variable dans un flux

Prenons une situation type : chaque soir, un flux parcourt les factures du jour dans une liste SharePoint. Le service comptable veut recevoir un seul e-mail, avec le nombre de factures, leur total et la liste de celles qui posent problème. Aucune de ces trois informations n’existe au départ : elles se construisent ligne après ligne.

C’est le rôle des variables. Le flux en crée trois, puis les met à jour à chaque passage dans la boucle : un compteur, un total, un texte qui s’allonge. Une fois la boucle terminée, il les relit pour rédiger l’e-mail. La comptabilité reçoit ainsi un message de synthèse par jour, plutôt qu’une notification par facture.

Les six types de variables

Le type est choisi à la création et ne change plus. Le tableau donne un exemple de valeur de départ et la façon de relire la variable dans une expression.

Type Contenu Valeur de départ Exemple de lecture
Chaîne Du texte Bonjour variables('Message')
Entier Un nombre sans décimale : compteur, quantité 0 variables('Compteur')
Flottant Un nombre décimal : montant, pourcentage 0 variables('TotalHT')
Booléen Vrai ou faux : un indicateur d’état false variables('EnErreur')
Tableau Une liste de valeurs, dont la position commence à 0 [] variables('Destinataires')[0]
Objet Des couples nom et valeur, comme une réponse d’API {} variables('Fiche')?['nom']

Une fiche d’objet et une liste s’écrivent au format JSON. Dans le champ de valeur, cela donne par exemple :

{ "nom": "Durand", "montant": 1250 }

["compta@exemple.fr", "achats@exemple.fr"]

Les données renvoyées par un service externe arrivent souvent sous cette forme : le guide sur la connexion aux API REST explique comment les récupérer.

Initialiser une variable

Une variable doit être créée avant toute utilisation. Sinon, elle n’apparaît pas dans le contenu dynamique, et une expression qui la cite ne peut pas fonctionner.

  1. Dans le concepteur, sélectionnez le signe +, puis Ajouter une action.
  2. Recherchez « variable », puis sélectionnez Initialiser la variable.
  3. Renseignez le Nom (par exemple TotalHT), le Type et la Valeur de départ.

Trois règles à retenir :

  • Au niveau principal du flux seulement. On ne peut pas initialiser une variable dans une étendue, une condition ou une boucle. Placez-les toutes juste après le déclencheur.
  • Une variable par action. Chaque nouvelle variable demande sa propre action Initialiser la variable.
  • Toujours une valeur de départ. Elle est facultative, mais Microsoft recommande de la donner pour savoir exactement d’où l’on part.

Microsoft détaille chaque action dans sa page sur le stockage de valeurs dans des variables.

Modifier la valeur d’une variable

Action Types acceptés Effet
Définir une variable Tous Remplace entièrement la valeur
Incrémenter une variable Entier, Flottant Ajoute un nombre (1 par défaut)
Décrémenter une variable Entier, Flottant Retire un nombre (1 par défaut)
Ajouter à une variable chaîne Chaîne Ajoute du texte à la fin
Ajouter à une variable tableau Tableau Ajoute un élément à la fin de la liste

Le piège de Définir une variable

Dans Définir une variable, la nouvelle valeur ne peut pas utiliser la variable elle-même. Si vous tentez de définir Total avec une formule qui cite variables('Total'), Power Automate refuse le flux avec le message Self reference is not supported. Voici les bons outils selon le besoin.

  • Ajouter ou retirer un nombre : utilisez Incrémenter une variable ou Décrémenter une variable, sans formule. Le champ Valeur accepte une expression, par exemple le montant de la ligne en cours.
  • Allonger un texte ou une liste : utilisez Ajouter à une variable chaîne ou Ajouter à une variable tableau.
  • Tout autre calcul sur la variable : passez par une action Composer, qui calcule d’abord le résultat, puis recopiez-le.

Exemple pour appliquer une remise de 10 % à Total. Dans une action Composer renommée Calcul_remise, écrivez cette expression :

mul(variables('Total'), 0.9)

Puis, dans Définir une variable, choisissez Total et donnez-lui la valeur suivante :

outputs('Calcul_remise')

Rien n’empêche en revanche de définir une autre variable : TotalTTC peut recevoir directement mul(variables('TotalHT'), 1.2). Le type de la nouvelle valeur doit simplement être celui de la variable : un texte ne rentre pas dans un entier, et une action Incrémenter refuse une chaîne.

Relire une variable : les expressions à connaître

La fonction variables() prend le nom de la variable entre apostrophes droites, écrit exactement comme à l’initialisation. Pour la combiner à d’autres fonctions, le guide sur les expressions indispensables détaille la syntaxe. Voici les usages les plus fréquents.

  • Un montant en texte : concat('Total du jour : ', string(variables('TotalHT')), ' euros').
  • Une liste de destinataires, pour le champ À d’un e-mail : join(variables('Destinataires'), ';').
  • Le nombre d’éléments d’une liste : length(variables('Destinataires')).
  • Un choix selon un indicateur : if(variables('EnErreur'), 'À vérifier', 'Tout est bon').
  • Un seuil, dans une condition : greater(variables('Compteur'), 100).

Dans une carte Condition, une variable booléenne se compare à true, inséré comme expression et non comme texte. Le guide sur les conditions dans Power Automate montre le montage complet.

Exemples pratiques

Compter et additionner dans une boucle

  1. Après le déclencheur, initialisez Compteur (Entier, 0) et TotalHT (Flottant, 0).
  2. Dans la boucle Appliquer à chacun qui parcourt les factures, ajoutez Incrémenter une variable sur Compteur, valeur 1.
  3. Ajoutez une seconde action Incrémenter une variable sur TotalHT, avec cette valeur :
float(item()?['MontantHT'])

Pour un simple comptage, sans autre traitement, c’est inutile : length() donne le résultat en une seule expression, sans boucle.

Construire un message récapitulatif

Initialisez Recap (Chaîne, vide). Dans la boucle, utilisez Ajouter à une variable chaîne avec cette expression, qui ajoute une ligne par facture dans un e-mail au format HTML :

concat(item()?['Numero'], ' : ', string(item()?['MontantHT']), ' euros<br>')

Suivre un état

Initialisez EnErreur (Booléen, false). Si une ligne pose problème, utilisez Définir une variable avec la valeur true. En fin de flux, une condition décide d’envoyer une alerte ou non.

Les erreurs à éviter

  • Exécuter la boucle en parallèle. Par défaut, Appliquer à chacun traite les éléments l’un après l’autre. Si vous activez le parallélisme, Microsoft prévient que vos variables ne donnent plus de résultat prévisible : gardez le mode séquentiel dès qu’une variable est modifiée dans la boucle.
  • Oublier que la valeur persiste. Une variable garde sa valeur d’un tour de boucle au suivant. Si elle doit repartir de zéro à chaque tour, remettez-la à sa valeur de départ avec Définir une variable au début de la boucle.
  • Créer une variable pour rien. Si la valeur ne change jamais, une action Composer suffit, et elle peut se placer n’importe où, y compris dans une boucle. Chacune compte comme une action dans vos limites de requêtes, de même que l’initialisation.
  • Parcourir une liste pour la transformer. Les actions Sélectionner et Filtrer un tableau évitent souvent une boucle et une variable tableau. Le guide sur les boucles Apply to each et Do until indique dans quels cas la boucle reste nécessaire.

Pour trouver où une variable prend une mauvaise valeur, ouvrez l’historique d’exécution : chaque action montre ses entrées et ses sorties. Pour voir la valeur à un endroit précis, ajoutez temporairement un Composer avec variables('Total'). Si une action échoue et bloque le flux avant d’arriver à vos variables, le guide sur la gestion des erreurs vous aidera à le diagnostiquer.

Quand se faire accompagner sur ses flux à variables

Un compteur ou un message récapitulatif se monte très bien seul. Faire appel à un expert se justifie quand un flux enchaîne des dizaines de variables que plus personne ne sait relire, quand un total sert de base à une facturation, ou quand une boucle sur plusieurs milliers de lignes devient trop lente et approche les limites de requêtes. Il faut alors souvent revoir la conception, et pas seulement corriger une formule. Notre page sur l’automatisation avec Power Automate présente cette démarche.

Questions fréquentes

Peut-on utiliser la même variable dans plusieurs flux ?

Non. Une variable n’existe que dans le flux qui la crée. Pour partager une donnée entre flux, stockez-la dans une liste SharePoint ou une table Dataverse. Pour un réglage commun, comme une adresse ou un seuil, utilisez une variable d’environnement, qui se gère dans une solution Power Platform.

Quelle est la différence entre une variable et une expression ?

Une variable stocke une valeur et peut changer pendant l’exécution. Une expression calcule une valeur au moment où l’action s’exécute, sans la conserver. Les deux se combinent : variables('Total') est elle-même une expression, qui lit une variable.

Combien de variables peut-on créer dans un flux ?

Microsoft fixe la limite à 250 variables par flux, comme l’indique sa page sur les limites des flux. Vous n’aurez sans doute jamais à l’atteindre : au-delà d’une dizaine, le flux devient difficile à relire, et c’est le signe qu’il faut le découper.

Les variables gardent-elles leur valeur après l’exécution du flux ?

Non. Elles disparaissent à la fin de chaque exécution, et la suivante repart de la valeur de départ. Pour conserver une donnée d’une exécution à l’autre, écrivez-la dans une source externe : SharePoint, Dataverse ou un fichier Excel.

Pourquoi ma variable ne contient-elle pas la valeur attendue ?

Ouvrez l’historique d’exécution et remontez action par action, en lisant les entrées et les sorties. Les causes les plus fréquentes sont une boucle exécutée en parallèle, une valeur non remise à zéro entre deux tours ou un nombre stocké en texte. Un Composer temporaire permet de voir la valeur à l’endroit précis où elle change.

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.