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 (Workbook) (SheetName). Après avoir récupéré la plage de données de cellule, l'activité génère les valeurs dans un DataTable (DataTable).

É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 chaîne String et les valeurs au format chaîne.

Entrée

• Plage : la plage de cellules à lire. Si aucune plage n'est spécifiée, la feuille entière 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 chaîne 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 Results) ou Create Workbook (Workbook). 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 (Add Headers ) : si cette option est sélectionnée, les en-têtes de colonne sd sont ajoutés à la première ligne de la plage dans DataTable. Ce champ prend en charge les valeurs booléennes.

• Type de valeur (Value Type ) - Type de données lues à partir du document. Utilisez la liste déroulante pour sélectionner l'une des trois options :

  • Valeurs - Par défaut. Récupère la valeur codée (c'est-à-dire le backend) des cellules de la ligne. Cela peut différer de la valeur de format affichée dans la feuille de calcul Excel (par exemple, si la cellule affiche 23,00 dans la feuille de calcul, la valeur codée renvoyée est 23).
  • Formules - Récupère la formule de la cellule spécifiée uniquement (par exemple, =SUM(A1,B1)). Si vous sélectionnez Formules et que la cellule spécifiée ne contient pas de formule, la valeur renvoyée par défaut est Values.
  • Texte (Text ) - Récupère la valeur de feuille de calcul Excel de la cellule (par exemple, si la cellule affiche 23,00 dans la feuille de calcul, la valeur de texte renvoyée est 23,00).

Sortie

• TableDonnées : le résultat de la lecture. Ce champ prend uniquement en charge 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 table de données, utilisez une activité qui a une propriété d'entrée DataTable (par exemple, 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, Find Files and Folders, Create Workbook, Copy Item).
4. Ajoutez l’activité Ajouter une feuille à l’intérieur de l’activité Étendue Microsoft Office 365.
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.