Lire la plage (Read Range)

UiPath.GSuite.Activities.ReadRangeConnections

Description

Lit et enregistre le contenu de la plage spécifiée pour que vous puissiez les utiliser dans des activités telles que Write Range.

Remarque :

L'activité Read Range n'est pas disponible dans les workflows d'API.

É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. Sélectionner le dossier icône 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 d'entrée Utiliser la variable ou URL ou identifiant (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

Tenez compte des limites de requête ou de réponse lorsque vous travaillez avec des plages. La limite est de 4 Mo. Par exemple, en moyenne 10 000 cellules avec 20 caractères chacune pour les demandes de lecture et 4 000 cellules avec 20 caractères chacune pour les demandes d’écriture.

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