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

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 3 minutes de lecture

    • Créez des modules d’extension utilisateur pour Microsoft Visual Studio 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, Communauté ou Entreprise 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 Cadre de travail DOT NET
      Bibliothèque de classes Cadre de travail DOT NET.
    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 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’assemblage 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 l’utilisateur ! ».
      • Méthode de somme : 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, il 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 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 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 à 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 saisie correctement.
      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 , 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 projet, cliquez avec le bouton droit sur User Plugins (Module d’extension utilisateur) et sélectionnez Add User Plugin (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. Procédez comme suit pour utiliser le module d’extension de l’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 apparaissent dans la catégorie de composant de module d’extension utilisateur
        Deux méthodes qui apparaissent dans la catégorie de composant de module d’extension utilisateur.
      2. Faites glisser une méthode vers l’aire de conception.
      3. Pour fournir la valeur du paramètre d’entrée manuellement, 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 composant.
      6. Dans l’aire Conception, cliquez avec le bouton droit 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 « Bonjour l’utilisateur ! ».
        Figure 6. Sortie de la méthode Sum
        Sortie de la méthode Sum qui apparaît comme « 17 ».