Lire la plage (Read Range)

UiPath.Excel.Activities.ExcelReadRange

Lit la valeur d'une cellule Excel et la stocke dans une variable DataTable. Si la plage n'est pas spécifiée, toute la feuille de calcul est lue. Si la plage est spécifiée en tant que cellule, toute la feuille de calcul à partir de cette cellule est lue. Ne peut être utilisé que dans les activités Étendue d'application Excel (Excel Application Scope) ou Utiliser fichier Excel (Use Excel File).

Remarque :En raison d'une restriction logicielle, la lecture de cellules qui ont le format devise récupère uniquement un maximum de 4 décimales.

Propriétés

Commun

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

Entrée

• Range - Plage que vous voulez lire. Si la plage n'est pas spécifiée, la feuille de calcul entière est lue. Si la plage est spécifiée en tant que cellule, la feuille de calcul entière à partir de cette cellule est lue. Seules les variables de chaîne et les chaînes sont prises en charge.
• Nom de la feuille de calcul (SheetName) - Nom de la feuille dans laquelle se trouve la plage que vous voulez lire. Par défaut, "Sheet1" est indiqué. Seules les variables String et les chaînes sont prises en charge.

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

• Ajouter des en-têtes (AddHeaders) - Lorsque cette option est sélectionnée, les en-têtes de colonne de la plage de feuille de calcul spécifiée sont également extraits. Par défaut, cette case est cochée (définie sur True).

• ConserverFormat (PreserveFormat) : sélectionnez cette option pour lire les valeurs telles qu'elles sont affichées dans la plage (par exemple, devise, date, texte). Le formatage réel des nombres n'est pas conservé, contrairement à la manière dont les données sont affichées. Par défaut, cette option n'est pas sélectionnée.

  Remarque : la sélection de la case ConserverFormat (PreserveFormat)peut entraîner des problèmes de performances dans de grandes plages. Cela se produit car une fois cette case cochée, les cellules sont lues individuellement, au lieu d'être lues en bloc.
• Utiliser le filtre (UseFilter) - Lorsque cette option est sélectionnée, l'activité ne lit pas ce qui a été filtré hors de la plage spécifiée. Par défaut, cette case n'est pas cochée et, par conséquent, toute la plage est lue, même si certaines informations ont été filtrées.

Sortie

• DataTable : stocke les données extraites de la plage Excel spécifiée dans une variable DataTable. Seules les variables DataTable sont prises en charge.

Exemple d'utilisation de l'activité Read Range

Vous pouvez voir comment l'activité Read Range est utilisée dans un exemple qui intègre plusieurs activités.

Pour illustrer l’utilisation de cette activité, nous avons construit un projet d’automatisation qui comprend également une activité Lire une plage (Read Range).

Vous pouvez consulter et télécharger l'exemple ici