É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, laisser UiPath gérer la durée de vie du processus Excel crée la possibilité que cette condition de concurrence critique provoque une erreur. Pour éviter cela, nous vous recommandons de créer une activité Excel Application Scope parente, d'enregistrer le classeur de sortie en tant que variable, de placer toutes les autres activités Excel Application Scope à l'intérieur de ce parent et de réutiliser la variable WorkbookApplication comme entrée de la propriété ExistingWorkbook dans toutes les activités d'étendue enfants . Cela garantit qu’Excel reste en cours d’exécution tant que l’automatisation utilise Excel.

• Paramètres de macro (Macro settings) : spécifie le niveau de macro du fichier Excel actuel. Par défaut, l'option Activer tout (EnableAll) est sélectionnée. Le menu déroulant contient trois options, comme suit :

  • 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 : ouvre le classeur spécifié en lecture seule. La sélection de cette case permet d'effectuer les opérations d'extraction des données dans un fichier Excel verrouillé pour la modification ou qui possède un mot de passe de modification. Par défaut, cette case n'est pas cochée.
• Enregistrement Save changes - Enregistre automatiquement le classeur à chaque modification provoquée par une activité. Si cette option est désactivée, les modifications ne seront pas enregistrées lorsque l'exécution de l'activité Champ d'application Excel (Excel Application Scope) se terminera. Cette case est cochée par défaut.
• Démarrer en tant que processus : si la valeur est true, Excel s'ouvrira en tant que nouveau processus.
• Visible (Visible) - Lorsque cette option est sélectionnée, le fichier Excel est ouvert au premier plan lors de l'exécution d'actions. Quand elle n'est pas sélectionnée, toutes les opérations sont effectuées en arrière-plan.

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é Excel Application Scope parmi d'autres activités. Vous pouvez télécharger le workflow ici.