Exemple d'utilisation du package DLL

Créez un package DLL très simple qui génère un message. Créez un robot pour exécuter le package DLL.

Dans cette rubrique, nous vous expliquons comment créer un package DLL. Si vous ne disposez pas de Microsoft Visual Studio, téléchargez la version Community gratuite sur la page Microsoft Visual Studio Community IDE.

Procédure

Créez le package DLL.

  1. Dans Microsoft Visual Studio, créez une nouvelle bibliothèque de classes qui générera un fichier .dll en utilisant C#.
    1. Accédez à Fichier > Nouveau > Projet.
    2. Recherchez le fichier dll dans le champ Rechercher les modèles.
    3. Sélectionnez l'option de bibliothèque C#.
    4. Configurez votre projet comme suit :
      • Nom du projet : DemoDLL
      • Emplacement : [celui de votre choix]
      • Nom de la solution : DemoDLL
    5. Cliquez sur Créer.
    6. Copiez le code suivant et collez-le pour remplacer le contenu de class1.cs :
      using System;
      using System.Collections.Generic;
      using System.Linq;
      using System.Text;
      using System.Threading.Tasks;
      
      namespace DemoDLL
      {
          public class CallMe
          {
              public string ImHere()
              {
                  String Reply = "You are now inside the DemoDLL, ImHere function!";
                  return Reply;
              }
          }
      }
    7. Dans Explorateur de solutions, cliquez avec le bouton droit de la souris sur le fichier Classe1.cs et renommez-le comme suit : « CallMe.cs ».
    8. Accédez à Fichier > Enregistrer tout.
    9. Accédez à Générer > Générer la solution.
      La fenêtre de sortie confirme que le package DLL a bien été créé et affiche le chemin d'accès à votre nouveau package DemoDLL.dll dans la fenêtre Sortie. Notez l'emplacement du package, car vous en aurez besoin plus tard pour accéder au robot.

Créez un robot pour exécuter le package DLL.

  1. Créez un robot.
    1. Dans le panneau de gauche, cliquez sur Automatisation.
      Une liste des robots et des formulaires disponibles s'affiche.
    2. Cliquez sur Créer un > robot.
    3. Nommez le robot : MyDLLbot
    4. Saisissez l'emplacement du dossier : Bots\TaskBotExample
    5. Cliquez sur Créer et modifier.
  2. Créez une variable : sReturnedString de type chaîne.
  3. Utilisez une action DLL > Ouvrir pour charger votre package DLL.
    1. Dans le volet Actions, double-cliquez sur l'action DLL > Ouvrir ou faites-la glisser.
    2. Dans le champ DLL:Ouvrir Chemin de fichier, sélectionnez le type de fichier Fichier de bureau et cliquez sur Parcourir pour rechercher votre package DLL. Cliquez sur Ouvrir.
    3. Cliquez sur Enregistrer.
  4. Utilisez une action DLL > Exécuter pour exécuter votre package DLL.
    1. Double-cliquez sur l'action DLL > Exécuter la fonction ou faites-la glisser vers la dernière ligne du robot.
    2. Cliquez sur Obtenir les informations DLL.
    3. Sélectionnez le type Fichier de bureau, puis cliquez sur Parcourir. Localisez votre package DLL et cliquez sur Ouvrir.
    4. Cliquez sur Suivant.
    5. Développez l'espace de noms DemoDLL et sélectionnez la fonction CallMe. Sélectionnez la méthode ImHere et cliquez sur Appliquer.
    6. Dans le champ Attribuer la valeur à une variable, sélectionnez sReturnedString.
  5. Utilisez une action Zone de message pour signaler ce qui a été renvoyé par le robot DLL :
    1. Double-cliquez sur l'action Zone de message ou faites-la glisser vers la dernière ligne du robot.
    2. Dans le champ Entrer le message à afficher, saisissez : From the DLL: "$sReturnedString$".
  6. Cliquez sur Enregistrer.
  7. Utilisez l'action DLL > Fermer pour mettre fin à la session DLL.
    1. Double-cliquez sur l'action DLL > Fermer ou faites-la glisser vers la dernière ligne du robot.
  8. Cliquez sur Enregistrer.
  9. Cliquez sur l'onglet Liste pour afficher votre code en mode texte uniquement.
    Votre code doit être similaire au suivant :
    Start
    DLL:Open "C:\myFolder\source\repos\DemoDLL\DemoDLL\bin\Debug\DemoDLL.dll for session "Default"
    DLL:Run function "ImHere" and store output in variable $sReturnedString$ and session "Default"
    MessageBox "From the DLL: "$sReturnedString$".
    DLL:Close session "Default"
    End
  10. Exécutez votre robot.
    Le package DLL renvoie un message au robot : From the DLL: "You are now inside the DemoDLL, ImHere function!".