Ligne d'écriture (Write Row)

UiPath.MicrosoftOffice365.Activities.Excel.WriteRowConnections

Description

Écrivez une ligne dans un fichier Excel sélectionné à l'aide d'une ligne de tableau ou d'une ligne de données. Vous pouvez mapper des champs individuels aux colonnes cibles à l'aide de l' option Champs individuels sous la Ligne de données.

Étendues

Cette activité nécessite les étendues suivantes :

• Sites.Lecture.Écriture.Tout

Compatibilité du projet

Windows | Multiplate-forme

Configuration

• Connexion Microsoft Outlook 365 (Microsoft Outlook 365 connection) : la 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.

  • Exemple de classeur : le modèle de classeur à utiliser. Le champ est visible après avoir cliqué sur Utiliser le modèle de classeur. Parcourez les dossiers OneDrive ou SharePoint et sélectionnez un classeur. Dans Studio Desktop, l'option est disponible depuis la barre d'état En savoir plus à côté de Type de plage. Pour en savoir plus, consultez Travailler avec des modèles.

  • 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 (Range) : la plage dans laquelle écrire. Vous pouvez écrire des plages personnalisées en utilisant la notation A1 complète. Ce champ est prérempli avec les informations extraites du classeur ou de l’exemple de classeur sélectionné. Cette propriété prend en charge les variables de 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 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 les suivantes :

  • É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 : les données de la table de données qui seront écrites dans un classeur. Les options disponibles sont les suivantes :

  • Ligne de données : utilisez une ligne de données comme données d'entrée.
  • Ligne de tableau : utilisez 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 de LigneDonnées ou LigneTableau 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. Ce champ prend en charge les valeurs booléennes. L'option par défaut est Désactivé. Ce champ s'affiche si vous avez sélectionné l'option Quoi écrire - Champs individuels .

• Gérer les colonnes individuelles cibles : sélectionner des champs supplémentaires pour l’objet actuel. Ce champ s'affiche si vous avez sélectionné l'option Quoi écrire - Champs individuels .

Remarque :

Le regroupement des appels d’API est pris en charge pour cette activité lorsqu’elle est utilisée dans Pour chaque e-mail, Pour chaque ligne du classeur, Pour chaque fichier ou dossier.

Limites connues

Une erreur se produit si vous utilisez Ligne d'écriture/Plage d'écriture avec l'option Ajouter et que la plage de destination est une feuille contenant une table vide au début (par aucune autre donnée. L’activité tente d’insérer une ligne dans la feuille, au début du tableau, mais l’API Graph renvoie une erreur.

Exemple

Voir également :

• Activités Excel Online
• Write Column
• Écrire la cellule (Write Cell)
• Add Sheet