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

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer

    • Erstellen Sie Benutzer-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 die Version Microsoft Visual Studio Pro, Community oder Enterprise, um diese Aufgabe auszuführen.

    Erforderliche Rolle: keine

    Warum und wann dieser Vorgang ausgeführt wird

    Das folgende Verfahren beschreibt, wie Sie ein Benutzer-Plugin mit C#.NET erstellen.

    Prozedur

    1. Öffnen Sie Microsoft Visual Studio, und klicken Sie auf Neues Projekt erstellen.
    2. Wählen Sie im Dialogfeld „Neues Projekt erstellen“ die Vorlage Klassenbibliothek (.NET Framework) aus.
      Abbildung : 1. Wählen Sie als Projekttyp Klassenbibliothek DOT NET Framework aus
      Klassenbibliothek DOT NET Framework.
    3. Klicken Sie auf Weiter.
    4. Füllen Sie im Dialogfeld „Neues Projekt konfigurieren“ die folgenden Felder aus:
      Feld Beschreibung und Aktion
      Projektname Name des Projekts.

      Beispiel: MyFirstPlugin.
      Standort Speicherort Ihres Projekts.

      Wählen Sie einen Speicherort für den Datenträger 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 Lösungsexplorer 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 System.AddIn -Komponente aus, um eine Anmerkung zu diesem Add-in hinzuzufügen.
      Abbildung : 2. Wählen Sie die System.AddIn-Komponente aus
      Wählen Sie die System.AddIn-Komponente aus.
    9. Klicken Sie auf OK.
    10. Fügen Sie in der Datei Class1.cs den Codeausschnitt System.AddIn.AddIn("MyFirstPlugin", Description = "Learning to create custom components", 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 „Hallo“ mit einem Namen zurück, gefolgt von einem Ausrufezeichen. Beispiel: Wenn die Eingabe Benutzerist, wird „Hallo Benutzer!“ zurückgegeben.
      • Summenmethode : Zwei Zahlen werden als Eingabe verwendet und die Summe dieser beiden Zahlen zurückgegeben. 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 Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, und wählen Sie Buildaus.
    14. Nachdem der Build erfolgreich war, führen Sie die folgenden Aktionen aus, um die DLL-Dateien zu kopieren und einzufügen:
      1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, und wählen Sie Ordner im Dateiexplorer öffnen aus.
      2. Navigieren zu bin > 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 zu Ihrem Automatisierungsprojekt hinzuzufügen:
      1. Klicken Sie im Projektexplorer mit der rechten Maustaste auf Benutzer-Plugins, und wählen Sie Benutzer-Plugin hinzufügenaus.
      2. Wählen Sie im Dialogfeld „Verfügbare Benutzer-Plugins“ das Plugin aus.
      3. Klicken Sie auf OK.
      Im Toolbox-Bereich wird das von Ihnen erstellte Benutzer-Plugin angezeigt.
    16. Führen Sie die folgenden Aktionen aus, um das Benutzer-Plugin zu verwenden:
      1. Navigieren Sie im Toolbox-Bereich zur Komponentenkategorie des Benutzer-Plugins, um eine Methode auszuwählen.
        Abbildung : 4. Zwei Methoden, die in der Komponentenkategorie des Benutzer-Plugins angezeigt werden
        Zwei Methoden, die in der Komponentenkategorie des Benutzer-Plugins angezeigt werden.
      2. Ziehen Sie eine Methode auf die Designoberfläche.
      3. Um den Eingabeparameterwert manuell anzugeben, doppelklicken Sie auf das Eingabeparameterfeld unter der Methode, und geben Sie den Wert ein.
      4. Um den Eingabeparameterwert von einer anderen Methode oder Komponente bereitzustellen, verbinden Sie den Dateneingangsport der Methode mit dem Datenausgangsport 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, von der aus 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 „Hallo Benutzer!“ angezeigt wird.
        Abbildung : 6. Ausgabe der Sum-Methode
        Ausgabe der Sum-Methode, die als „17“ angezeigt wird.