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 à 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 :

• 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 ( Workbook ) : le classeur Excel à utiliser. La méthode permettant de spécifier le dossier à récupérer : Sélecteur de dossier ( Folder picker), Saisir l'ID ( Enter Id), Saisir l'URL ( Enter Url).

  • Exemple de classeur ( Workbook sample ) : le modèle de classeur à utiliser. Le champ est visible après avoir cliqué sur Utiliser le modèle de classeur (Use workbook template). Parcourez les dossiers OneDrive ou SharePoint et sélectionnez un classeur. Dans Studio Desktop, l'option est disponible depuis l'option Voir plus (See more) bouton à côté de Type de plage (Range type). 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 l'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.

  • Saisir l’ID (Enter Id ) :

    • Id du classeur (Workbook Id) : l'ID du classeur qui vous intéresse. Ce champ prend en charge les entrées de type String.
    • Adresse du site SharePoint (SharePoint site address ) : l'URL du site SharePoint qui contient le fichier ou le dossier. Ce champ prend en charge l'entrée 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 (SharePoint document library) : la bibliothèque de documents du site SharePoint indiqué qui contient le fichier ou le dossier. Ce champ prend en charge les entrées 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 (Workbook Url) : l'URL du classeur qui vous intéresse. Ce champ prend en charge les entrées 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 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 : les données d'une DataTable qui seront écrites dans un 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 :

Les appels d'API par lots sont pris en charge pour cette activité lorsqu'elle est utilisée à l'intérieur : Pour chaque e-mail ( For Each Email), Pour chaque ligne du classeur ( For Each Row in Workbook), Pour chaque fichier ou dossier ( For Each File or Folder).

Limites connues

Une erreur se produit si vous utilisez Écrire la ligne/Écrire la plage avec l’option Ajouter et si la plage de destination est une feuille qui contient une table vide au début (sans autres données). L'activité essaie d'insérer une ligne dans la feuille, au début de la table, mais l'API Graph renvoie une erreur.

Exemple

Voir également :

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