Boucle package

Utilisez le package Boucle pour exécuter une séquence d'actions à plusieurs reprises pour un nombre de fois donné ou jusqu'à ce qu'une condition spécifique soit atteinte.

Le package Boucle vous permet d'exécuter des actions spécifiques à plusieurs reprises dans un robot. Par exemple, répéter l'ensemble des actions qui lisent les données de chaque ligne d'un fichier Microsoft Excel, renommer tous les fichiers dans un dossier, enregistrer chaque e-mail dans une boîte de réception. Vous pouvez également utiliser l'action Si dans l'action Boucle pour valider une condition, et en fonction du résultat, ignorer l'itération actuelle dans la boucle ou même rompre la boucle.

Pour les boucles conditionnelles, différentes actions sont prises suivant que les paramètres conditionnels sont satisfaits ou non. Pour les boucles ayant un nombre spécifié d'itérations, la boucle s'arrête à la dernière itération et passe à l'étape suivante dans le robot.

Lorsque vous exécutez une séquence de actions de manière répétée pendant un nombre spécifique de fois dans une boucle, la condition de fin de boucle est évaluée à chaque itération.

Par exemple, lorsque vous parcourez en boucle un Données de tableau qui comporte 10 colonnes, saisissez des valeurs dynamiques du nombre de colonnes pour la condition de fin de boucle, utilisez la fonction Table de données > Supprimer la colonneaction pour supprimer la colonne d'index 0 à l'intérieur du corps de la boucle, puis exécutez la commande robot. Le robot supprime une colonne à chaque itération. Il réduit donc le nombre d'itérations, car la condition de fin de boucle est évaluée à chaque itération.

Remarque : Vous pouvez exécuter les robots avec un nombre maximal de 97 boucles imbriquées.

Étiquettes de boucles

Vous pouvez utiliser le champ Étiquette dans les actions du package Boucle pour étiqueter les boucles utilisées dans un robot. L'étiquetage des boucles permet d'interrompre ou de poursuivre une boucle spécifique à partir de boucles imbriquées.
Remarque : Pour utiliser cette fonctionnalité, veillez à créer vos robots en utilisant la version 3.7.4 du package Boucle. Cette fonctionnalité n'est pas rétrocompatible.
Pour ajouter des étiquettes aux actions Boucle, Continuer ou Interrompre, spécifiez une étiquette pour la boucle dans le champ Étiquette.
Remarque :
  • Veillez à ce que chaque étiquette de boucle dans un robot spécifique soit unique.
  • Le champ Étiquette ne peut contenir que des caractères alphanumériques.
Consultez l'exemple suivant pour savoir comment utiliser le champ Étiquette en vue d'interrompre ou de poursuivre une boucle dans un robot :
  • Dans le champ Étiquette de la première action Boucle, spécifiez une étiquette outerloop.
  • Dans le champ Étiquette de la deuxième boucle action, spécifiez une étiquette innerloop.
  • Dans l'action Boucle > Continuer, sélectionnez l'étiquette de la boucle que vous souhaitez poursuivre dans le champ Étiquette.
  • Dans l'action Boucle > Interrompre, sélectionnez l'étiquette de la boucle que vous souhaitez interrompre dans le champ Étiquette.

Cliquez sur la vidéo pour savoir comment fonctionnent les boucles d'étiquetage.

Dans un robot, si vous avez plusieurs boucles imbriquées, les actions Boucle > Continuer et Interrompre doivent se trouver à l'intérieur des boucles imbriquées, et si vous n'avez pas étiqueté les boucles, lors de l'exécution du robot, le robot interrompt ou poursuit la boucle la plus proche par défaut.

Par exemple, vous avez :
  • Une boucle extérieure et une boucle intérieure imbriquée dans la boucle extérieure
  • Une action Boucle > Continuer et Interrompre à l'intérieur de la boucle interne
Si vous n'avez étiqueté aucune de ces boucles, lorsque vous exécutez le robot, ce dernier interrompt ou poursuit la boucle la plus proche, c'est-à-dire la boucle interne.

Actions du package Boucle

Les actions Boucle suivantes sont disponibles :

