À propos du package d'activités Excel

Le package UiPath.Excel.Activities permet d’automatiser tous les aspects de Microsoft Excel, qui constitue l’un des outils les plus couramment utilisés dans ce secteur. Il contient des activités qui vous permettent de lire des informations à partir d'une cellule, de colonnes, de lignes ou de plages, d'écrire dans d'autres feuilles de calcul ou classeurs, d'exécuter des macros et même d'extraire des formules. De plus, vous pouvez trier les données, les coder en couleur ou ajouter des informations supplémentaires.

Attention : nous ne prenons plus en charge les activités classiques sur les projets hérités à partir de la version 3.0.0. Vous pouvez toujours utiliser les activités classiques dans les versions antérieures à 3.0.0. Pour plus d’informations, consultez la page Suppressions à venir .

Compatibilité

Remarque : le module UiPath.Excel.Activities est compatible avec les versions suivantes de Microsoft Excel :

• 2013
• 2016
• 2019
• 2021
• 2024
• Office 365
• Office 2024

Configuration

Vous pouvez activer Modern Experience, comme expliqué dans la section Paramètres du projet.

Activités Modern

Les activités regroupées sous Modern sont les activités les plus récentes initialement conçues pour le profil StudioX.

L'expérience et les activités de conception Excel modernes offrent les mêmes fonctionnalités que les activités métier StudioX par défaut dans Studio. Suivez la section du tutoriel pour en savoir plus sur l'utilisation des activités Excel dans Studio. Pour obtenir un guide complet, consultez la section Automatisation d’Excel dans le guide StudioX.

Expérience de conception Studio Modern

Une expérience de conception moderne est disponible dans le profil Studio à partir de Studio v2021.10 et UiPath.Excel.Activities v2.11.0. Dans Modern Experience, les activités modernes remplacent les activités classiques dans le profil Studio, et l'expérience de conception StudioX est importée dans Studio.

L’expérience de conception moderne est activée par défaut. Vous pouvez sélectionner l’expérience de conception pour chaque projet à partir des paramètres de projet des activités Excel. Lorsque l’expérience classique est activée pour un projet, les activités d’intégration d’applications classiques qui ne prennent pas en charge l’interaction avec Excel via le menu Plus sont disponibles dans le panneau Activités de Studio au lieu des activités modernes.

Tutoriel

Ajoutez l’activité d’étendue Utiliser un fichier Excel pour indiquer le fichier à automatiser et configurer ses activités enfants en sélectionnant les données Excel via le menu Plus de chaque propriété sans avoir à saisir des expressions manuellement :

1. Utilisez l'icône de dossier pour parcourir le contenu du fichier et sélectionner les données qui correspondent au type de chaque propriété. Par exemple, vous pouvez sélectionner des cellules, des plages, des tableaux, des feuilles ou des graphiques à partir de la feuille de calcul. Vous pouvez également indiquer la ligne ou la feuille actuelle dans une itération.
   
   
   
   
2. Si vous trouvez qu’il est plus facile de travailler dans Excel, dans le champ Dans la plage , sélectionnez le menu Plus pour plus d’options, puis sélectionnez Excel, puis Indiquer dans Excel pour sélectionner des données directement à partir du fichier.
   Remarque : cette fonctionnalité nécessite que vous installiez le complément Excel.
   
   
   
   
   
3. Utilisez l'option Entrée personnalisée ( Custom Input ) pour spécifier manuellement l'entrée en fonction des noms de table, de graphique ou de feuille, ou pour saisir des références à une cellule ou à une plage.
   
   

   

   
   

Si le fichier que vous souhaitez automatiser n’existe pas encore, vous pouvez toujours utiliser les options du menu Plus en définissant un fichier avec la même structure qu’un modèle dans l’activité Utiliser un fichier Excel.

Choisir le type d’activité le plus approprié

Pour décider quel type d'activité vous devez utiliser, consultez le tableau suivant.

Remarque : les activités modernes incluent un plus grand éventail d’options que les activités classiques.

