Écrire la plage (Write Range)

UiPath.GSuite.Activities.WriteRangeConnections

Description

Écrit une table de données dans la plage indiquée depuis la feuille de calcul sélectionnée.

Étendues

Cette activité nécessite les étendues suivantes :

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

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 (Spreadsheet) : sélectionnez le fichier Google Sheet dans lequel écrire. Vous pouvez également utiliser une variable et définir un modèle de feuille de calcul. Avec un modèle, l'activité peut générer la liste déroulante des plages. Cliquez sur l'icône Dossier (Folder) pour parcourir les dossiers Google Drive et sélectionner une feuille de calcul. Cette option accepte une entrée en tant que IResource. Utiliser le bouton Plus pour passer aux modes d'entrée Utiliser la variable (Use variable) ou URL ou identifiant (Url or ID) (String).
  • Si vous sélectionnez Utiliser la variable (Use variable), vous pouvez utiliser la variable de sortie d'autres activités, telles que Créer une feuille de calcul ( Create Spreadsheet).
  • URL de la feuille decalcul : URL ou ID du tableur 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 ID de feuille de calcul ( How to Retrieve Spreadsheet IDs).
  • Modèle de feuille de calcul (Spreadsheet sample) : sélectionnez un fichier avec les mêmes plages que le fichier de variable. Le champ est visible après avoir cliqué sur Utiliser le modèle de feuille de calcul (Use spreadsheet template). Parcourez les dossiers Google Drive et sélectionnez une feuille de calcul. Dans Studio Desktop, l'option est disponible depuis le bouton Plus à côté de Plage (Range). Ce champ accepte uniquement une entrée IResource. 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 (Range) : indiquez dans quelle plage écrire ou ajouter les données. Vous pouvez ajouter une plage personnalisée, telle que Sheet1!C5:F10, ou un nom de plage nommé, par exemple Clients. 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. Cette propriété prend en charge les variables 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.

• InclureEnTêtes : si cette option est sélectionnée, les en-têtes de la table de données sont également insérés dans la feuille de calcul. Ce champ prend en charge les valeurs booléennes.

• Comment écrire - Spécifie comment ajouter les données à la plage spécifiée. Les options disponibles sont :
  • Écraser (Overwrite) : écrase toutes les données existantes.
  • Ajouter (Append ) : écrit les données dans la première ligne vide trouvée.
  • Ajouter à droite (Append Right ) : écrivez les données dans la première colonne vide trouvée. Pour plus d'informations, consultez la section Ajout ( Appending) ci-dessous.
  • Insérer (Insert) : insère une ligne.
• Que faut-il écrire (What to write) : les données DataTable qui seront écrites dans la feuille de calcul. Cette propriété prend en charge les variables de DataTable. Par exemple, vous pouvez utiliser la variable de sortie d’une activité Lire la plage (Read range).

En cours d'ajout

	Ajouter (vers le bas)	Ajouter à droite
Plage standard (notation A1)	Écrivez la plage à la première ligne vide trouvée dans la plage ciblée. Il crée le nombre de lignes nécessaires et remplit la plage avec la plage d'entrée. S'il n'y a pas de ligne vide dans la plage, ajoutez la plage tout en bas en insérant le nombre de lignes nécessaire et en ajoutant la plage d'entrée.	Écrivez la plage dans la première colonne vide trouvée dans la plage ciblée. Il crée le nombre de colonnes nécessaires et remplit la plage avec la plage d'entrée. S'il n'y a pas de colonne vide dans la plage, ajoutez la plage à droite en insérant le nombre nécessaire de colonnes et en ajoutant la plage d'entrée.
PlageNommée	Écrivez la plage à la première ligne vide trouvée dans la plage ciblée. Il crée le nombre de lignes nécessaires et remplit la plage avec la plage d'entrée. S'il n'y a pas de ligne vide dans la plage, ajoutez la plage tout en bas en insérant le nombre de lignes nécessaire et en ajoutant la plage d'entrée.	Écrivez la plage à la première ligne vide trouvée dans la plage ciblée. Il crée le nombre de lignes nécessaires et remplit la plage avec la plage d'entrée. S'il n'y a pas de ligne vide dans la plage, ajoutez la plage tout en bas en insérant le nombre de lignes nécessaire et en ajoutant la plage d'entrée.
Feuilles	Écrivez la plage à la première ligne vide trouvée dans la feuille ciblée. Il crée le nombre de lignes nécessaires et remplit la plage avec la plage d'entrée. S'il n'y a pas de ligne vide dans la plage, ajoutez la plage tout en bas en insérant le nombre de lignes nécessaire et en ajoutant la plage d'entrée.	Écrivez la plage dans la première colonne vide trouvée dans la feuille ciblée. Il crée le nombre de colonnes nécessaires et remplit la plage avec la plage d'entrée. S'il n'y a pas de colonne vide dans la plage, ajoutez la plage à droite en insérant le nombre nécessaire de colonnes et en ajoutant la plage d'entrée.

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 demandes de lecture et 4 000 cellules de 20 caractères chacune pour les demandes d'écriture.

Exemple

Voir également :

• Activités Sheets
• Lire la plage (Read Range)
• Pour chaque ligne de la feuille de calcul
• Lire la cellule (Read Cell)