Lire la ligne (Read Row)

UiPath.MicrosoftOffice365.Activities.Excel.ReadRowConnections

Description

Utilise l'API Get range de Microsoft Graph pour récupérer les valeurs des cellules d'une ligne spécifiée (StartingCell) 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é renvoie une DataRow dynamique.

Étendues

Cette activité nécessite les étendues suivantes :

• Sites.Lus.Tous

OU

• Sites.Lecture.Écriture.Tout

Compatibilité du projet

Windows | Multiplate-forme

Configuration

• Microsoft OneDrive et SharePoint : connexion du compte Microsoft 365 à utiliser dans l'activité.
• Classeur - Le DriveItem dont les données sont lues.
• Exemple de classeur : sélectionnez un fichier avec les mêmes plages que le fichier de variable. Ce champ devient visible lorsque vous sélectionnez Utiliser le modèle de classeur.
• Feuille : Nom de la feuille à partir de laquelle les données sont lues. Cette propriété prend en charge les variables String et les valeurs au format chaîne.
• Cellule : l'adresse de la cellule de départ de la ligne. Toutes les cellules contiguës à droite 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 String et les valeurs au format chaîne.

Entrée

• Type de valeur - Type de données lu à partir du document. Utilisez la liste déroulante pour sélectionner l’une des options suivantes :
  • 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).
  • Valeurs et formules - Récupère uniquement les valeurs et les formules de la cellule spécifiée ).
  • 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

• Row - The values of the row 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 Row 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.