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 de cellule d'une colonne spécifiée (StartingCell) dans une feuille de calcul de classeur (Workbook) (NameFeuille).

After retrieving the cell value, the activity returns the column value in an Object[] (Column).

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

• 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

• Column - The values of the column as an array of objects. This field supports only Object[] variables. Required if you plan to use the output data in subsequent activities.

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