Lire la plage (Read Range)

UiPath.MicrosoftOffice365.Activities.Excel.ReadRangeConnections

Description

Lit et enregistre les informations d’une plage de cellules de classeur spécifiée pour les utiliser dans d’autres activités, comme l’écriture de la plage.

É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 classeur Excel à utiliser. La méthode permettant de spécifier le dossier à récupérer : Sélecteur de dossier, Saisir l'ID, Saisir l'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 une 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.

  • Option Saisir l'ID :

    • Id du classeur : l'ID du classeur qui vous intéresse. Ce champ prend en charge une entrée de type String .
    • Adresse du site SharePoint : l'URL du site SharePoint qui contient le fichier ou le dossier. Ce champ prend en charge les entrées de type String Ouvrez votre site SharePoint dans un navigateur et copiez son URL, par exemple, https://yourcompany.sharepoint.com/sites/ProductOfficial.
    • Bibliothèque de documents SharePoint : la bibliothèque de documents du site SharePoint indiqué qui contient le fichier ou le dossier. Ce champ prend en charge une entrée de type String . 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 : l'URL du classeur qui vous intéresse. Ce champ prend en charge une entrée de type String . Récupérez l'URL en ouvrant le fichier dans un navigateur.
• Plage : sélectionnez la plage à partir de laquelle lire après avoir configuré le 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 Sheet!1C5:F10, une PlageNommée, par exemple, des Clients ou un Nom de la table. Cette propriété prend en charge les variables de chaîne 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 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 la plage peuvent faire en sorte que l'activité génère une erreur. Par exemple, Sheet%Test est une entrée valide, mais Sheet%44 ne l'est pas (%44 est transformé en D).

• Has headers - This property supports Boolean values. Set to True if the first row in the range represents a header row.

Option supplémentaire

Entrée

• What to read - The type of information that is read from the cell range: Values, Values and Formulas, Text.

Sortie

• Plage de lecture : référence aux informations récupérées par l'activité (enregistrées en tant que variable TableDonnées), à utiliser dans d'autres activités, telles que Plage d'écriture.
• Lire les informations : 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ête/réponse lorsque vous travaillez avec des plages. La limite s'élève à 4 Mo, par exemple, en moyenne 10 000 cellules avec 20 caractères chacune pour les demandes de lecture, 4 000 cellules avec 20 caractères chacune pour les demandes 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)