É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 : 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. 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 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.
• Include headers - This property supports Boolean values. Set to True to also include the DataTable headers into the workbook.
• Comment écrire : spécifie comment ajouter les données à la plage spécifiée. Les options disponibles sont les suivantes :
  • Écraser : écrase toutes les anciennes données existantes.
  • Ajouter : écrivez les données dans la première ligne vide trouvée.
  • Ajouter à droite : écrivez les données dans la première colonne vide trouvée. Consultez la section Ajout ci-dessous pour plus d'informations.
  • Insérer (Insert) : insère une ligne.
• Position de la ligne : la position d'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é Lire la plage ou Pour chaque ligne. Ce champ s'affiche si vous sélectionnez Comment écrire – Insérer. Ce champ prend en charge une entrée de type Int32 .
• Que faut-il écrire : les données de la TableDonnées qui seront écrites 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 .

Remarque :

Certaines combinaisons de caractères spéciaux dans la propriété Nom de la feuille/de la plage peuvent faire en sorte que l'activité génère une erreur. 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.

Type de plage	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ête/réponse lorsque vous travaillez avec des plages. La limite s'élève à 4 Mo, par exemple, en moyenne 10 000 cellules avec 20 caractères chacune pour les demandes de lecture, 4 000 cellules avec 20 caractères chacune pour les demandes d'écriture. Pour plus d'informations, consultez Spécifications et limites Excel.

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
• Create Workbook
• Supprimer la feuille
• Lire la cellule (Read Cell)