Type d’activité	Compatibilité du projet	Installation d’Excel requise	Performances	Expérience utilisateur	Principalement utilisé lorsque
Utiliser un fichier Excel	Windows, multiplate-forme	Oui (Yes)	Élevée (mémoire optimisée)	Visual et guidé (menu Plus, Indiquer dans Excel)	Création de workflows modernes, travaillant entre plusieurs profils.
Étendue d'application Excel (Classique)	Windows, Windows-héritage	Oui (Yes)	Convient parfaitement aux tâches d’interface utilisateur volumineuses ou complexes.	Configuration manuelle requise	Automatisation des workflows de l’interface utilisateur Excel hérités. Les activités Excel classiques ne sont pas adaptées aux nouvelles automatisations. Il est recommandé d’utiliser plutôt des activités modernes.
Activités de classeur	Windows, multiplate-forme, Windows - Héritage	Non (No)	Convient parfaitement aux opérations légères sans affichage.	Basé sur des expressions simples	Excel n'est pas installé ou l'interface utilisateur n'est pas requise.

Activités de classeur

Les activités du classeur peuvent être exécutées même si Microsoft Excel n'est pas installé sur la machine et ne peuvent lire ou écrire des données que vers et à partir du fichier.

Vous disposez de deux méthodes pour indiquer le fichier à traiter dans vos activités :

• Indiquez le chemin d'accès au fichier dans chaque activité de classeur. Lorsque vous utilisez cette option, le fichier est chargé dans la mémoire au moment de l'exécution pour chaque activité qui le traite. Cette option convient mieux aux fichiers plus petits.
• Connectez votre projet Studio au fichier Excel à partir du Gestionnaire de données pour l'ajouter en tant que ressource, puis référencez la ressource dans chaque activité Classeur en la sélectionnant dans le menu Plus. En utilisant cette option, une fois le fichier chargé, celui-ci restera en mémoire jusqu'à ce que toutes les activités de l'étendue définie aient été exécutées, ce qui garantit de meilleures performances de runtime lorsque vous travaillez avec des fichiers plus volumineux et avec un plus grand nombre d'activités. Pour optimiser les performances, définissez l'étendue sur le conteneur le plus proche de l'endroit où les activités qui utilisent la ressource sont placées dans le workflow. Pour de plus amples informations, consultez la section Utiliser le Gestionnaire de données.

Activités d’intégration d’applications

Les activités d'intégration d'applications classiques nécessitent l'installation de l'application Excel sur la machine sur laquelle elles s'exécutent. Pour les feuilles de calcul volumineuses et complexes qui s'étendent sur un grand nombre de lignes et de colonnes, nous vous recommandons d'utiliser les activités Intégration d'applications ( App Integration ), car ces activités offrent les meilleures performances et la meilleure cohérence.

Toutes les activités d'intégration d'applications, à l'exception des activités CSV, doivent être incluses dans Étendue d'application Excel (Excel application scope) pour fonctionner. À partir de la version 2.10.4 du pack d’activités Excel, ces activités peuvent également être incluses dans l’activité Utiliser un fichier Excel .

Des activités dédiées vous permettent de travailler avec des fichiers .csv, alors que tous les autres fonctionnent avec .xlsx et .xls. Celles qui ne fonctionnent qu'avec l'activité Étendue d'application Excel (Excel application scope) peuvent également fonctionner avec les fichiers .xlsm.

Dépannage et limitations

Remarque : Le pack d'activités Excel ne prend pas en charge l'ancien format de fichier binaire Excel (.XLS) spécifique à Microsoft Excel 95.

• Lorsque vous utilisez des activités qui lisent, copient ou ajoutent des plages, si une cellule contient des informations de formatage, Excel considère que la cellule contient des données, même si elle apparaît vide.

• La version Microsoft Office 2016 version 1708 (Build 8431.2079) modifie le titre de la fenêtre des fichiers en cours d'édition et enregistrés "FileName.xlsx - Excel" en "FileName.xlsx - Saved". Après la fermeture du fichier, le nom de fichier revient à la normale.

  Des problèmes peuvent survenir si votre projet d'automatisation utilise des sélecteurs contenant le titre de la fenêtre. Par exemple, le sélecteur suivant ne fonctionne plus si votre version Excel est la précédente : <wnd app='excel.exe' cls='XLMAIN' title='FileName.xlsx - Excel' /> <wnd cls='EXCEL7' title='FileName.xlsx' />. Pour éviter ce problème, nous vous recommandons d'utiliser un sélecteur de variable dynamique.
• Certaines versions d’Excel, par exemple, Excel 2019, ouvrent toujours les documents SharePoint en mode lecture seule. Vous pouvez vérifier si un document distant prend en charge la modification en l'ouvrant manuellement dans Excel sur votre machine locale.