Run Spreadsheet Macro

UiPath.Excel.Activities.Business.ExecuteMacroX

Exécute une macro spécifiée dans un classeur compatible avec les macros. Vous pouvez transmettre des arguments de macro et enregistrer la sortie de l'exécution de la macro. L’activité peut être utilisée avec un fichier Excel sélectionné pour une activité parente Utiliser fichier Excel (Use Excel File) ou avec le bloc-notes du projet.

Configurer l'activité

Dans le corps de l’activité

• Classeur source : Cliquez sur l'icône Plus à droite du champ, puis sélectionnez un classeur possédant l'extension .xslm dans lequel exécuter la macro. Vous pouvez également sélectionner Ouvrir dans l'éditeur avancé (Open in Advanced Editor) et saisir une expression VB.

• Nom de la macro : cliquez sur l'icône Plus à droite du champ, puis sélectionnez Texte pour saisir le nom de la macro dans le générateur de texte. Alternativement, vous pouvez utiliser l'une des autres options du menu pour indiquer le nom de la macro :

  • Données du Bloc-notes du projet, d'un fichier Excel parent ou d'un compte Outlook. Par exemple, sélectionnez la cellule d'un fichier Excel contenant le nom de la macro.
  • Utiliser la valeur enregistrée (Use Saved Value) : Sélectionnez une valeur sous la forme d'un index que vous avez précédemment enregistré pour une utilisation ultérieure dans le projet.
  • Demander quand exécuté : permet de demander un nom lorsque le projet est exécuté.
  • Ouvrir dans l'éditeur avancé : utilisé pour saisir une expression VB.

• Sortie vers : si l'exécution de la macro renvoie une valeur, cliquez sur l'icône Plus à droite du champ, puis utilisez l'une des options du menu pour indiquer où enregistrer la valeur :

  • Enregistre dans le Bloc-notes du projet ou dans un fichier Excel parent. Par exemple, vous pouvez enregistrer dans la cellule d'un fichier Excel.
  • Enregistrer pour une utilisation ultérieure : enregistrez la sortie afin de l'utiliser ultérieurement dans votre projet en tant qu'entrée pour une autre activité.
  • Ouvrir dans l'éditeur avancé : utilisé pour saisir une expression VB.
• Ajouter un argument de macro (Add Macro Argument ) : cliquez sur ce bouton pour ajouter un argument à utiliser lors de l'exécution de la macro. Ajoutez autant d'arguments que requis par la macro.

Options des arguments de macro

• Valeur de l'argument : cliquez sur l'icône Plus à droite du champ, puis utilisez l'une des autres options du menu pour ajouter une valeur d'argument :

  • Données du Bloc-notes du projet, d'un fichier Excel parent ou d'un compte Outlook. Par exemple, sélectionnez la cellule d'un fichier Excel ou le champ d'un e-mail Outlook sélectionné contenant la valeur.
  • Utiliser la valeur enregistrée : sélectionnez une valeur que vous avez précédemment enregistrée pour une utilisation ultérieure dans le projet.
  • Texte (Text) - Saisissez du texte dans le générateur de texte.
  • Nombre : Saisissez une valeur numérique.
  • Demander quand exécuté : permet de demander un argument lorsque le projet est exécuté.
  • Ouvrir dans l'éditeur avancé : utilisé pour saisir une expression VB.

Panneau propriétés

Commun

• NomComplet : le nom affiché pour l'activité dans le panneau Concepteur.

Entrée

• Nom de la macro : Voir Nom de la macro dans le corps de l’activité.
• Nom du classeur : Voir Classeur source dans le corps 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).

Sortie

• Résultat de la macro : Voir Sortie vers dans le corps de l’activité.