É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.

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.
- File/Folder picker option: Click the Folder icon to browse the OneDrive or SharePoint files/folders and select a spreadsheet. This option accepts input as IResource.
  - Utilisez le bouton Voir plus pour utiliser une variable ou sélectionnez l'option Recharger le sélecteur de dossier ( Reload Folder Picker ) 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.
Row position - The row index position where the activity is to insert the row. The index can be used from iterating on the range rows using Read Range or For Each Row. This field is displayed if you select How to write – Insert. This field supports Int32 type input.
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ête/réponse lorsque vous travaillez avec des plages. La limite est de 4 Mo, par exemple, en moyenne 10 000 cellules avec 20 caractères chacune pour les requêtes de lecture, 4 000 cellules avec 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.