Lire la ligne (Read Row)

UiPath.MicrosoftOffice365.Activities.Excel.ReadRow

Description

Utilise l'API Get range de Microsoft Graph pour récupérer les valeurs des cellules d'une ligne spécifiée (CelluleStarting) dans une feuille de calcul de classeur (Workbook) (SheetName).

Après avoir récupéré les données de toutes les cellules de la ligne, l'activité génère les valeurs dans un Object[] (Ligne).

É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

• 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.
• Cellule de départ : l'adresse de la cellule de départ de la ligne. Toutes les cellules contiguës situées à droite sont renvoyées. Entrez l'adresse d'une seule cellule en notation de style A1. Cette propriété ne prend pas en charge une plage de cellules (par exemple, "A1:A5"). Cette propriété prend en charge les variables 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

• 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

• Ligne (Row ) : les valeurs de la ligne sous forme de tableau d'objets. Ce champ ne prend en charge que Object[] variables. Obligatoire si vous prévoyez d'utiliser les données de sortie dans des activités ultérieures.

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é Lire la ligne (Read Row) à 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 Object[] 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 Object[] à votre variable de propriété de sortie.