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 Loop package 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 Data Table 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é dans le Dictionary 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 bot exécute une Boucle action qui contient une Dictionnaire > Placer action, le bot 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\' Placer action.
Pour chaque valeur dans le Dictionary 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 bot exécute une Boucle action qui contient une Dictionnaire > Placer action, le bot 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\'Put action.
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 (Excel basic ou Excel advanced) 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 Excel basic ou la feuille de calcul Excel advanced. 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 offre une assistance pour 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 advanced, 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 %.

    Recommandation : 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 Excel advanced package n\'est pas disponible avec cette option.

Autre solution : Utilisez l\' Obtenir plusieurs cellules action et enregistrez les données dans une variable de tableau de données, puis utilisez le Loop package avec le Tableau de données sélectionné.
Pour chaque ligne du tableau de la feuille de calcul

(Apple Numbers)
  • Utilisez l\'une des options suivantes pour fournir le nom de session :
    • Nom de session : saisissez le nom de la session utilisée pour ouvrir la feuille de calcul avec le Ouvrir action.
    • Variable : Indiquez la variable de session que vous avez ajoutée dans l\' Ouvrir action.
  • Spécifiez le nom du tableau pour extraire les valeurs.
  • Sélectionnez l\'une des options suivantes à exécuter en boucle :
    • Toute la ligne : sélectionnez cette option pour extraire toutes les données du tableau complet, comprenant chaque ligne et colonne de ce tableau.
    • Lignes spécifiques : sélectionnez cette option pour n\'extraire des données que de la ligne spécifiée dans le tableau. Renseignez les champs suivants :
      • De la ligne : spécifiez le numéro de ligne à partir duquel vous souhaitez que la valeur soit extraite. Par exemple, 10
      • À la ligne : indiquez le numéro de ligne jusqu\'auquel vous souhaitez que la valeur soit extraite. Par exemple, 40
    • Plage de cellules : sélectionnez cette option pour extraire des données d\'un bloc rectangulaire de cellules spécifié, défini par une cellule de début et une cellule de fin (par exemple, de B2 à D5). Renseignez les champs suivants :
      • De la cellule : Spécifiez l\'adresse de la cellule à partir de laquelle vous souhaitez que la valeur soit extraite. Par exemple, A1
      • À la cellule : spécifiez l\'adresse de la cellule jusqu\'à laquelle vous souhaitez que la valeur soit extraite. Par exemple, C20
  • Choisissez dans l\'option Type de valeur pour lire soit le texte visible, soit la valeur de la cellule :
    • Texte visible
    • Valeur de cellule

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

  • Dans le champ Attribuer la valeur actuelle à cette variable, sélectionnez une variable d\'enregistrement ou créez-en une pour contenir la sortie. De plus, vous pouvez stocker la sortie dans plusieurs variables en fournissant la clé et la variable à laquelle la clé est mappée.
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 de 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 (String, Number, Boolean, etc.), si vous créez rapidement une variable lors de la configuration de l\'action, la variable sera du type Any.
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 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 Microsoft 365 Calendar 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 e-mail de la boîte de réception (Apple Mail) Reportez-vous à la rubrique Utilisation de l\'itérateur Pour chaque e-mail de la boîte aux lettres pour Apple Mail.
Pour chaque e-mail de la boîte de réception (Microsoft 365 Outlook) Répète l\'ensemble des actions pour chaque e-mail dans la boîte de réception Microsoft 365 Outlook.
  • Indiquez le nom de session que vous avez utilisé pour l\' Se connecter action.
  • Spécifiez le statut de l\'e-mail que vous souhaitez utiliser avec l\'itérateur. Par exemple, pour l\'utiliser sur les e-mails que vous n\'avez pas encore lus, sélectionnez Non lus.
  • Définissez l\'ordre dans lequel vous souhaitez trier les e-mails en sélectionnant l\'une des options suivantes dans le champ Trier les e-mails :
    • Plus récent en premier : Lorsque la version Microsoft 365 Outlook package est mise à jour vers la 1.6.1 ou une version ultérieure, les automatisations existantes et nouvelles auront ce paramètre activé, et tous les e-mails de la boîte de réception seront triés par défaut selon la méthode LIFO.
    • Plus ancien en premier : Ce paramètre active la méthode FIFO pour trier les e-mails dans la boîte de réception. Ce paramètre est applicable à toutes les Microsoft 365 Outlook actions qui peuvent être effectuées à l\'aide d\'itérateurs de boucle, tels que :
      • Changer le statut
      • Supprimer
      • Transférer
      • Répondre
      • Enregistrer les pièces jointes
      • Enregistrer l\'e-mail
  • Définissez le format du message sur HTML ou texte brut.
  • Sélectionnez un fuseau horaire spécifique.
Microsoft Outlook (macOS) - Pour chaque mail dans la boîte mail Reportez-vous à la rubrique Utilisation de l\'itérateur de boucle pour Microsoft Outlook (macOS).
Pour chaque chat d\'un utilisateur (Microsoft Teams) Reportez-vous à la rubrique Using the For each chat of the user iterator.
Pour chaque canal d\'une équipe (Microsoft Teams) Reportez-vous à la rubrique Using the For each channel in a team iterator.
Pour chaque message dans un canal (Microsoft Teams) Reportez-vous à la rubrique Using the For each message in a channel iterator.
Pour chaque message dans un chat (Microsoft Teams) Reportez-vous à la rubrique Utilisation de l\'itérateur Pour chaque message dans un chat.
Pour chaque équipe (Microsoft Teams) Reportez-vous à la rubrique Using the For each team iterator.
Pour chaque élément de travail dans la file d\'attente (Workload) Répète l\'ensemble des actions pour chaque élément de travail dans une file d\'attente et attribue les éléments de travail à la variable d\'enregistrement. La variable Enregistrer renvoie trois valeurs clés fixes, à savoir 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.