Action Description
Boucle Reportez-vous à la rubrique Utilisation de l'action Boucle.
Continuer

Reportez-vous à la rubrique Action Continuer.

Reportez-vous à la rubrique If package.
Interrompre

Reportez-vous à la rubrique action Interrompre.

Reportez-vous à la rubrique If package.

Conditions liées à l'itérateur dans l'action Boucle

Sélectionnez l'option Itérateur pour spécifier le nombre de fois où l'ensemble des actions sera répété dans le cadre de l'action 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 Dictionnaire spécifiée et attribue la valeur actuelle à une variable. 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 : 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 (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..
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 de la feuille de calcul (Office 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 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.

Conditions associées à While dans l'action Boucle

Vous pouvez configurer plusieurs conditions associées avec une seule Boucle action :
  1. Cliquez sur Ajouter une condition.
  2. Sélectionnez l'une des options suivantes :
    • Et : Les deux conditions doivent être remplies pour que les actions s'exécutent.
    • Ou : Une seule des conditions doit être remplie pour que les actions s'exécutent.
  3. Sélectionnez les conditions dans la liste déroulante.
Sélectionnez l'option While pour utiliser les conditions suivantes :
While Description
Application Utilisez la condition L'application est en cours d'exécution ou L'application n'est pas en cours d'exécution pour exécuter les actions selon que l'application est en cours d'exécution ou non.

Entrez le chemin d'application ou spécifiez le chemin à l'aide d'une variable avec le temps (en nombre de secondes) à attendre pour que cette condition soit vraie.

Remarque : Les conditions L'application est en cours d'exécution et L'application n'est pas en cours d'exécution ne sont pas applicables pour les robots Internet Explorer car son processus correspondant iexplore.exe s'exécute en arrière-plan lorsque Microsoft Edge est lancé en mode IE.
Booléen Utilisez cette condition pour exécuter des actions en fonction de la valeur d'une variable Booléen. Utilisez cette condition pour comparer les valeurs de deux variables booléennes ou d'une variable booléenne à une valeur booléenne sélectionnée.
Données de tableau Utilisez la condition Le tableau de données est vide pour exécuter des actions selon que le tableau spécifié contient ou non des valeurs.

Utilisez les conditions Nombre de lignes et Nombre de colonnes pour exécuter des actions selon que le nombre de colonnes ou de lignes est Égal à, Supérieur à, ou Inférieur à la valeur spécifiée.
Date/heure Utilisez la condition de variable Date/heure pour exécuter des actions selon que la valeur de la variable date/heure source est Égale à ou Pas égale à, Supérieure à ou Égale à, Inférieure à ou Égale à la valeur de la variable date/heure cible.
Dictionnaire Utilisez cette condition pour répéter l'ensemble des actions selon que la variable de dictionnaire sélectionnée contient la clé spécifiée ou non.
Remarque : La comparaison de clés est sensible à la casse.
File Utilisez les conditions suivantes pour exécuter l'action :
  • Date du fichier

    Utilisez cette condition pour vérifier la date et l'heure de création ou de modification du fichier spécifié. Spécifiez une date ou une plage de dates à l'aide des options À une date, Est au cours des derniers, Est entre ou Se trouve avant. Pour l'option À une date, spécifiez une date pour vérifier si le fichier a été créé ou modifié à cette date. Pour l'option Est au cours des derniers, vous devez également spécifier le nombre de jours ou la durée (en heures, minutes et secondes). Entrez la durée (en secondes) d'attente pour que cette condition soit vraie.

  • Le fichier existe et Le fichier n'existe pas

    Utilisez ces conditions pour exécuter une action en fonction de l'existence ou non d'un fichier. Par exemple, si un fichier de données existe, il sera possible de le formater et de le charger dans une base de données.

  • Extension de fichier

    Utilisez cette condition pour vérifier l'extension de fichier d'un fichier sélectionné, puis exécutez les actions en fonction des résultats. Utilisez le champ Chemin de fichier pour sélectionner un fichier.

  • Taille du fichier

    Cette condition vérifie si la taille d'un fichier est supérieure, inférieure, différente ou égale à la taille spécifiée.

    Entrez la durée (en secondes) d'attente pour que cette condition soit vraie.
Le Dossier existe ou n'existe pas Utilisez ces conditions pour répéter l'ensemble des actions selon qu'un dossier existe ou non.
Reconnaissance d'images Utilisez ces conditions pour vérifier si :
  • Le fichier de l'image est trouvé dans le fichier de l'image ou non.
  • Le fichier de l'image est trouvé dans la fenêtre ou non.
  • La fenêtre est trouvée dans le fichier de l'image ou non.
  • La fenêtre est trouvée dans la fenêtre ou non.
Pour les conditions de fenêtre, vous pouvez utiliser l'option Redimensionner la fenêtre pour spécifier les dimensions de la fenêtre. Cette option fournit un robot plus fiable. Elle redimensionne la fenêtre aux dimensions auxquelles la tâche a été enregistrée, ce qui améliore la capacité du robot à identifier l'objet cible.
Remarque : Cette option est uniquement disponible pour les fenêtres qui peuvent être redimensionnées. Elle n'est pas disponible pour les options Bureau ou Barre des tâches.

Pour la Fenêtre, vous pouvez utiliser les conditions Aperçu pour sélectionner une occurrence capturée spécifique et positionner l'emplacement de votre clic par rapport à l'image.
Javascript Utilisez la condition Le script est réussi ou Le script a échoué pour exécuter les actions en fonction du statut du Javascript spécifié. Sélectionnez le fichier contenant le script et spécifiez, à titre facultatif, les paramètres en sélectionnant une variable de liste.
Automatisation héritée Les conditions d'automatisation héritée sont uniquement utilisées dans des robots migrées pour garantir qu'elles s'exécutent de manière transparente dans Automation 360. Nous déconseillons l'utilisation de ces conditions pour un nouveau développement de robot. Les conditions suivantes à utiliser pour vérifier les éléments suivants :
  • Si le contrôle Web existe ou non.
  • Si le contrôle de fenêtre existe ou non.
  • Si le contrôle de fenêtre est actif ou non.
  • Si le script a réussi ou non.
  • Si la fenêtre enfant existe ou non.

Pour les conditions de contrôle de fenêtre, vous pouvez utiliser l'option Redimensionner la fenêtre pour spécifier les dimensions de la fenêtre. Cette option fournit un robot plus fiable. Elle redimensionne la fenêtre aux dimensions auxquelles la tâche a été enregistrée, ce qui améliore la capacité du robot à identifier l'objet cible.
Liste Utilisez la condition Variable de liste pour exécuter des actions selon que la variable de liste spécifiée contient une valeur donnée ou non. La valeur peut avoir le type de données Nombre, Chaîne ou Booléen.
Nombre Utilisez la condition Variable de nombre pour exécuter des actions selon que la variable de nombre spécifiée est Égale à ou Pas égale à, ou est Supérieure à ou Égale à, ou est Inférieure à ou Égale à une valeur particulière.
Ping Utilisez la condition Réussite de ping ou Échec du ping pour vérifier si une machine ou un serveur fonctionne et exécuter des actions sur la base du résultat. Entrez la durée (en secondes) à attendre pour que cette condition soit vraie.
Enregistreur
  • Utilisez la condition L'objet existe pour détecter un objet dans une fenêtre. Sélectionnez une fenêtre ou une variable pour capturer l'objet. Entrez la durée (en secondes) à attendre pour que cette condition soit vraie, pour que l'objet soit détecté.
  • Utilisez la condition L'objet n'existe pas pour vérifier si un objet spécifique existe dans une fenêtre, puis exécutez les actions en fonction du résultat. Entrez la durée (en secondes) d'attente pour que cette condition soit vraie. Par exemple, vous pouvez utiliser la condition L'objet n'existe pas à l'intérieur de la condition Boucle > While pour vous assurer que le robot n'exécute pas la prochaine action avant que l'objet de l'application métier ne soit chargé.
Remarque : Les conditions de l'enregistreur L'objet existe et L'objet n'existe pas prennent en charge Microsoft Edge basé sur Chromium avec le mode Internet Explorer.
Service Utilisez la condition Le service est en cours d'exécution ou Le service n'est pas en cours d'exécution pour exécuter des actions selon qu'un service est en cours d'exécution ou non. Sélectionnez Liste des services pour choisir un service dans la liste des services disponibles.
Chaîne Utilisez la condition Variable de chaîne pour exécuter des actions selon que la valeur de chaîne source spécifiée est Égale à ou Pas égale à, ou Inclut ou N'inclut pas la valeur cible.

Vous pouvez sélectionner l'option Respecter la casse pour exécuter des actions uniquement si les deux chaînes comprennent des lettres majuscules et minuscules assorties.

Lorsque vous extrayez du texte d'une application Microsoft, le texte extrait contient les caractères spéciaux /r/n qui indiquent une nouvelle ligne. Sélectionnez l'option Ignorer le retour à la ligne si vous souhaitez ignorer le caractère spécial /r lorsque vous comparez le texte.

Pour créer une condition basée sur le fait que la chaîne est vide ou non, comparez la valeur source à un champ cible vide à l'aide de l'opérateur Égal à.

Reportez-vous à la rubrique Exemple d'utilisation d'une instruction conditionnelle.
Robot de tâches Utilisez la condition Tâche réussie ou Tâche non réussie pour exécuter des actions en fonction du statut du Robot de tâches spécifié.
VBScript Utilisez la condition Le script est réussi ou Le script a échoué pour exécuter les actions en fonction du statut du script Visual Basic spécifié. Sélectionnez le fichier contenant le script et spécifiez, à titre facultatif, les paramètres en sélectionnant une variable.
Fenêtre Utilisez la condition La fenêtre existe ou La fenêtre n'existe pas pour vérifier si une fenêtre d'application spécifique est ouverte en entrant le titre de la fenêtre ou en utilisant une variable. Entrez la durée (en secondes) à attendre pour que cette condition soit vraie. Ces conditions sont utilisées lorsque le titre de la fenêtre reste constant et pour vérifier si la fenêtre spécifique est ouverte et pour exécuter d'autres actions en fonction de la sortie.

La condition La fenêtre existe utilise la même variable fenêtre pour rechercher la fenêtre spécifique dans le cache. Par exemple, lorsque vous ouvrez une page Web Yahoo Inde et exécutez une action Cliquer sur l'option Actualités de la page Web, l'action vous dirige vers une autre page qui modifie le titre de la fenêtre. Dans ce cas, lorsque vous utilisez la condition La fenêtre existe pour vérifier si la fenêtre existe, le robot récupère toujours la page Web Yahoo Inde dans le cache et exécute une action sur celle-ci, car la fenêtre est toujours la même ; seul le titre a changé. Pour plus d'informations sur le fonctionnement des variables de fenêtre, consultez la rubrique Vos variables (définies par l'utilisateur).

Utilisez la condition La fenêtre avec le même titre n'existe pas ou Une fenêtre avec le même titre existe pour vérifier si une fenêtre avec le même titre existe ou si le titre de la fenêtre a changé. Saisissez la durée (en secondes) pendant laquelle il faut continuer à vérifier si la condition est vraie. Ces conditions sont utilisées pour les titres de fenêtre dynamiques. Par exemple, lorsque vous ouvrez une page Web d'un compte Google et que vous saisissez votre nom d'utilisateur et votre mot de passe pour vous connecter à votre compte, le titre de la fenêtre change. Si vous souhaitez composer un nouvel e-mail comme action suivante, vous pouvez utiliser ces conditions avant d'exécuter la prochaine action pour vérifier si la fenêtre portant le même titre existe ou si le titre a changé.

Conditions du groupe

Utilisez l'option Ajouter un groupe pour ajouter plusieurs conditions booléennes ou combiner plusieurs conditions avec les options Et et Ou au sein d'un groupe et lorsque vous souhaitez que le robot vérifie plusieurs conditions à la fois avant d'exécuter un ensemble d'actions.

Vous pouvez également ajouter un groupe dans un groupe.