Créer des modules d’extension utilisateur pour Studio de conception de bureau de RPA

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • Créez des modules d’extension Microsoft Visual Studio utilisateur pour permettre aux développeurs RPA d’utiliser des composants ou des bibliothèques .NET complexes de Studio de conception de bureau de RPA manière transparente.

    Avant de commencer

    Utilisez la Microsoft Visual Studio version Pro, Community ou Enterprise pour effectuer cette tâche.

    Rôle requis : aucun

    Pourquoi et quand exécuter cette tâche

    La procédure suivante décrit comment créer un module d’extension utilisateur à l’aide de C#.NET.

    Procédure

    1. Ouvrez Microsoft Visual Studio et cliquez sur Créer un nouveau projet.
    2. Dans la boîte de dialogue Créer un projet, sélectionnez le modèle Bibliothèque de classes (.NET Framework).
      Figure 1. Sélectionner un type de projet de la bibliothèque de classes DOT NET Framework
      Bibliothèque de classes DOT NET Framework.
    3. Cliquez sur Suivant.
    4. Dans la boîte de dialogue Configurer votre nouveau projet, renseignez les champs suivants :
      Champ Description et action
      Nom du projet Nom de votre projet.

      Par exemple, MyFirstPlugin.
      Emplacement Emplacement de votre projet.

      Sélectionnez un emplacement de disque.
      Nom de la solution Nom de la solution de votre projet.
      Cadre de travail Sélectionnez une version de cadre de travail.

      Sélectionnez la version .NET Framework 4.7 .
    5. Cliquez sur Créer.
      Le fichier Class1.cs s’ouvre.
    6. Dans le volet de l’Explorateur de solutions, cliquez avec le bouton droit sur Références et sélectionnez Ajouter une référence.
    7. Dans la boîte de dialogue Gestionnaire de références, accédez à Assemblées > Cadre de travail.
    8. Sélectionnez l’assembly System.AddIn pour ajouter une annotation de ce complément.
      Figure 2. Sélectionner l’assemblage System.AddIn
      Sélectionnez l’assemblage System.AddIn.
    9. Cliquez sur OK.
    10. Dans le fichier Class1.cs, ajoutez l’extrait de code System.AddIn.AddIn(« MyFirstPlugin », Description = « Learning to create custom components », Version = « 1.0 ») au-dessus de la classe.
    11. Dans le fichier Class1.cs, créez une ou plusieurs méthodes statiques publiques pour votre code.
      Dans cet exemple, deux méthodes sont ajoutées au code :
      • Méthode SayHello : le nom est pris comme entrée et renvoie « Hello » avec un nom et suivi d’un point d’exclamation. Par exemple, si l’entrée est Utilisateur, elle renvoie « Bonjour Utilisateur ! ».
      • Méthode Sum : deux nombres sont pris comme entrée et renvoient la somme de ces deux nombres. Par exemple, si les entrées sont 5 et 12, renvoie « 17 ».
      Figure 3. Méthodes statiques publiques
      Méthodes statiques publiques.
    12. Cliquez sur Enregistrer.
    13. Dans le volet de l’Explorateur de solutions, cliquez avec le bouton droit sur votre projet et sélectionnez Générer.
    14. Une fois la génération réussie, effectuez les actions suivantes pour copier et coller les fichiers .dll :
      1. Dans le volet de l’Explorateur de solutions, cliquez avec le bouton droit sur votre projet et sélectionnez Ouvrir un dossier dans l’Explorateur de fichiers.
      2. Accédez à la poubelle > Déboguer et copiez les fichiers .dll.
      3. Accédez au dossier de votre Studio de conception de bureau de RPA projet d’automatisation et créez un nouveau dossier en tant que UserPlugins.
        Important :
        Assurez-vous que l’orthographe de ce dossier est correcte.
      4. Dans le dossier UserPlugins, créez un dossier et donnez-lui un nom.
        Par exemple, Mon premier module d’extension.
      5. Collez les fichiers .dll dans ce dossier.
    15. Dans , procédez Studio de conception de bureau de RPAcomme suit pour ajouter le module d’extension à votre projet d’automatisation :
      1. Dans le volet de l’Explorateur de projets, cliquez avec le bouton droit sur Modules d’extension utilisateur et sélectionnez Ajouter un module d’extension utilisateur.
      2. Dans la boîte de dialogue Modules d’extension utilisateur disponibles, sélectionnez le module d’extension.
      3. Cliquez sur OK.
      Dans la fenêtre Toolbox (Boîte à outils), le module d’extension utilisateur que vous avez créé s’affiche.
    16. Effectuez les actions suivantes pour utiliser le module d’extension utilisateur :
      1. Dans le volet Boîte à outils, accédez à la catégorie de composant du module d’extension utilisateur pour sélectionner une méthode.
        Figure 4. Deux méthodes qui s’affichent dans la catégorie du composant du module d’extension utilisateur
        Deux méthodes qui apparaissent dans la catégorie des composants du module d’extension utilisateur.
      2. Faites glisser une méthode vers l’aire de conception.
      3. Pour fournir manuellement la valeur du paramètre d’entrée, double-cliquez sur le champ de paramètre d’entrée sous la méthode et entrez la valeur.
      4. Pour fournir la valeur du paramètre d’entrée à partir d’une autre méthode ou composant, connectez le port d’entrée de données de la méthode au port de sortie de données d’une autre méthode ou composant.
      5. Connectez les ports de contrôle de la méthode aux ports correspondants d’une autre méthode ou d’un autre composant.
      6. Dans l’aire de conception, cliquez avec le bouton droit de la souris sur la barre de titre du composant à partir duquel vous souhaitez démarrer l’exécution et sélectionnez Exécuter à partir d’ici.
        Figure 5. Sortie de la méthode SayHello
        Sortie de la méthode SayHello qui s’affiche sous la forme « Hello User ! ».
        Figure 6. Sortie de la méthode Sum
        Sortie de la méthode Somme qui apparaît sous la forme « 17 ».