Lire la colonne (Read Column)

UiPath.MicrosoftOffice365.Activities.Excel.ReadColumn

Description

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

Après avoir récupéré la valeur de la cellule, l'activité renvoie la valeur de la colonne dans un Object[] (Colonne).

Étendues

Cette activité nécessite les étendues suivantes :

• Fichiers.LectureÉcriture

OU

• Fichiers.ReadWrite.All

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 : adresse de la cellule de démarrage de la colonne. Toutes les cellules contiguës au-dessous de celle-ci sont renvoyées. Entrez l'adresse d'une cellule unique en notation de style A1. Cette propriété ne prend pas en charge les places de cellules (par exemple, "A1:A5"). 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 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

• Colonne : les valeurs de la colonne sous la forme d'un tableau d'objets. Ce champ prend uniquement en charge les variables Object[]. 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 colonne (Read Column) à 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.