Lire la plage (Read Range)

UiPath.GSuite.Activities.ReadRangeConnections

Description

Reads and saves the contents of the specified range so you can use them in activities such as Write Range.

Remarque :

The Read Range activity is not available in API workflows.

Étendues

Cette activité nécessite les étendues suivantes :

• https://www.googleapis.com/auth/drive.readonly

OU

• https://www.googleapis.com/auth/spreadsheets.readonly

OU

• https://www.googleapis.com/auth/spreadsheets

OU

• https://www.googleapis.com/auth/drive

Compatibilité du projet

Windows | Multiplate-forme

Configuration

• Connexion Google Drive (Google Drive connection) : la connexion du compte de l'espace de travail Google à utiliser dans l'activité.

• Feuille de calcul : sélectionnez la feuille de calcul à partir de laquelle lire ou utilisez une variable/URL ou un ID et définissez une feuille de calcul avec les colonnes de plage. Avec un modèle, l'activité peut générer les plages et les colonnes. Cliquer sur le dossier pour parcourir les dossiers Google Drive et sélectionner une feuille de calcul. Cette option accepte une entrée en tant que IResource. Utilisez le bouton Voir plus pour passer aux modes Utiliser la variable ou URL ou ID (String).

  • Si vous sélectionnez Utiliser la variable, vous pouvez utiliser la variable de sortie d'autres activités, comme Créer un tableur.
  • URL de la feuille de calcul : URL ou ID de la feuille de calcul concerné. Ce champ est disponible lorsque URL ou ID est sélectionné comme mode d'entrée. Cette propriété prend en charge les variables de String et les valeurs au format chaîne. Pour plus de détails, consultez Comment récupérer les identifiants des feuilles de calcul (How to retrieve spreadsheet IDs).
  • Modèle de feuille de calcul : Le modèle de feuille de calcul à utiliser. Le champ est visible après avoir cliqué sur Utiliser le modèle de feuille de calcul. Parcourez les dossiers Google Drive et sélectionnez une feuille de calcul. Dans Studio Desktop, l'option est disponible depuis le bouton Voir plus à côté de Plage. Pour en savoir plus, consultez Travailler avec des modèles.
  • Sélectionnez l’option Recharger les données du fichier (Reload File Data) si vous avez modifié vos dossiers et que vous devez récupérer les données les plus récentes.

• 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 ou une PlageNommée, par exemple, Clients. 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.

• A des en-têtes - Indique si la première ligne de la plage est une ligne d’en-tête. Ce champ prend en charge les valeurs booléennes.

• Quoi lire : spécifie le type de valeur à lire. Les options disponibles sont Valeurs, Valeurs et formules, et Texte.

Option supplémentaire

Sortie

• Lire la plage : les informations sur la plage stockées dans une variable DataTable .
• Lire les informations : détails de la plage sélectionnée, stockés dans une variable RangeInformation .

Limitations connues des requêtes

Be aware of request or response limits when working with ranges. The limit stands at 4 MB. For example, on average 10,000 cells with 20 characters each for read requests, and 4,000 cells with 20 characters each for write requests.

Exemple

Pour plus de détails, consultez les ressources suivantes :

• Activités Sheets
• Écrire la plage (Write Range)
• Create Spreadsheet
• Pour chaque ligne de la feuille de calcul