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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 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.
      Adresse 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 Explorateur de solutions, cliquez avec le bouton droit sur Références , puis 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 à ce complément.
      Figure 2. Sélectionner l’assembly System.AddIn
      Sélectionnez l’assembly 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 User, elle renvoie « Hello User ! ».
      • Méthode Sum : Deux nombres sont pris comme entrée et renvoie la somme de ces deux nombres. Par exemple, si les entrées sont 5 et 12, elle renvoie « 17 ».
      Figure 3. Méthodes statiques publiques
      Méthodes statiques publiques.
    12. Cliquez sur Enregistrer.
    13. Dans le volet Explorateur de solutions, cliquez avec le bouton droit sur votre projet, puis sélectionnez Générer.
    14. Une fois la génération terminée, effectuez les actions suivantes pour copier et coller les fichiers .dll :
      1. Dans le volet Explorateur de solutions, cliquez avec le bouton droit de la souris sur votre projet et sélectionnez Ouvrir le dossier dans l’Explorateur de fichiers.
      2. Accédez à la Bin > Debug et copiez les fichiers .dll.
      3. Accédez à votre Studio de conception de bureau de RPA dossier de 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 saisissez un nom pour le dossier.
        Par exemple, Mon premier module d’extension.
      5. Collez les fichiers .dll dans ce dossier.
    15. Dans , Studio de conception de bureau de RPAprocédez comme suit pour ajouter le module d’extension à votre projet d’automatisation :
      1. Dans le volet Explorateur de projets, cliquez avec le bouton droit de la souris 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 le volet 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 du composant du module d’extension utilisateur pour sélectionner une méthode.
        Figure 4. Deux méthodes qui apparaissent dans la catégorie du composant du module d’extension de l’utilisateur
        Deux méthodes qui apparaissent dans la catégorie du composant du module d’extension utilisateur.
      2. Faites glisser une méthode vers la surface de conception.
      3. Pour fournir manuellement la valeur du paramètre d’entrée, double-cliquez sur le champ du paramètre d’entrée sous la méthode, puis saisissez 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 composant.
      6. Dans l’aire de conception, cliquez avec le bouton droit sur la barre de titre du composant à partir duquel vous souhaitez lancer 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 Somme
        Sortie de la méthode Somme qui apparaît sous la forme « 17 ».