Stocker et gérer les valeurs dans les variables
Cet article explique comment créer et utiliser des variables pour stocker des valeurs dans vos flux de cloud. Par exemple, les variables peuvent vous aider à suivre le nombre d’exécutions d’une boucle. Pour parcourir un tableau ou chercher un élément spécifique dans un tableau, vous pouvez utiliser une variable pour référencer le numéro d’index « Appliquer à chaque » des éléments du tableau.
Vous pouvez créer des variables pour des types de données tels que entier, flottant, booléen, chaîne, tableau et objet. Après avoir créé une variable, vous pouvez effectuer d’autres tâches, par exemple :
- Obtenir ou faire référence à la valeur de la variable.
- Augmenter ou diminuer la variable d’une valeur constante, également appelée incrémentation et décrémentation.
- Affecter une valeur différente à la variable.
- Insérer ou ajouter à la fin la valeur de la variable comme dernier élément d’une chaîne ou d’un tableau.
Les variables existent et ne sont globales que dans le flux de cloud qui les crée. En outre, elles persistent à travers toutes les itérations de boucle à l’intérieur du flux.
Lorsque vous faites référence à une variable, utilisez le nom de la variable comme jeton, et non le nom de l’action, ce qui est la manière habituelle de faire référence aux sorties d’une action.
Avertissement
Par défaut, chaque itération dans les boucles « Appliquer à chaque » s’exécute de manière séquentielle. Vous pouvez exécuter les itérations de boucle en parallèle pour améliorer les performances. Si vous utilisez des variables dans les boucles « Appliquer à chaque », vous devez exécuter les itérations de boucle de manière séquentielle s’il est important que vos variables de boucle renvoient des résultats prévisibles.
Conditions préalables
Avant de pouvoir ajouter des actions pour créer et utiliser des variables, votre flux doit commencer par un déclencheur. Vous ne pouvez pas utiliser un appareil mobile pour ajouter des variables.
- Accédez à Power Automate.
- Un flux de cloud dans lequel vous souhaitez créer la variable.
- Si vous n’êtes pas familier de Power Automate, consultez Prise en main de Power Automate et Vue d’ensemble des flux de cloud.
Note
Power Automate utilise le concepteur de flux de cloud classique ou le concepteur de flux de cloud avec Copilot. Pour identifier le concepteur que vous utilisez, accédez à la section Note dans Comprendre le nouveau concepteur de flux de cloud avec les fonctionnalités de copilote.
initialiser une variable
Vous pouvez créer une variable et déclarer son type de données et sa valeur initiale, le tout dans une seule action de votre flux. Vous ne pouvez déclarer de variables qu’au niveau global, pas dans des étendues, des conditions et des boucles.
Connectez-vous à Power Automate.
Créer ou ouvrez un flux de cloud.
Sous l’étape où vous souhaitez ajouter une variable, procédez de l’une des manières suivantes.
- Pour ajouter une action sous la dernière étape, sélectionnez Nouvelle étape.
- Pour ajouter une action entre les étapes, déplacez le pointeur de votre périphérique d’entrée sur la flèche de connexion jusqu’à ce que le signe plus (+) apparaisse. Sélectionnez le signe plus (+) >Ajouter une action.
Dans le champ de recherche sous Choisir une opération, saisissez variable comme filtre.
Dans la liste Actions, sélectionnez Initialiser la variable - Variable.
Indiquez les informations suivantes au sujet de votre variable.
Propriété Obligatoire Value Description Name Oui <nom-de-la-variable> Le nom de la variable à initialiser Type Oui <Type-de-la-variable> Type de données de la variable Value Non <Valeur-de-début> Valeur initiale de votre variable Conseil : bien que ce soit facultatif, la bonne pratique consiste à définir cette valeur afin de toujours connaître la valeur de départ de votre variable.
Exemple :
Ajoutez les autres actions souhaitées. Lorsque vous avez terminé, sélectionnez Enregistrer.
Note
Bien que l’action Initialiser la variable comporte une section variable structurée comme un tableau, l’action ne peut créer qu’une seule variable à la fois. Chaque nouvelle variable nécessite une action Initialiser une variable distincte.
Exemples d’autres types de variables
Variable chaîne
"name": "myStringVariable",
"type": "String",
"value": "lorem ipsum"
Variable booléenne
"name": "myBooleanVariable",
"type": "Boolean",
"value": false
Tableau avec des entiers
"name": "myArrayVariable",
"type": "Array",
"value": [1, 2, 3]
Tableau avec des chaînes
"name": "myArrayVariable",
"type": "Array",
"value": ["red", "orange", "yellow"]
Obtenir la valeur de la variable
Pour récupérer ou référencer le contenu d’une variable, vous pouvez utiliser la fonction variables() dans le concepteur Power Automate.
Par exemple, cette expression obtient les éléments de la variable tableau en utilisant la fonction variables(). La fonction string() renvoie le contenu de la variable au format chaîne : "1, 2, 3, red"
@{string(variables('myArrayVariable'))}
Incrémenter une variable
Pour augmenter ou incrémenter une variable d’une valeur constante, ajoutez l’action Incrémenter une variable à votre flux.
Cette action fonctionne uniquement avec des variables de type entier et flottant.
Dans le concepteur Power Automate, sous l’étape où vous souhaitez augmenter une variable existante, sélectionnez Nouvelle étape.
Pour ajouter une action entre les étapes, déplacez le pointeur de votre périphérique d’entrée sur la flèche de connexion jusqu’à ce que le signe plus (+) apparaisse. Sélectionnez le signe plus (+) >Ajouter une action.
Dans la zone de recherche, entrez incrémenter une variable comme filtre.
Dans la liste Actions, sélectionnez Incrémenter la variable - Variable.
Fournissez ces informations pour incrémenter votre variable :
Propriété Obligatoire Value Description Name Oui <nom-de-la-variable> Nom de la variable à incrémenter Value Non <valeur-d’incrément> La valeur utilisée pour incrémenter la variable. La valeur par défaut est 1. Conseil : bien que ce soit facultatif, la bonne pratique consiste à définir cette valeur afin de toujours connaître la valeur d’incrémentation de votre variable.
Exemple :
Lorsque vous avez terminé, dans la barre d’outils du concepteur, sélectionnez Enregistrer.
Exemple : créer un compteur de boucle
Les variables sont couramment utilisées pour compter le nombre de fois qu’une boucle s’exécute. Cet exemple montre comment créer et utiliser des variables pour cette tâche en créant une boucle qui compte les pièces jointes dans un courrier électronique.
Dans Power Automate, créez un flux de cloud et ajoutez un déclencheur qui recherche de nouveaux courriers électroniques et des pièces jointes.
Cet exemple utilise le déclencheur Office 365 Outlook pour Lors de l’arrivée d’un nouveau message électronique. Vous pouvez configurer ce déclencheur pour qu’il se déclenche uniquement lorsque le courrier électronique contient des pièces jointes. Cependant, vous pouvez utiliser n’importe quel connecteur qui recherche de nouveaux courriers électroniques avec des pièces jointes, comme le connecteur Outlook.com.
Dans le déclencheur, pour rechercher les pièces jointes et transmettre ces pièces jointes à votre flux, sélectionnez Oui pour ces propriétés :
- Inclure des pièces jointes
- Uniquement avec des pièces jointes
Ajoutez l’action Initialiser la variable avec les valeurs suivantes :
- Nom : nombre
- Type : entier
- Valeur : 0 (valeur de début)
Ajoutez une boucle appliquer à chacun pour parcourir les pièces jointes.
- Sous l’action Initialiser une variable, sélectionnez Nouvelle étape.
- Sous Choisir une action, sélectionnez Intégré.
- Dans le champ de recherche, saisissez appliquer à chacun comme filtre de recherche, puis sélectionnez Appliquer à chacun.
Dans la boucle, faites une sélection à l’intérieur de la zone Sélectionner un résultat à partir des étapes précédentes. Lorsque la liste de contenu dynamique apparaît, sélectionnez Pièces jointes.
La propriété Attachments transmet un tableau, qui contient toutes les pièces jointes de le courrier électronique, dans votre boucle.
Dans la boucle Appliquer à chacun, sélectionnez Ajouter une action.
Dans la zone de recherche, entrez incrémenter une variable comme filtre.
Dans la liste des actions, sélectionnez Incrémenter une variable.
Note
L’action Incrémenter une variable doit apparaître à l’intérieur de la boucle.
Dans l’action Incrémenter une variable, dans la liste Nom, sélectionnez la variable Count.
Sous la boucle, ajoutez toute action qui vous renvoie le nombre de pièces jointes. Dans votre action, incluez la valeur de la variable Count, par exemple :
Dans la barre d’outils du concepteur, sélectionnez Enregistrer.
Décrémenter une variable
Pour diminuer ou décrémenter une variable d’une valeur constante, suivez les mêmes étapes que pour augmenter une variable, mais cherchez et sélectionnez l’action Décrémenter une variable à la place. Cette action fonctionne uniquement avec des variables de type entier et flottant.
Voici les propriétés de l’action Décrémenter une variable :
| Propriété | Obligatoire | Value | Description |
|---|---|---|---|
| Nom | Oui | <nom-de-la-variable> | Nom de la variable à décrémenter |
| Valeur | Non | <valeur-d’incrément> | La valeur utilisée pour décrémenter la variable. La valeur par défaut est 1. Conseil : bien que ce soit facultatif, la bonne pratique consiste à définir cette valeur afin de toujours connaître la valeur de décrémentation de votre variable. |
Définir une variable
Pour affecter une valeur différente à une variable existante, suivez les mêmes étapes que pour augmenter une variable, sauf que vous :
Cherchez et sélectionnez l’action Définir une variable à la place.
Indiquez le nom et la valeur de la variable que vous souhaitez attribuer. La nouvelle valeur et la variable doivent avoir le même type de données. La valeur est obligatoire car cette action n’a pas de valeur par défaut.
Voici les propriétés de l’action Définir une variable :
| Propriété | Obligatoire | Value | Description |
|---|---|---|---|
| Nom | Oui | <nom-de-la-variable> | Nom de la variable à modifier |
| Valeur | Oui | <nouvelle-valeur> | La valeur que vous souhaitez attribuer à la variable. Les deux doivent avoir le même type de données. |
Note
Sauf si vous incrémentez ou décrémentez des variables, le fait de changer des variables à l’intérieur des boucles peut engendrer des résultats inattendus si vous exécutez des boucles en parallèle. Dans ces cas, essayez de configurer votre boucle pour qu’elle s’exécute de manière séquentielle, ce qui est le paramètre par défaut.
Ajouter à la fin d’une variable
Pour les variables qui stockent des chaînes ou des tableaux, vous pouvez insérer ou ajouter à la fin la valeur d’une variable comme dernier élément de ces chaînes ou tableaux. Vous pouvez suivre les mêmes étapes que pour augmenter une variable, sauf que vous suivez plutôt ces étapes :
Recherchez et sélectionnez l’une de ces actions selon que votre variable est une chaîne ou un tableau.
- Ajouter à la fin d’une variable chaîne
- Ajouter à la fin d’une variable tableau
Fournissez la valeur à ajouter comme dernier élément de la chaîne ou du tableau. Cette valeur est obligatoire.
Voici les propriétés des actions Ajouter à la fin :
| Propriété | Obligatoire | Value | Description |
|---|---|---|---|
| Nom | Oui | <nom-de-la-variable> | Nom de la variable à modifier |
| Valeur | Oui | <valeur-à-ajouter> | La valeur que vous souhaitez ajouter, qui peut avoir n’importe quel type |