Étendue d'application Excel (Excel Application Scope)

UiPath.Excel.Activities.ExcelApplicationScope

Ouvre un classeur Excel et fournit un champ pour les activités Excel. Lorsque l'exécution de cette activité se termine, le classeur spécifié et l'application Excel sont fermés. Si une variable WorkbookApplication est fournie dans le champ Sortie (Output) > Propriété du classeur (Workbook property), la feuille de calcul n'est pas fermée une fois l'activité terminée. Si le fichier spécifié n'existe pas, un nouveau fichier Excel est créé. Cette activité ne peut être utilisée que si l'application Microsoft Excel est installée sur votre ordinateur.

Propriétés

Remarque :

• Les chaînes doivent être placées entre guillemets.
• Lors de l'utilisation d'Office 365, l'activité ouvre les fichiers Excel dans une nouvelle instance si Excel Application Scope est exécuté avant d'ouvrir manuellement les fichiers Excel.

Commun

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

Fichier

• Modifier le mot de passe (EditPassword) - Mot de passe requis pour l'édition de classeurs Excel protégés par un mot de passe, si nécessaire. Seules les variables String et les chaînes sont prises en charge.
• Mot de passe (Password) - Mot de passe requis pour ouvrir les classeurs Excel protégés par mot de passe, si nécessaire. Seules les variables String et les chaînes sont prises en charge.
• Chemin classeur (WorkbookPath) - Chemin complet de la feuille de calcul Excel que vous souhaitez utiliser. Si le fichier Excel à utiliser se trouve dans le dossier du projet, son chemin d'accès relatif peut être utilisé. Seules les variables String et les chaînes sont prises en charge.

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

• Créer s'il n'existe pas : lorsque cette option est sélectionnée, si le classeur est introuvable dans le chemin spécifié, un nouveau classeur Excel sera créé avec le nom spécifié dans le champ de propriété Chemin du classeur. Lorsqu'elle est désactivée, si le classeur est introuvable dans le chemin spécifié, une exception sera générée et l'utilisateur en sera informé. Cette case est cochée par défaut.
• PériodeCacheInstance : la durée pendant laquelle le processus Excel restera actif après l'exécution de toutes les activités enfant. La valeur par défaut est 3 000 ms. Lorsque l'activité est utilisée dans une boucle (par exemple, dans une activité For Each) ou bien lorsque plusieurs activités Excel Application Scope sont utilisées consécutivement, cela permet d'éviter les erreurs pouvant être causées par l'arrêt du processus Excel lors de l'ouverture du fichier suivant. Pour fermer Excel le plus rapidement possible, définissez la valeur sur 0.

Remarque :

Lorsque vous travaillez avec plusieurs fichiers, le fait de laisser UiPath pour gérer la durée de vie du processus Excel crée la possibilité de cette condition de course pour provoquer une erreur. Pour éviter cela, nous vous recommandons de créer une activité parente Excel Application Scope, d'enregistrer la sortie Workbook en tant que variable, de placer toutes les autres activités Excel Application Scope dans ce parent et de réutiliser la variable WorkbookApplication comme entrée de la propriété ExistingWorkbook dans toutes les activités de l'étendue enfant. . Cela garantit qu'Excel reste en cours d'exécution tant que l'automatisation utilise Excel.

• MacroSetting - Specifies the macro level for the current Excel file. By default, EnableAll is selected. The drop-down contains three options, as follows:
  • 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.
  • ReadFromExcelSettings : lit les paramètres actuels de la macro Excel.
• Read-only - Opens the specified workbook in Read-Only mode. Selecting this check box enables you to perform data extraction operations in an Excel file which is locked for editing or has an edit password. By default, this check box is not selected.
• Save changes - Automatically saves the workbook on each change caused by an activity. If disabled, the changes will not be saved when the execution of the Excel Application Scope ends. By default, this checkbox is selected.
• Démarrer en tant que processus (Start as Process) : si la valeur est définie sur Vraie (True), Excel s’ouvrira en tant que nouveau processus.
• Visible - When selected, the Excel file is opened in the foreground while performing actions on it. When it is cleared, all operations are done in the background.

Sortie

• Classeur (Workbook) - Toutes les informations de la feuille de calcul Excel stockées dans une variable WorkbookApplication. Cette variable peut être utilisée dans une autre activité Champ d'application Excel. Seules les variables WorkbookApplication sont prises en charge.

Utiliser le classeur existant

• Classeur existant (ExistingWorkbook) - Utilisez les données d'un fichier Excel précédemment stocké dans une variable WorkbookApplication. Seules les variables WorkbookApplication sont prises en charge.

Exemple d'utilisation de l'activité Excel Application Scope

Pour illustrer comment utiliser cette activité, nous avons construit un projet d'automatisation qui comprend une activité Étendue d'application Excel entre d'autres activités. Vous pouvez télécharger le workflow ici.