For Each Excel Row

UiPath.Excel.Activities.Business.ExcelForEachRow

Exécute une ou plusieurs activités pour chaque ligne d’une plage, d’un tableau ou d’une feuille. L’activité peut être utilisée avec un fichier Excel sélectionné pour une activité parente Utiliser un fichier Excel (Use Excel File), ou avec le bloc-notes du projet.

Utilisez cette activité lorsque vous travaillez avec une plage ou une feuille comportant plusieurs lignes et que vous souhaitez répéter une ou plusieurs activités individuellement pour chaque ligne. Définissez les activités à répéter dans Excel pour chaque ligne ; lorsque vous configurez les activités, sélectionnez LigneActuelle (CurrentRow) dans le menu Plus pour indiquer que vous souhaitez répéter les actions pour chaque ligne de l’itération.

Pour la plupart des activités, vous devez également sélectionner une colonne spécifique à utiliser dans chaque ligne. Pour connaître les options disponibles pour spécifier la colonne en fonction de votre sélection de plage, consultez la section Comment fonctionne la sélection de plages. Vous pouvez également spécifier la colonne à l’aide de l’option Indiquer dans Excel (Indicate in Excel) sous LigneActuelle (CurrentRow). Dans ce cas, vous pouvez sélectionner n’importe quelle cellule de la colonne que vous souhaitez utiliser directement à partir du fichier.

Pour apprendre à utiliser cette activité, consultez :

• Tutoriel : parcourir les lignes d'une table.
• Tutoriel : travailler avec l’automatisation Word.

Configurer l'activité

Dans le corps de l’activité

• For Each : saisir le nom par lequel faire référence à la ligne active de l'itération. Le choix d'un nom représentatif des lignes de la plage facilitera l'identification et la sélection de la ligne active de l'itération lors de la configuration des activités ajoutées dans l'activité Excel « For Each Row ». Par exemple, pour une plage contenant les informations relatives à un fournisseur différent sur chaque nouvelle ligne, vous pouvez saisir Supplier. La valeur par défaut est CurrentRow.

  Lorsque deux activités Excel « Pour chaque ligne » (For Each Row) sont ajoutées l’une dans l’autre, si ce nom est identique pour ces deux activités, seule l’option de celle la plus proche apparaîtra dans le menu Plus pour les activités enfants.

• Dans la plage (In range) : cliquez sur Plus sur le côté droit du champ, puis, dans le menu, sélectionnez la plage, la table ou la feuille à utiliser, ou sélectionnez Indiquer dans Excel (Indicate in Excel) pour ouvrir le fichier et sélectionner une plage directement à partir du fichier. Vous pouvez également sélectionner Entrée personnalisée (Custom Input) pour saisir manuellement une plage, un nom de tableau ou de feuille, ou Ouvrir dans l’éditeur avancé (Open in Advanced Editor) et saisir une expression VB.
• Contient des en-têtes : si cette option est sélectionnée, cela indique que la première ligne de la plage est une ligne d'en-têtes. Lorsque vous allez ensuite configurez les activités ajoutées dans l'activité Excel « For Each Row », il vous sera facile d'identifier les données à sélectionner dans la ligne active grâce aux en-têtes de colonne.
• Enregistrer après chaque ligne : si cette option est sélectionnée, le fichier Excel sera enregistré pendant l'exécution du projet, après chaque traitement d'une ligne de l'itération. Si elle n'est pas sélectionnée, le fichier sera enregistré seulement après que toutes les lignes de l'itération auront été traitées. Cette option est désactivée par défaut.

Panneau propriétés

Commun

• NomComplet : le nom affiché pour l'activité dans le panneau Concepteur.

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).

Options

• Comportement de la ligne vide (Empty Row Behavior) : sélectionnez le comportement de l'automatisation si une ligne vide est rencontrée :

  • ArrêterAprèsTroisLignesVidesConsécutives : arrête l'itération après trois lignes vides consécutives. Il s'agit de l'option par défaut.
  • Arrêter : l'itération des lignes est interrompue.
  • Ignorer : ignorer la ligne vide et passer à la ligne suivante.
  • Traiter : traiter la ligne vide.
• AdesEn-têtes : voir AdesEn-têtes dans le corps de l’activité.
• Dans la plage : voir Dans la plage dans le corps de l’activité.
• Enregistrer chaque ligne : voir Enregistrer chaque ligne dans le corps de l'activité.

Comment fonctionne la sélection de plage

StudioX propose différentes méthodes pour définir la plage cible d'une activité Excel « For Each Row ». Les informations suivantes décrivent comment votre choix de sélection pour le champ Dans la plage va déterminer la plage à utiliser par les activités ajoutées dans l'activité Excel « For Each Row », ainsi que les options disponibles pour indiquer la colonne à utiliser à partir de la ligne active.

