Ligne d'écriture (Write Row)

UiPath.Gsuite.Activities.WriteRowConnections

Description

Écrivez une ligne dans un fichier Sheets sélectionné à l'aide d'une ligne de tableau ou d'une ligne de données. Vous pouvez mapper des champs individuels à des colonnes cibles à l'aide de l' option Champs individuels (Individual Fields) sous Ligne de données (Data Row).

Étendues

Cette activité nécessite les étendues suivantes :

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

OU

• 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 : La feuille de calcul Google à utiliser. Cliquez 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 (See more) pour passer aux modes d'entrée Utiliser la variable ( Use variable ) ou URL ou ID (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 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 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 (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) : la plage dans laquelle écrire. 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.

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

• Comment écrire - Spécifie comment ajouter les données à la plage spécifiée. Les options disponibles sont :
  • Écraser (Overwrite) : écrase toutes les anciennes données existantes. Écrit la ligne à l'emplacement exact. Si une plage comportant plusieurs cellules est sélectionnée, l'écriture s'effectuera sur la première ligne.
    • Position de la ligne : la position d'index où l'activité va écraser la ligne. L'index peut être utilisé par itération sur les lignes de la plage à l'aide de l'activité Lire la plage (Read Range) ou Pour chaque ligne (For Each Row). Commence à partir de 0.
  • Ajouter (Append) : indique comment ajouter les données à la plage spécifiée. Écrit les données dans la première ligne vide trouvée et insère une nouvelle ligne en déplaçant les cellules vers le bas.
    Remarque : l'ajout de données ne prend actuellement pas en charge les plages nommées.
  • Insérer (Insert) : insère une ligne et écrit dans la ligne nouvellement insérée.
    Remarque : si l'option « Contient des en-têtes » est définie sur True, la première ligne de la plage sera considérée comme l'en-tête et la ligne suivante sera la position de ligne numéro 0.
• Que faut-il écrire : le type de données qui seront écrites dans le classeur. Les options disponibles sont :
  • Ligne de données (Data Row) : utilise une ligne de données comme données d'entrée.
  • Ligne de tableau : utilise une ligne de tableau comme données d'entrée.
  • Champs individuels : mapper les données vers des champs cibles individuels. En utilisant des champs individuels, vous écrivez directement dans les colonnes spécifiées. Les colonnes non spécifiées ne seront pas effacées et les anciennes données seront conservées.
• Ligne de données à écrire / Ligne de tableau à écrire - Les données d'un élément DataRow ou ArrayRow qui seront écrites dans le classeur.
• Contient des en-têtes : si cette option est sélectionnée, les en-têtes de colonne seront générés en lisant l'en-tête de la plage. Cette propriété prend en charge les valeurs booléennes. L'option par défaut est Désactivé ( Off). Ce champ s'affiche si vous sélectionnez l'option Quoi écrire - Champs individuels (What to write - Individual Fields) .
• Gérer les colonnes individuelles cibles (Manage Target Individual Columns ) : sélectionnez des champs supplémentaires pour l'objet actuel. Ce champ s'affiche si vous sélectionnez l'option Quoi écrire - Champs individuels (What to write - Individual Fields) .

Remarque :

Le regroupement des appels d’API est pris en charge pour cette activité lorsqu’elle est utilisée dans Pour chaque e-mail (For Each Email), Pour chaque fichier/dossier (For Each File/Folder), Pour chaque événement (For Each Event).

Exemple

Voir également :

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