Pour chaque (For Each)

UiPath.Core.Activities.ForEach

Description

Effectue une activité ou une série d'activités,telles que spécifiées dans la section Corps, sur chaque élément d'une collection. Les éléments peuvent être référencés dans les activités de la section Corps en utilisant la variable d'itération item.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Configuration multiplateforme

• Dans (In) - Collection d'éléments à parcourir. Ce champ prend uniquement en charge les valeurs IEnumerable .

Corps

• Les activités placées à l'intérieur sont exécutées si la condition est vraie.

Afficher les propriétés supplémentaires

• Nom de l'élément ( Item name ) : le nom par lequel faire référence à l'élément actif de l'itération. L'utilisation d'un nom représentatif de l'élément facilitera son identification.

  Remarque :

  La valeur du champ Dans doit être une collection d'objets homogènes.

• Type d'argument : une liste déroulante qui permet de choisir le type de variable à utiliser avec l'activité.

• Condition : si la condition est vraie, le corps de l'activité est exécuté.
• ItérationsMax (MaxIterations) : nombre maximal d'exécutions de l'activité.
• Index (Index) - un index de base zéro qui spécifie quel élément de la collection actuelle est en cours d'itération, stocké dans une variable Int32.

Configuration de Windows

Module Designer

• Dans (In) : spécifie la liste à parcourir.

Corps

• Les activités placées à l'intérieur sont exécutées si la condition est vraie.

• Commun

  • NomAffichage ( DisplayName ) - Nom affiché du corps de l'activité.

• Divers

  • Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Panneau propriétés

• Nom de l'élément ( Item name ) : le nom par lequel faire référence à l'élément actif de l'itération. L'utilisation d'un nom représentatif de l'élément facilitera son identification.

• Type d'argument : une liste déroulante qui permet de choisir le type de variable à utiliser avec l'activité.

• Condition : si la condition est vraie, le corps de l'activité est exécuté.
• ItérationsMax (MaxIterations) : nombre maximal d'exécutions de l'activité.
• Index (Index) - un index de base zéro qui spécifie quel élément de la collection actuelle est en cours d'itération, stocké dans une variable Int32.

Configuration Windows - Héritage

Module Designer

• PourChaque (ForEach) : le nom par lequel faire référence à l'élément actif de l'itération. L'utilisation d'un nom représentatif de l'élément facilitera son identification.
• Dans (In) : spécifie la liste à parcourir.

Corps

• Les activités placées à l'intérieur sont exécutées si la condition est vraie.

Panneau propriétés

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité.

Entrée

• Condition : si la condition est vraie, le corps de l'activité est exécuté.
• ItérationsMax (MaxIterations) : nombre maximal d'exécutions de l'activité.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).
• TypeArgument : une liste déroulante qui permet de choisir quel type de variable à utiliser avec l'activité.
• Liste d'éléments (List of items) : la variable dont vous souhaitez itérer les valeurs. Ce champ prend uniquement en charge les variables IEnumerable.
  Remarque :

  • Si vous modifiez le type d'argument, le contenu de cette activité sera supprimé.
  • La valeur du champ Liste d'éléments (List of items) doit être une collection d'objets homogènes.

Sortie

• Index (Index) - un index de base zéro qui spécifie quel élément de la collection actuelle est en cours d'itération, stocké dans une variable Int32.

Exemple d'utilisation d'une activité de type Pour chaque (For Each)

Pour cet exemple, nous utilisons une simple variable IEnumerable composée de trois éléments, qui affichera chacun d'entre eux dans une Boîte de message :

1. Créez un nouveau processus et faites glisser une activité For Each dans le concepteur de workflow.
2. Dans le panneau Variables, créez une nouvelle variable IEnumerable appelée List comportant la valeur suivante :

   {"one", "two", "three"}

3. Insérez la variable List dans la propriété Valeurs de l'activité For Each.
4. Insérez une activité Message Box dans la section Corps de l'activité Pour chaque.
5. Insérez la variable d'itérateur item dans le champ de propriétés Texte de l'activité Message Box.
6. Exécutez le fichier. L'activité For Each va parcourir chacune des valeurs spécifiées dans la variable List et l'afficher dans une boîte de message distincte.