Feuille entière

Exemple de sélection: [Excel]Sheet1

• Plage utilisée : toutes les lignes de la feuille contenant des données.

• Options de la ligne active :

  • Si l'option « Contient des en-têtes » est sélectionnée dans l'activité Excel « For Each Row », les options disponibles seront les valeurs de la ligne 1 de la feuille.
  • Si l'option « Contient des en-têtes » n'est pas sélectionnée dans l'activité Excel « For Each Row », les options disponibles seront les lettres des colonnes (A, B, C, etc.).

Table

Exemple de sélection: [Excel]Sheet1!Table1

• Plage utilisée : toutes les lignes de la table sélectionnée.
• Options de la ligne active : les valeurs de l'en-tête de la table, que l'option « Contient des en-têtes » soit sélectionnée ou non dans l'activité Excel « For Each Row ».

PlageNommée

Exemple de sélection: [Excel]Sheet1!Range1

• Plage utilisée : toutes les lignes de la plage sélectionnée.
• Options de la ligne active :
  • Si l'option « Contient des en-têtes » est sélectionnée dans l'activité Excel « For Each Row », les options disponibles seront les valeurs de la première ligne de la plage.
  • Si l'option « Contient des en-têtes » n'est pas sélectionnée dans l'activité Excel « For Each Row », les options disponibles seront les index de colonne (colonne 1, colonne 2, etc.).

Plage sans nom

Exemple de sélection: [Excel]Sheet1!B3:F10

• Plage utilisée : toutes les lignes de la plage sélectionnée.
• Options de la ligne active :
  • Si l'option « Contient des en-têtes » est sélectionnée dans l'activité Excel « For Each Row », les options disponibles seront les valeurs de la première ligne de la sélection.
  • Si l'option « Contient des en-têtes » n'est pas sélectionnée dans l'activité Excel « For Each Row », les options disponibles seront les index de colonne (colonne 1, colonne 2, etc.).

Colonnes entières

Exemple de sélection: [Excel]Sheet1!B:F

• Plage utilisée : les lignes des colonnes sélectionnées contenant des données dans la feuille, ce qui inclut les lignes contenant des données dans d'autres colonnes que celles sélectionnées.
• Options de la ligne active :
  • Si l'option « Contient des en-têtes » est sélectionnée dans l'activité Excel « For Each Row », les options disponibles seront les valeurs de la première ligne des colonnes.
  • Si l'option « Contient des en-têtes » n'est pas sélectionnée dans l'activité Excel « For Each Row », les options disponibles seront les index de colonne (colonne 1, colonne 2, etc.).

Lignes entières

Exemple de sélection: [Excel]Sheet1!3:10

• Plage utilisée : les cellules des lignes sélectionnées contenant des données.
• Options de la ligne active :
  • Si l'option « Contient des en-têtes » est sélectionnée dans l'activité Excel « For Each Row », les options disponibles seront les valeurs de la première ligne de la sélection.
  • Si l'option « Contient des en-têtes » n'est pas sélectionnée dans l'activité Excel « For Each Row », les options disponibles seront les index de colonne (colonne 1, colonne 2, etc.).

Une seule cellule

Exemple de sélection: [Excel]Sheet1!B3

• Plage utilisée : les activités vont identifier une plage commençant par la cellule sélectionnée en tant que limite supérieure gauche et déployer la plage vers la droite et vers le bas jusqu'à ce que la feuille ne contienne plus de données. Par exemple, si la sélection est Sheet1!B3 et que Sheet1 contient des données jusqu'à la colonne AC et la ligne 115, les activités à l'intérieur de l'activité Excel « For Each Row » utiliseront la plage calculée B3:AC115.

  Si la cellule sélectionnée se trouve à droite de la dernière colonne contenant des données, ou bien en dessous de la dernière ligne contenant des données, seules les données de la cellule sélectionnée seront utilisées.

• Options de la ligne active :

  • Si l'option « Contient des en-têtes » est sélectionnée dans l'activité Excel « For Each Row », les options disponibles seront les valeurs de la première ligne de la sélection.
  • Si l'option « Contient des en-têtes » n'est pas sélectionnée dans l'activité Excel « For Each Row », les options disponibles seront les index de colonne (colonne 1, colonne 2, etc.).

Remarque : les exemples de sélection mentionnés ci-dessus peuvent différer dans StudioX. Tout dépend si vous définissez une expression sur une propriété ou si vous affichez l’aperçu de l’expression.