Lire la plage (Read Range)

UiPath.Excel.Activities.ExcelReadRange

Reads the value of an Excel range and stores it in a DataTable variable. If the range isn't specified, the whole spreadsheet is read. If the range is specified as a cell, the whole spreadsheet starting from that cell is read. Can only be used in the Excel Application Scope or Use Excel File activities.

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.
• SheetName - The name of the sheet in which the range that you want to read is. By default, this is filled in with "Sheet1." Only String variables and strings are supported.

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

To exemplify how to use this activity, we have built an automation project which also includes a Read Range activity.

Vous pouvez consulter et télécharger l'exemple à partir de Fonctions de table