Lire la plage (Read Range)

UiPath.MicrosoftOffice365.Activities.Excel.ReadRangeConnections

Description

Lit et enregistre les informations d'une plage de cellules de classeur Excel spécifiée pour les utiliser dans d'autres activités, telles que Write Range.

É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 ( Workbook ) : le classeur Excel à utiliser. La méthode permettant de spécifier le dossier à récupérer : Sélecteur de dossier ( Folder picker), Saisir l'ID ( Enter Id), Saisir l'URL ( Enter Url).
  • Option du sélecteur de fichier/dossier : cliquez sur le dossier pour parcourir les fichiers/dossiers OneDrive ou SharePoint et sélectionner une feuille de calcul. Cette option accepte l'entrée en tant que IResource.

    • Utilisez le bouton Voir plus pour utiliser une variable ou sélectionnez l’option Recharger les données du dossier (Reload Folder Data) si vous avez modifié vos dossiers et que vous devez récupérer les données les plus récentes.

  • Saisir l’ID (Enter Id ) :

    • Id du classeur (Workbook Id) : l'ID du classeur qui vous intéresse. Cette propriété prend en charge les variables String et les valeurs au format chaîne.
    • Adresse du site SharePoint : l'URL du site SharePoint qui contient le fichier ou le dossier. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne. Ouvrez votre site SharePoint dans un navigateur et copiez son URL, par exemple, https://yourcompany.sharepoint.com/sites/ProductOfficial.
    • Bibliothèque de documents SharePoint (SharePoint document library) : la bibliothèque de documents du site SharePoint indiqué qui contient le fichier ou le dossier. Cette propriété prend en charge les variables String et les valeurs au format chaîne. Ouvrez l'onglet Documents de votre site SharePoint et copiez l'URL, par exemple, https://yourcompany.sharepoint.com/sites/ProductOfficial/Shared%20Documents/Forms/AllItems.aspx.

  • Option Saisir l’URL :

    • URL du classeur (Workbook Url) : l'URL du classeur qui vous intéresse. Cette propriété prend en charge les variables String et les valeurs au format chaîne. Récupérez l'URL en ouvrant le fichier dans un navigateur.
• Plage : sélectionnez la plage à partir de laquelle lire après la configuration du classeur. Ce champ est prérempli avec les informations extraites de la feuille de calcul ou de l’exemple de la feuille de calcul sélectionnée. Vous pouvez également ajouter une plage personnalisée, telle que Sheet1C5:F10, une PlageNommée, par exemple, des Clients ou un Nom de table. Cette propriété prend en charge les variables de String et les valeurs au format chaîne.

  • Sélectionnez l'option Mettre à jour les plages (Update Ranges) si vous avez modifié vos feuilles et que vous devez récupérer les données les plus récentes.

  • Sélectionnez l'option Mettre à jour la table ( Update Table ) si vous avez modifié votre classeur et que vous devez récupérer les données les plus récentes.

  Remarque : certaines combinaisons de caractères spéciaux dans la propriété Nom de la feuille/de laplage peuvent entraîner le déclenchement d’une erreur par l’activité. Par exemple, Sheet%Test est une entrée valide, mais Sheet%44 ne l'est pas (%44 est transformé en D).

• A des en-têtes : cette propriété prend en charge les valeurs booléennes. Défini sur True si la première ligne de la plage représente une ligne d'en-tête.

Options supplémentaires

Entrée

• Que lire (What to read ) : type d’informations lues à partir de la plage de cellules : Values, Values and Formulas, Text.

Sortie

• Plage de lecture (Read range ) : référence aux informations récupérées par l'activité (stockées en tant que variable DataTable), à utiliser dans d'autres activités, telles que Write Range.
• Lire les informations (Read information) : détails de la plage sélectionnée, stockés dans une variable RangeInformation.

Limitations connues des requêtes

Tenez compte des limites de requêtes/réponses lorsque vous travaillez avec des plages. La limite est de 4 Mo, par exemple, en moyenne 10 000 cellules de 20 caractères chacune pour les requêtes de lecture, et 4 000 cellules de 20 caractères chacune pour les requêtes d'écriture. Pour plus d'informations, consultez Spécifications et limites Excel.

Exemple

Voir également :

• Activités Excel Online

• Create Workbook
• Delete Range
• Écrire la plage (Write Range)