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.
- Dans le concepteur, sélectionnez le signe +, puis Ajouter une action.
- Recherchez « variable », puis sélectionnez Initialiser la variable.
- 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
- Après le déclencheur, initialisez
Compteur(Entier, 0) etTotalHT(Flottant, 0). - Dans la boucle Appliquer à chacun qui parcourt les factures, ajoutez Incrémenter une variable sur
Compteur, valeur1. - 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.
À lire ensuite
- Créer un flux d’approbation automatique en 5 étapesCongés, achats, notes de frais : un flux d’approbation envoie la demande à la bonne personne, attend sa réponse et garde une trace de la décision. La méthode en 5 étapes.9 min
- Les expressions indispensables dans Power AutomateFormater une date, assembler un message, tester un champ : les expressions retravaillent vos données dans un flux. Les fonctions indispensables, avec leur syntaxe exacte et leur résultat.9 min
- Utiliser les conditions pour des flux intelligentsUne condition fait choisir à votre flux le bon chemin selon une donnée : seuil de validation, service destinataire, champ manquant. Comment la créer, avec de vraies expressions.7 min
- Automatiser avec des déclencheurs programmés dans Power AutomateLancer un flux à heure fixe, sans y penser : rapports du lundi, relances d’échéances, synchronisations. Comment régler la récurrence pour qu’elle parte vraiment à la bonne heure.8 min