Erstellen Sie Anwender-Plugins für RPA Desktop Design Studio

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 3 Minuten Lesedauer

    • Erstellen Sie Anwender-Plugins mit Microsoft Visual Studio, damit RPA-Entwickler komplexe .NET-Komponenten oder -Bibliotheken in RPA Desktop Design Studio nahtlos verwenden können.

    Vorbereitungen

    Verwenden Sie entweder Microsoft Visual Studio Pro, Community oder Enterprise, um diese Aufgabe auszuführen.

    Erforderliche Rolle: keine

    Warum und wann dieser Vorgang ausgeführt wird

    Im folgenden Verfahren wird beschrieben, wie Sie mit C#.NET ein Anwender-Plugin erstellen.

    Prozedur

    1. Öffnen Sie Microsoft Visual Studio, und klicken Sie auf Ein neues Projekt erstellen.
    2. Wählen Sie im Dialogfeld „Neues Projekt erstellen“ die Vorlage Klassenbibliothek (.NET Framework) aus.
      Abbildung : 1. Wählen Sie den Projekttyp „Klassenbibliothek – DOT NET Framework“ aus
      DOT NET Framework der Klassenbibliothek.
    3. Klicken Sie auf Next (Weiter).
    4. Füllen Sie im Dialogfeld „Configure your new project (Neues Projekt konfigurieren)“ die folgenden Felder aus:
      Feld Beschreibung und Aktion
      Projektname Name Ihres Projekts

      Beispiel: MyFirstPlugin.
      Standort Standort Ihres Projekts.

      Wählen Sie einen Datenträgerspeicherort aus.
      Lösungsname Name der Lösung Ihres Projekts.
      Framework Wählen Sie eine Framework-Version aus.

      Wählen Sie die Version .NET Framework 4.7 aus.
    5. Klicken Sie auf Erstellen.
      Die Datei Class1.cs wird geöffnet.
    6. Klicken Sie im Fenster „Lösungs-Explorer“ mit der rechten Maustaste auf Referenzen, und wählen Sie Referenz hinzufügenaus.
    7. Navigieren Sie im Dialogfeld „Referenzmanager“ zu Komponentengruppen > Framework.
    8. Wählen Sie die Komponentengruppe „System.AddIn“ aus, um eine Anmerkung zu diesem Add-in hinzuzufügen.
      Abbildung : 2. Wählen Sie die Komponentengruppe System.AddIn aus
      Wählen Sie die Komponentengruppe System.AddIn aus.
    9. Klicken Sie auf OK.
    10. Fügen Sie in der Datei Class1.cs das Codefragment System.AddIn.AddIn("MyFirstPlugin",Description = "Lernen, um benutzerdefinierte Komponenten zu erstellen", Version = "1.0") über der Klasse hinzu.
    11. Erstellen Sie in der Datei Class1.cs eine oder mehrere öffentliche statische Methoden für Ihren Code.
      In diesem Beispiel werden dem Code zwei Methoden hinzugefügt:
      • Methode „SayHello “: Der Name wird als Eingabe verwendet und gibt „Hello“ mit einem Namen und gefolgt von einem Ausrufezeichen zurück. Wenn die Eingabe beispielsweise Userist, wird „Hello User!“ zurückgegeben.
      • Summenmethode : Zwei Zahlen werden als Eingabe verwendet und gibt die Summe dieser beiden Zahlen zurück. Wenn die Eingaben beispielsweise 5 und 12sind, wird „17“ zurückgegeben.
      Abbildung : 3. Öffentliche statische Methoden
      Öffentliche statische Methoden.
    12. Klicken Sie auf Speichern.
    13. Klicken Sie im Fenster „Lösungs-Explorer“ mit der rechten Maustaste auf Ihr Projekt, und wählen Sie Buildaus.
    14. Führen Sie nach einem erfolgreichen Build die folgenden Aktionen aus, um die DLL-Dateien zu kopieren und einzufügen:
      1. Klicken Sie im Bereich Lösungs-Explorer mit der rechten Maustaste auf Ihr Projekt, und wählen Sie Ordner in Datei-Explorer öffnen aus.
      2. Navigieren zu Ablage > Debuggen und kopieren Sie die DLL-Dateien.
      3. Wechseln Sie zu Ihrem Automatisierungsprojektordner RPA Desktop Design Studio, und erstellen Sie einen neuen Ordner als UserPlugins.
        Wichtig:
        Stellen Sie sicher, dass die Schreibweise dieses Ordners korrekt eingegeben wurde.
      4. Erstellen Sie im Ordner „UserPlugins“ einen Ordner, und geben Sie einen Namen für den Ordner ein.
        Beispiel: MyFirstPlugin.
      5. Fügen Sie die DLL-Dateien in diesen Ordner ein.
    15. Führen Sie in RPA Desktop Design Studiodie folgenden Aktionen aus, um das Plugin Ihrem Automatisierungsprojekt hinzuzufügen:
      1. Klicken Sie im Projekt-Explorer mit der rechten Maustaste auf Benutzer-Plugins, und wählen Sie Benutzer-Plugin hinzufügenaus.
      2. Wählen Sie im Dialogfeld „Verfügbare Anwender-Plugins“ das Plugin aus.
      3. Klicken Sie auf OK.
      Im Bereich Toolbox wird das von Ihnen erstellte Anwender-Plugin angezeigt.
    16. Führen Sie die folgenden Aktionen aus, um das Benutzer-Plugin zu verwenden:
      1. Navigieren Sie im Bereich Toolbox zur Kategorie der Anwender-Plugin-Komponenten, um eine Methode auszuwählen.
        Abbildung : 4. Zwei Methoden, die in der Kategorie der Anwender-Plugin-Komponenten angezeigt werden
        Zwei Methoden, die in der Kategorie der Anwender-Plugin-Komponenten angezeigt werden.
      2. Ziehen Sie eine Methode auf die Designoberfläche.
      3. Um den Wert des Eingabeparameters manuell anzugeben, doppelklicken Sie auf das Feld „Eingabeparameter“ unter der Methode, und geben Sie den Wert ein.
      4. Um den Eingabeparameterwert aus einer anderen Methode oder Komponente bereitzustellen, verbinden Sie den Dateneingang der Methode mit dem Datenausgang einer anderen Methode oder Komponente.
      5. Verbinden Sie die Steuerungsports der Methode mit den entsprechenden Ports einer anderen Methode oder Komponente.
      6. Klicken Sie in der Designoberfläche mit der rechten Maustaste auf die Titelleiste der Komponente, ab der Sie die Ausführung starten möchten, und wählen Sie Von hierausführen aus.
        Abbildung : 5. Ausgabe der „SayHello“-Methode
        Ausgabe der „SayHello“-Methode, die als „Hello User!“ angezeigt wird.
        Abbildung : 6. Ausgabe der Summenmethode
        Ausgabe der Sum-Methode, die als „17“ angezeigt wird.