Conditions liées à l'itérateur

Un itérateur de boucle est une variable qui garde une trace de l'itération en cours dans une boucle. Il est utilisé pour contrôler le nombre de fois que la boucle s'exécute et pour accéder aux éléments d'une liste ou d'un tableau à chaque itération.

Par exemple, si vous parcourez une liste d'éléments, l'itérateur de boucle vous aidera à accéder à chaque élément un par un jusqu'à ce que la boucle se termine. Le package Boucle fournit plusieurs conditions d'itérateur pour contrôler l'itération des boucles.
Tableau 1. Itérateurs de boucle
Itérateur Description
Pour chaque ligne dans CSV/TXT Répète l'ensemble des actions pour chaque ligne du fichier CSV ou texte spécifié et attribue les valeurs de la ligne actuelle à une variable d'enregistrement. Reportez-vous à la rubrique Utilisation de l'itérateur Pour chaque ligne du CSV/TXT.
Pour chaque ligne dans Données de tableau Répète l'ensemble des actions pour chaque ligne dans le tableau spécifié et attribue les valeurs de la ligne actuelle à une variable d'enregistrement. Reportez-vous à la rubrique Utilisation de l'itérateur Pour chaque ligne du tableau.
Pour chaque ligne d'un ensemble de données d'une requête SQL Répète l'ensemble des actions pour chaque ligne de l'ensemble de données de requête SQL spécifié et attribue les valeurs de la ligne actuelle à une variable d'enregistrement. Indiquez le nom de session que vous avez utilisé pour établir une connexion avec la base de données.
Pour chaque clé du Dictionnaire Répète l'ensemble des actions pour chaque clé dans la variable de dictionnaire spécifiée et attribue le nom de la clé actuelle à une variable.
Remarque : Lorsqu'un robot exécute une action Boucle qui contient une action Dictionnaire > Placer, le robot itère uniquement sur le nombre d'éléments d'origine dans un dictionnaire ; il ignore les éléments insérés à l'aide de l'action Placer.
Pour chaque valeur dans le Dictionnaire Répète l'ensemble des actions pour chaque valeur dans la variable de dictionnaire spécifiée et attribue la valeur actuelle à une variable. Ce type de variable pouvant contenir différents sous-types (String, Number, Boolean, etc.), si vous créez rapidement une variable lors de la configuration de l'action, cette variable est de type Any.
Remarque : Lorsqu'un robot exécute une action Boucle qui contient une action Dictionnaire > Placer, le robot itère uniquement sur le nombre d'éléments d'origine dans un dictionnaire ; il ignore les éléments insérés à l'aide de l'action Placer.
Pour chaque e-mail de la boîte de réception Répète l'ensemble des actions pour chaque e-mail dans la boîte de réception spécifiée. Reportez-vous à la rubrique Utilisation de l'itérateur pour chaque e-mail dans la boîte aux lettres.
Pour chaque ligne dans la feuille de calcul (Bases d'Excel ou Excel avancé) Répète l'ensemble des actions pour chaque ligne qui contient des données dans une feuille de calcul et attribue les valeurs de la ligne actuelle à une variable d'enregistrement. Indiquez le nom de session que vous avez utilisé pour ouvrir la Bases d'Excel ou la feuille de calcul Excel avancé. Indiquez si vous souhaitez répéter les actions pour toutes les lignes, les lignes spécifiées ou une plage de cellules spécifiée. Sélectionnez une variable d'enregistrement dans la liste Attribuer la ligne actuelle à cette variable, ou créez-en une nouvelle. Reportez-vous à la rubrique Variable d'enregistrement.
Cet itérateur permet de récupérer les valeurs de cellule sous forme de types de données de chaîne. Il prend en charge les formats de cellule Excel, y compris Nombre, Pourcentage, Devise, Scientifique et Date. Par exemple, une valeur d'une cellule de formatage de devise conserve le symbole de devise lorsqu'elle est transmise à une variable de tableau ou d'enregistrement.
  • Vous devez convertir les valeurs pour effectuer des opérations qui ne sont pas du type chaîne.
  • Dans Excel avancé, lorsque vous choisissez l'itérateur de boucle comme Pour chaque ligne de la feuille de calcul, vous avez une option Lire pour lire le texte visible ou la valeur de la cellule.

    Par exemple, si la cellule a 70 % comme contenu de cellule, l'option Lire la valeur de cellule lira la valeur comme 70 en ignorant le format % tandis que l'option Lire le texte visible lira le contenu comme 70 %.

    Recommendation : Utilisez l'option Lire la valeur de cellule comme valeur de lecture d'une cellule pour une meilleure performance que la lecture du texte visible.

L'utilisation de l'option Session globale pour partager une session Microsoft Excel en utilisant le package Excel avancé n'est pas disponible avec cette option.

Autre solution : Utilisez l'action Obtenir plusieurs cellules et enregistrez les données dans une variable de tableau de données, puis utilisez le package Boucle avec le Tableau de données sélectionné.
Pour chaque fichier du dossier Répète l'ensemble des actions pour chaque fichier du dossier spécifié et attribue les propriétés du fichier actuel à une variable Dictionnaire contenant deux clés : la clé name contient le nom du fichier et la clé extension contient l'extension de fichier.

Pour ouvrir des fichiers ayant des extensions différentes, utilisez l'option de variable pour attribuer le chemin du dossier, le nom du fichier et l'extension du fichier. Tout d'abord, créez une variable pour le chemin du dossier, $sFolder$. Ensuite, pour les fichiers dans le chemin du dossier, créez deux variables, une pour le nom du fichier $name$ et une autre pour l'extension du fichier $extension$. Pour ouvrir un fichier, combinez les variables sous forme de chaîne, par exemple $sFolder$\$name$.$extension$. Pour que l'extension fonctionne avec différents types de fichiers et différentes options d'ouverture, vous pouvez ajouter une logique conditionnelle.

Pour chaque dossier du dossier Répète l'ensemble des actions pour chaque dossier du dossier spécifié et attribue le nom du dossier actuel à une variable Chaîne.

Utilisez l'option Inclure tous les sous-dossiers pour parcourir de manière récursive chaque sous-dossier d'un dossier, y compris ceux masqués.
Pour chaque élément de la liste Répète l'ensemble des actions pour chaque élément de la liste spécifiée et attribue l'élément actuel à une variable. Indiquez si l'action doit être répétée pour tous les éléments de la liste ou seulement pour la plage d'éléments de la liste. Ce type de variable pouvant contenir différents sous-types (Chaîne, Nombre, Booléan, etc.), si vous créez rapidement une variable lors de la configuration de l'action, cette variable est de type N'importe lequel.
Remarque : Dans une liste, l'index commence à zéro. Par exemple, pour répéter l'action pour des éléments de la troisième position à la sixième position de la liste, spécifiez 2 et 5 dans les champs appropriés.
n fois Répète les actions dans le conteneur le nombre de fois spécifié. Vous pouvez attribuer le nombre d'itérations à une variable de nombre.
Pour chaque valeur de l'enregistrement Répète les actions pour chaque valeur dans l'enregistrement spécifié et attribue la valeur actuelle à une variable. Ce type de variable pouvant contenir différents sous-types (String, Number, Boolean, etc.), si vous créez rapidement une variable lors de la configuration de l'action, cette variable est de type Any.
Pour chaque réunion dans le calendrier Utilisez cette option pour répéter l'ensemble des actions pour chaque réunion dans le calendrier spécifié. Reportez-vous à la rubrique Utilisation des actions Calendrier Microsoft 365 dans une boucle.
Pour chaque ligne dans la feuille de calcul (Microsoft 365 Excel) Répète l'ensemble des actions pour chaque ligne contenant des données dans une feuille de calcul.
  • Indiquez le nom de session que vous avez utilisé pour ouvrir la feuille de calcul.
  • Indiquez si vous souhaitez répéter les actions pour toutes les lignes ou pour des lignes spécifiées.
  • Vous pouvez attribuer les valeurs de la ligne actuelle à une variable d'enregistrement.
Pour chaque élément de travail dans la file d'attente (Charge de travail) Répète l'ensemble d'actions pour chaque élément de travail dans une file d'attente et attribue les éléments de travail à la variable de l'enregistrement. La variable de l'enregistrement renvoie trois valeurs clés fixes : workitemId, workitemValues et workitemMetadata. Reportez-vous à la rubrique Utilisation de l'itérateur Pour chaque élément de travail dans la file d'attente
Pour chaque nœud d'un ensemble de données XML Répète l'ensemble des actions pour chaque nœud dans un ensemble de données XML et attribue le nœud actuel à la variable de chaîne. Indiquez le nom de session que vous avez utilisé pour ouvrir le fichier XML.