Écrire la plage (Write Range)

UiPath.MicrosoftOffice365.Activities.Excel.WriteRangeConnections

Description

Écrit une variable TableDonnées dans une plage de cellules de classeur Excel spécifiée.

Étendues

Cette activité nécessite les étendues suivantes :

• Fichiers.LectureÉcriture

OU

• Fichiers.ReadWrite.All

OU

• Sites.Lecture.Écriture.Tout

Compatibilité du projet

Windows | Multiplate-forme

Configuration

• Microsoft OneDrive et SharePoint : 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. Cette propriété prend en charge les variables String et les valeurs au format chaîne.
    • Adresse du site SharePoint : l'URL du site SharePoint qui contient le fichier ou le dossier. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne. 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. Cette propriété prend en charge les variables String et les valeurs au format chaîne. 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. Cette propriété prend en charge les variables String et les valeurs au format chaîne. Récupérez l'URL en ouvrant le fichier dans un navigateur.
• 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.

• Inclure les en-têtes : cette propriété prend en charge les valeurs booléennes. Défini sur True pour inclure également les en-têtes DataTable dans le classeur.

• 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.
• Position de la ligne : la position de l'index où l'activité doit insérer la ligne. L'index peut être utilisé par itération sur les lignes de la plage à l'aide de l'activité Plage de lecture (Read Range) ou Pour chaque ligne (For Each Row). Ce champ s'affiche si vous sélectionnez Comment écrire (How to write) - Insérer (Insert). Ce champ prend en charge l'entrée de type Int32 .
• Que faut-il écrire : les données de la table de données à écrire dans le classeur. Ce champ prend en charge les variables DataTable . Par exemple, vous pouvez utiliser la variable de sortie d'une activité Lire la plage (Read Range) .

Remarque : certaines combinaisons de caractères spéciaux dans la propriété Nom de la feuille/de laplage peuvent entraîner le déclenchement d’une erreur par l’activité. Par exemple, Sheet%Test est une entrée valide, mais Sheet%44 ne l'est pas (%44 est transformé en D).

En cours d'ajout

L'ajout de données ne prend actuellement pas en charge les plages nommées.

	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 requêtes de lecture, et 4 000 cellules de 20 caractères chacune pour les requêtes d'écriture. Pour plus d'informations, consultez Spécifications et limites Excel.

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

• Create Workbook
• Supprimer la feuille
• Lire la cellule (Read Cell)