Lire la plage (Read Range)

UiPath.MicrosoftOffice365.Activities.Excel.ReadRange

Description

Utilise l'API Get range de Microsoft Graph pour récupérer les valeurs d'une plage de cellules spécifiée (Range) dans une feuille de calcul de classeur ) (Classeur) ) (NomFeuille). Après avoir récupéré la plage de données de cellule, l'activité génère les valeurs dans un DataTable (TableDonnées).

Étendues

Cette activité nécessite les étendues suivantes :

• Sites.Lus.Tous

OU

• Sites.Lecture.Écriture.Tout

Compatibilité du projet

Windows - Héritage | Windows

Configuration

Propriétés

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité. Cette propriété prend en charge les variables de String et les valeurs au format chaîne.

Entrée

• Plage : la plage de cellules à lire. Si aucune plage n'est spécifiée, toute la feuille est lue. Entrez votre plage de cellules en notation de style A1 (par exemple, "A1:A5"). Cette propriété prend en charge les variables String et les valeurs au format chaîne.
• Nom de la feuille - Nom de la feuille à partir de laquelle les données sont lues. Cette propriété prend en charge les variables de String et les valeurs au format chaîne.
• Classeur - Le DriveItem dont les données sont lues. Cet objet peut être récupéré à l'aide de l'activité Find Files And Folders . Utilisez la variable de propriété de sortie des activités Find Files and Folders (Premier ou Résultats) ou Créer un classeur (Classeur). Lorsque vous utilisez la propriété de sortie Results de l'activité Find Files and Folders , veillez à spécifier l'élément du tableau que vous souhaitez utiliser (par exemple, myWorkbooks(0)).

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). Ce champ prend en charge les valeurs booléennes.

Options

• Ajouter des en-têtes : si cette option est sélectionnée, la première ligne de la plage sera ajoutée en-têtes de colonnes sd dans la TableDonnées. Ce champ prend en charge les valeurs booléennes.
• Value Type - The type of data that is read from the document. Use the drop-down list to select one of the three options:
  • Values - Default. Retrieves the coded value (i.e., backend) of the cells in the row. This might differ from the format value shown in the Excel worksheet (e.g., if the cell displays 23.00 in the worksheet, the coded value returned is 23).
  • Formulas - Retrieves the formula of the specified cell only (e.g., =SUM(A1,B1)). If you select Formulas and the specified cell doesn't contain a formula, the returned value defaults to Values.
  • Text - Retrieves the Excel worksheet value of the cell (e.g., if the cell displays 23.00 in the worksheet, the text value returned is 23.00).

Sortie

• TableDonnées : le résultat de la lecture. Ce champ ne prend en charge que les variables DataTable . Obligatoire si vous prévoyez d'utiliser les données de sortie dans des activités ultérieures. Pour obtenir le contenu de la TableDonnées , utilisez une activité qui possède une propriété d'entrée DataTable (par ex., Output Data Table, For Each Row, Append to CSV, etc.).

Mode de fonctionnement

Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.

1. Effectuez les étapes.
2. Ajoutez l’activité Étendue Microsoft Office 365 à votre projet.
3. Ajoutez une activité ou exécutez un processus externe qui génère un objet DriveItem (par exemple, Rechercher des fichiers et des dossiers, Créer un classeur, Copier l'élément).
4. Add the Read Range activity inside the Microsoft Office 365 Scope activity.
5. Entrez des valeurs pour les propriétés d'entrée.
6. Créez et entrez une variable DataTable pour la propriété Output (Sortie).
7. Exécutez l’activité.
   • Les valeurs de vos propriétés d'entrée sont envoyées à l'API GetRange .
   • L'API renvoie la valeur DataTable à votre variable de propriété de sortie.