Excel Process Scope

UiPath.Excel.Activities.ExcelProcessScopeX

Ouvre ou réutilise les processus Excel, charge les paramètres du projet Excel et les applique au fichier Excel associé. Cette activité facilite la gestion des processus Excel en vous permettant de configurer la méthode de lancement d'un processus Excel et la façon dont les processus Excel existants sont gérés.

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 fichier Excel (Use Excel File) dans une activité Single 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 (Display alerts) : si cette option est sélectionnée, Excel peut afficher des alertes et des messages. La valeur par défaut est Identique au projet (Same as project). Le menu déroulant contient trois options, comme suit : Identique au projet (Same as project), Faux (False), Vrai (True).

• Action de processus existant (Existing processors action) : l'action à exécuter si d'autres processus Excel sont en cours d'exécution. La valeur par défaut est Identique au projet (Same as project). Le menu déroulant contient trois options, comme suit :

  • Identique au projet (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.
  • Force Kill : ferme tous les processus Excel ouverts sans essayer d'enregistrer le fichier.

• Résolution des conflits de fichiers (File conflict resolution) : 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 cinq options, comme suit :

  • Identique au projet (Identique au projet) : applique les mêmes paramètres que dans les paramètres du projet.
  • Aucun (None) : aucune action n'est entreprise.
  • Fermer sans enregistrer (Close without saving) : ferme tous les fichiers Excel en conflit sans enregistrer les modifications en attente.
  • Inviter utilisateur (Prompt user) : affiche une invite indiquant à l'utilisateur que les fichiers doivent être fermés.
  • Générer une exception (Throw exception) : déclenche une exception qui peut être gérée dans une activité Essayer de capturer ( Try Catch ) ou 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 (Identique au projet) : applique les mêmes paramètres que dans les paramètres du projet.
  • Automatisation (Automation) : 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, garantissant que tous les aspects d'Excel se chargent, tels que les compléments.
• 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 (Macro settings) : spécifie le niveau de macro du fichier Excel actuel. La valeur par défaut est Identique au projet (Same as project). Le menu déroulant contient quatre options, comme suit :

  • Identique au projet (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.
  • DisableAll (DisableAll) : toutes les macros sont désactivées dans le fichier Excel spécifié. Aucune macro ne peut être exécutée.
  • Lire depuis paramètres Excel (Read from excel settings) : lit les paramètres actuels de la macro Excel.

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

  • Identique au projet (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 nouveau (Always create new) : un nouveau processus Excel est toujours créé pour charger tous les fichiers associés.
  • Utilisateur Attended (Attended User) : impose qu'il n'y ait qu'un seul processus Excel sur la machine. Si plusieurs processus Excel sont trouvés, l'utilisateur en est invité.
  • Réutiliser si existe (Reuse if exists) : recherche tous les processus Excel ouverts lorsque la première activité Utiliser un fichier Excel (Use Excel File) est exécutée pour vérifier si un fichier est déjà ouvert. Si un fichier ouvert est trouvé, ce processus est associé à Excel Process Scope. Dans le cas où un autre fichier ouvert est trouvé, le paramètre Résolution des conflits de fichiers est appliqué.
  • Seulement si existe (Only if exists) : recherche tous les processus Excel ouverts lorsque la première activité Utiliser un fichier Excel (Use Excel File) est exécutée pour vérifier si un fichier est déjà ouvert. Si un fichier ouvert est trouvé, ce processus est associé à Excel Process Scope. Si aucun fichier ouvert n'est trouvé, une exception est générée.

• Afficher la fenêtre Excel (Show Excel window) : 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 (Same as project). Le menu déroulant contient trois options, comme suit :

  • Identique au projet (Identique au projet) : applique les mêmes paramètres que dans les paramètres du projet.
  • Faux (False) : les fichiers Excel sont ouverts par le projet en arrière-plan, avec leurs fenêtres masquées.
  • Vrai (True) : les fichiers Excel sont ouverts par le projet et leurs fenêtres sont visibles par l'utilisateur.