Excel Process Scope

UiPath.Excel.Activities.ExcelProcessScopeX

Ouvre ou réutilise des processus Excel, charge les paramètres du projet Excel et les applique au fichier Excel associé. Cette activité simplifie la gestion des processus Excel en vous permettant de configurer le lancement d’un processus Excel et la gestion des processus existants.

Certains des cas d’utilisation sont :

• Activer ou désactiver les macros.
• Gère les résolutions de conflits entre les fichiers Excel.
• Permet l'arrêt des processus Excel existants pour éviter les conflits.
• Gère les modes de processus (qu'il s'agisse d'ouvrir un nouveau processus, de réutiliser un processus existant ou d'inviter l'utilisateur).

Placez une activité Utiliser un fichier Excel (Use Excel File) dans une activité Étendue du processus Excel (Excel Process Scope) pour ouvrir des documents Excel avec certains paramètres déjà appliqués.

Propriétés

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité.

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

• Afficher les alertes : si cette option est sélectionnée, Excel peut afficher des alertes et des messages. La valeur par défaut est Identique au projet. Le menu déroulant contient les options suivantes : Identique au projet, Faux et Vrai.

• Action de processus existante : l’action à exécuter si d’autres processus Excel sont en cours d’exécution. La valeur par défaut est Identique au projet. Le menu déroulant contient les options suivantes :

  • Identique au projet : applique les mêmes paramètres que dans les paramètres du projet.
  • Aucun (None) - aucune action n'est entreprise par rapport aux processus existants sur la machine.
  • Forcer l’arrêt : ferme tous les processus Excel ouverts sans essayer d’enregistrer le fichier.

• Résolution des conflits de fichiers : l’action à exécuter si des conflits de fichiers Excel sont détectés entre les processus Excel. Par exemple, un fichier Excel est déjà ouvert dans un autre processus Excel. La valeur par défaut est Identique au projet. Le menu déroulant contient les options suivantes :

  • Identique au projet : applique les mêmes paramètres que dans les paramètres du projet.
  • Aucun : aucune action n’est entreprise.
  • Fermer sans enregistrer : ferme tous les fichiers Excel en conflit, sans enregistrer les modifications en attente.
  • Inviter l’utilisateur : envoie une invite à l’utilisateur pour lui signaler que les fichiers doivent être fermés.
  • Générer une exception : déclenche une exception qui peut soit être gérée dans une activité Essayer de capturer (Try Catch), soit entraîner l’arrêt du workflow.

• Méthode de lancement (Lancement method) : détermine si un processus Excel est lancé via les API COM ou en tant que processus complet. La valeur par défaut est Identique au projet (Same as project).Le menu déroulant contient trois options, comme suit :

  • Identique au projet : applique les mêmes paramètres que dans les paramètres du projet.
  • Automatisation : Excel est démarré par les API d’automatisation. Cette opération est plus rapide, mais tous les compléments ne se chargent pas. Cela peut donc poser des problèmes si le classeur repose sur un complément pour fonctionner correctement.
  • Application : Excel est démarré comme si un utilisateur l’ouvrait manuellement, de façon à garantir que tous les aspects d’Excel – par exemple les compléments – soient chargés.
• Délai d'expiration du lancement (Launch timeout) : délai d'attente du démarrage d'Excel, en secondes, s'il est lancé en tant que processus complet. La valeur par défaut est de 20 secondes.

• Paramètres de macro : spécifie le niveau de macro du fichier Excel actuel. La valeur par défaut est Identique au projet. Le menu déroulant contient les options suivantes :

  • Identique au projet : applique les mêmes paramètres que dans les paramètres du projet.
  • ActiverTout (EnableAll) - toutes les macros sont activées et peuvent être exécutées.
  • DésactiverTout (DisableAll) : toutes les macros sont désactivées dans le fichier Excel spécifié. Aucune macro ne peut être exécutée.
  • Utiliser les paramètres d’Excel : lit les paramètres actuels de la macro Excel.

• Mode de processus : détermine comment l’activité Étendue du processus Excel (Excel Process Scope) gère les processus Excel :

  • Identique au projet : applique les mêmes paramètres que dans les paramètres du projet. Il s’agit de la valeur par défaut.
  • Toujours créer un nouveau : crée systématiquement un nouveau processus Excel pour charger tous les fichiers associés.
  • Attended User : impose qu’il n’y ait qu’un seul processus Excel sur la machine. Si plusieurs processus Excel sont trouvés, une invite est envoyée à l’utilisateur.
  • Réutiliser si existant : recherche tous les processus Excel ouverts lorsque vous exécutez pour la première fois l’activité Utiliser un fichier Excel (Use Excel File), afin de vérifier si un fichier est déjà ouvert. Si un fichier ouvert est trouvé, cette option associe le processus à l’activité Étendue du processus Excel (Excel Process Scope). Dans le cas où un autre fichier ouvert est trouvé, le paramètre Résolution des conflits de fichiers sera appliqué.
  • Seulement s’il existe : recherche tous les processus Excel ouverts lorsque vous exécutez pour la première fois l’activité Utiliser un fichier Excel (Use Excel File), afin de vérifier si un fichier est déjà ouvert. Si un fichier ouvert est trouvé, cette option associe le processus à l’activité Étendue du processus Excel (Excel Process Scope). Si aucun fichier ouvert n’est trouvé, une exception est générée.

• Afficher la fenêtre Excel : si cette option est sélectionnée, les fenêtres Excel s’affichent pendant l’automatisation. La valeur par défaut est Identique au projet. Le menu déroulant contient les options suivantes :

  • Identique au projet : applique les mêmes paramètres que dans les paramètres du projet.
  • Faux (False) : le projet en arrière-plan ouvre des fichiers Excel en masquant leurs fenêtres.
  • Vrai (True) : le projet ouvre les fichiers Excel et leurs fenêtres sont visibles par l’utilisateur.

Important : pour éviter les erreurs, n'utilisez pas simultanément les propriétés suivantes avec les options spécifiées : Action sur les processus existants (Existing processors action) avec Force Kill et Mode de processus (Process mode) avec Seulement si existe (Only if exists).