Ajouter la plage (Append Range)

UiPath.Excel.Activities.Business.AppendRangeX

Copies the data in a table, range, or sheet and pastes it after existing data in another specified table, range, or sheet. If the sheet does not exist, a new one is created with the name indicated in the SheetName field. The activity can be used with Excel files selected for parent Use Excel File activities or with the Project Notebook.

Vous pouvez copier des valeurs, des formules, des nombres et des formats de cellules, et transposer (faire pivoter) les données. Les données sont copiées vers la destination comme suit :

• En cas d'ajout à une table, la table existante est développée pour inclure les données copiées.
• En cas d'ajout à une plage, la plage existante est développée pour inclure les données copiées.
• En cas d'ajout à une feuille, les lignes copiées sont ajoutées en commençant par la première ligne vide sous les lignes contenant des données dans la feuille.

Le tableau suivant répertorie les combinaisons copier-ajouter prises en charge :

Copier depuis	Ajouter à
Feuille	Feuille
Plage	Feuille
Plage	Plage
Plage	Cellule
Cellule	Cellule
Cellule	Plage

Pour découvrir comment utiliser cette activité, consulter le Tutoriel : extraction de données de table d’une page Web et modification de ces données dans Excel.

Configurer l'activité

Dans le corps de l’activité

• Plage Excel à ajouter (Excel range to append) : cliquez sur le signe Plus, puis sélectionnez une plage, une table ou une feuille désignée que vous souhaitez copier. Vous pouvez également sélectionner Indiquer dans Excel (Indicate in Excel) pour ouvrir le fichier et sélectionner une plage directement à partir du fichier. Une autre méthode consiste à sélectionner Entrée personnalisée (Custom Input) pour saisir manuellement la plage, ou Ouvrir dans l’éditeur avancé (Open in Advanced Editor) et saisir une expression VB.
• Ajouter après la plage (Append after range) : cliquez sur le signe plus, puis sélectionnez une plage, une table ou une feuille désignée après laquelle vous souhaitez coller les données copiées. Vous pouvez également sélectionner Indiquer dans Excel (Indicate in Excel) pour ouvrir le fichier et sélectionner une plage directement à partir du fichier. Une autre méthode consiste à sélectionner Entrée personnalisée (Custom Input) pour saisir manuellement la plage, ou Ouvrir dans l’éditeur avancé (Open in Advanced Editor) pour saisir une expression VB.
• Quoi copier : sélectionnez de quelle façon copier les données. Les options suivantes sont disponibles : Tout (All) (option par défaut), Valeurs (Values), Formules (Formulas), Formats.
• Transposer : si cette option est sélectionnée, la plage copiée sera pivotée (les lignes seront changées en colonnes et les colonnes en lignes). Cette option est désactivée par défaut.
• Contient des en-têtes  si cette option est sélectionnée, la première ligne de la plage copiée sera considérée comme une ligne d'en-têtes et ne sera pas copiée. Cette option est désactivée par défaut.

Panneau propriétés

Commun

• NomComplet : le nom affiché pour l'activité dans le panneau Concepteur.

Entrée

• Voir les options dans le corps de l'activité.
• Début de la colonne : ajoutez les données en commençant par la première cellule vide de la colonne spécifiée.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Options

• AdesEn-têtes - Voir AdesEn-têtes dans le corps de l’activité.