Ajouter la plage (Append Range)

UiPath.Excel.Activities.Business.AppendRangeX

Copie les données dans une table, une plage ou une feuille et les colle après les données existantes dans une autre table, plage ou feuille spécifiée. Si la feuille n'existe pas, une nouvelle est créée avec le nom indiqué dans le champ NomFeuille. L'activité peut être utilisée avec des fichiers Excel déjà sélectionnés pour des activités parentes Use Excel File , ou bien avec le bloc-notes de projet.

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