Verwenden des Aktivitätserstellers

Aktivitäten sind die Bausteine der Prozessautomatisierung. Jede enthält eine atomare Aktion, die zusammen mit anderen Aktivitäten einen Workflow bildet.

UiPath Studio enthält eine Reihe vorgefertigter Aktivitäten , die Sie über den Paketmanager installieren können.

Darüber hinaus können Sie mit der Activity Creator-Erweiterung für Visual Studio von UiPath eigene benutzerdefinierte Aktivitäten speziell für Ihre Anforderungen erstellen . Die folgenden Schritte geben Ihnen die Grundlage, um benutzerdefinierte Aktivitäten in 5 Minuten zu erstellen. In diesem Abschnitt erstellen wir ein Aktivitätspaket und füllen es im nächsten Abschnitt mit funktionalen Aktivitäten.

Was Sie benötigen

• Visual Studio Community/Profi/Enterprise 2022 mit der *.NET-Desktop-Entwicklung
• Workload installiert
• UiPath's Marketplace Feed (https://gallery.uipath.com/api/v3/index.json) als Paketquelle in Visual Studio. Anweisungen zum Hinzufügen von Paketquellen finden Sie hier .
• .NET 6
• UiPath Studio

Wichtig:

Beachten Sie, dass Version 4.0 des Activity Creator nur mit Visual Studio 2022 funktioniert. Ebenso zielten die erzeugten Aktivitäten auf .NET 6 Windows-Projekte ab. Um Aktivitäten zu erstellen, die mit älteren Versionen von Visual Studio oder .NET kompatibel sind, verwenden Sie Version 3 der Erweiterung.

Außerdem basieren die von dieser Erweiterung erstellten Aktivitäten auf von UiPath erstellten Bibliotheken, die derzeit im Marketplace-Feed verfügbar sind (https://galerie.uipath.com/api/v3/index.json). Dieser Feed muss während der Entwicklung in Visual Studio verfügbar sein, oder die Aktivitäten werden nicht erfolgreich erstellt.

Schritt 1: Hinzufügen der UiPath Activity Creator-Erweiterung zu Visual Studio

Öffnen Sie Visual Studio und klicken Sie auf Erweiterungen > Erweiterungen verwalten.

Klicken Sie im angezeigten Assistenten auf Online und dann auf Suchen (Ctrl+E) nach UiPath. Laden Sie die UiPath Activity Creator- Erweiterung herunter.

Schließen Sie Visual Studio und schließen Sie die Installation ab, sobald das VSIX-Installationsprogramm angezeigt wird.

Schritt 2: Erstellen eines UiPath-Projekts

Öffnen Sie Visual Studio erneut und doppelklicken Sie auf Ein neues Projekt erstellen auf dem Startbildschirm.

Geben Sie auf dem Bildschirm Ein neues Projekt erstellen in die Suchleiste „uipath“ ein, wählen Sie UiPath Standard Activity-Projekt aus und klicken Sie auf Weiter.

Geben Sie Ihrem Projekt einen Namen. Die UiPath-Konvention ist <Your company's name>.<Your product's name> (z. B UiPath Orchestrator). Klicken Sie dann auf Erstellen.

Navigieren Sie zum Lösungs-Explorer und beachten Sie, dass nun 3 Projekte, ein freigegebener Ordner und viele Dateien zur Lösung hinzugefügt wurden. Dies ist die Grundlage jedes Aktivitätspakets.Die einfache Aktivität zum Hinzufügen Ihrer ersten Aktivität.

Die einfache Aktivität

Nachdem Sie Ihr Paket erstellt haben, fügen wir ihm eine Aktivität hinzu! In diesem Beispiel erstellen Sie die oben gezeigte Aktivität: eine einfache, die zwei Zahlen addiert.

Was Sie benötigen

• Visual Studio Community/Profi/Enterprise (2019 erforderlich)
• UiPath Studio
• Verwenden des Activity Creator

Schritt 1: Öffnen des Aktivitätserstellers

Öffnen Sie zunächst die Visual Studio-Lösung, die im vorherigen Abschnitt erstellt wurde, und wählen Sie eines der Hauptprojekte (diese sind die Projekte mit der Bezeichnung MyCompany.MyProduct...) im Lösungs-Explorer aus. Navigieren Sie dann in der Symbolleiste zu Erweiterungen > UiPath > Aktivitäten hinzufügen . Beachten Sie, dass dieses Menü deaktiviert bleibt, bis eines der Projekte ausgewählt ist.

Schritt 2: Erstellen einer Aktivität

Dadurch wird ein neues Fenster „Activity Creator“ geöffnet. Auf dem ersten Bildschirm haben Sie zwei Optionen:

1. Erstellen: Erstellen Sie eine oder mehrere Aktivitäten von Grund auf.
2. Importieren: Importieren Sie eine Liste vordefinierter Aktivitäten, die in einem Standardformat gespeichert wurden.

Wählen Sie vorerst Erstellen aus.

Schritt 3: Aktivität definieren

Klicken Sie auf die Schaltfläche Hinzufügen und füllen Sie jedes Feld wie unten gezeigt aus. Dadurch wird der Ersteller auf die Erstellung einer Aktivität namens Addition vorbereitet. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Bearbeiten, um der Addition-Aktivität Eigenschaften hinzuzufügen.

Schritt 4: Eigenschaften hinzufügen

Dadurch wird ein neues Fenster Eigenschaften definieren geöffnet. Verwenden Sie die Schaltfläche Hinzufügen , um 3 Eigenschaften zu erstellen, wie unten gezeigt.

Stellen Sie sicher, dass die ersten beiden Eingaben und die letzte eine Ausgabe ist. Diese Eigenschaften stellen zwei Zahlen und deren Summe dar.

Schritt 5: Generieren der Aktivität

Klicken Sie im Fenster Eigenschaften auf OK und im Aktivitätenfenster auf Fertig stellen . Sie werden dann sehen, dass einige neue Dateien zu Ihren Projekten hinzugefügt wurden.

Schritt 6: Funktion hinzufügen

Öffnen Sie die gerade erstellte Addition.cs-Datei und erweitern Sie die darin enthaltene Region Protected Methods , um die ExecuteAsync -Methode der Aktivität anzuzeigen. Diese Methode wird aufgerufen, wenn die Aktivität in UiPath Studio ausgeführt wird.

Beachten Sie, dass die beiden in Schritt 4 erstellten Eingaben (Erste Zahl und zweite Zahl) sowie die Ausgabe (Sum) dieser Methode bereits hinzugefügt wurden. Im letzten Schritt wird die Lücke zwischen ihnen geschlossen, indem der Kommentarblock durch Code ersetzt wird, der die beiden Eingaben hinzufügt und dann das Ergebnis auf „Sum“ festlegt. Siehe unten:

Schritt 7: Erstellen des Pakets

Klicken Sie im Solution Explorer mit der rechten Maustaste auf Ihr Designprojekt und wählen Sie Veröffentlichen aus. Diese Option erstellt Ihre Projekte, gepackt sie zusammen und sendet das Paket an den gewünschten Speicherort.

Geben Sie auf dem nächsten Bildschirm den Ordner ein, in dem Sie Ihr Aktivitätspaket speichern möchten. Es empfiehlt sich, eine Ihrer Paketquellen in UiPath Studio auszuwählen (diese finden Sie unter Einstellungen > Quellen verwalten auf der Studio-Startseite), sodass Sie direkt aus Visual Studio in UiPath Studio veröffentlichen können.

Klicken Sie auf Profil erstellen , um fortzufahren.

Benennen Sie auf der nächsten Seite Ihre Paketquelle in UiPath-Pakete um (oder wie auch immer Sie möchten) und ändern Sie die Konfiguration in Debuggen. Klicken Sie dann auf Veröffentlichen.

Weitere Informationen zu den Konfigurationen Debuggen im Vergleich zu Release finden Sie unter Paketmetadaten.

Ihre Ausgabe zeigt dann, dass alle drei Projekte erfolgreich erstellt und das resultierende Paket veröffentlicht wurden. Sie haben jetzt ein funktionierendes Aktivitätspaket!

Schritt 8: Verwenden Ihrer Aktivitäten in UiPath Studio

Öffnen Sie UiPath Studio, navigieren Sie zum Paketmanager und fügen Sie Ihren Aktivitätssatz zum Workflow hinzu.

Beachten Sie, dass dem Aktivitäten-Bereich eine neue Kategorie hinzugefügt wurde.

Das war alles! Probieren Sie Ihre neue Aktivität aus!

Paketmetadaten

Wenn Sie sich das in diesem Tutorial erstellte Aktivitätspaket ansehen, sehen Sie mehrere Platzhalter, an denen Informationen wie Autor, Lizenz, Symbol usw. stehen müssen. Wir personalisieren das Paket und ersetzen diese Platzhalter durch echte Informationen.

Der Schwerpunkt dieses Abschnitts liegt auf dem Designprojekt, das alle Ihre Paketinformationen enthält.

Was Sie benötigen

• Visual Studio Community/Profi/Enterprise (2019 erforderlich)
• UiPath Studio
• Verwenden des Activity Creator

Schritt 1: Öffnen des Design-Projekts

Öffnen Sie das Projekt MyCompany.MyProduct.Activities.Design , indem Sie darauf doppelklicken. Beachten Sie, dass es drei beschriftete Abschnitte gibt:

• Paketmetadaten
• Paketversionen
• Paketsymbol

Paketmetadaten

Feld	Beschreibung
PackageLicenseExpression	Ein DCX-Bezeichner für die Lizenz, die Sie verwenden möchten. Der Standardwert ist Apache 2.0.
Description	Eine kurze Beschreibung Ihrer Aktivitäten, die im Paketmanager von UiPath Studio angezeigt wird.
Authors and Company	Der Autor bzw. der Besitzer des Pakets.
Copyright	Der standardmäßige Urheberrechtshinweis.
PackageTags	Eine Liste von Begriffen, nach denen Benutzer suchen können, um Ihr Paket zu finden.
PackageProjectUrl	Ein Link zur Dokumentation Ihrer Aktivitäten oder zur Unternehmenshomepage.
PackageIconUrl	Ein Link zu einer Bilddatei, die als Paketsymbol verwendet wird. Beachten Sie, dass das Tag PackageIcon derzeit in UiPath Studio nicht unterstützt wird.

<PropertyGroup>
    <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
    <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
    <Description>A package used to perform simple arithmetic operations in UiPath Studio.</Description>
    <Authors>My Company</Authors>
    <Company>My Company</Company>
    <Copyright>@ 2020 My Company</Copyright>
    <PackageTags>UiPath Activity MyCompany MyProduct Math Addition Arithmetic</PackageTags>
    <PackageProjectUrl>https://docs.uipath.com/integrations/docs/how-to-create-activities</PackageProjectUrl>
    <PackageIconUrl>https://raw.githubusercontent.com/NuGet/Samples/master/PackageIconNuspecExample/icon.png</PackageIconUrl>
    ...
</PropertyGroup>

Paketversion

Beachten Sie, dass es hier zwei PackageVersion -Tags gibt, die den beiden Modi entsprechen, in denen ein Paket erstellt werden kann: Debuggen und Freigeben.

• Debuggen ist während der Entwicklung nützlich. Die Version erhöht sich mit jedem Build, sodass Aktualisierungen vorgenommen und dann sofort in UiPath Studio getestet werden können.
• Mit Release wird ein endgültiges Paket erstellt, das für die Veröffentlichung bereit ist. Sobald die Entwicklung abgeschlossen ist, können Sie hier die gewünschte Version festlegen.

  <PropertyGroup Condition="'$(Configuration)' == 'Debug'">
      <PackageVersion>0.2.0.$([System.DateTime]::UtcNow.ToString(MMddHmmss)) Version</PackageVersion>
  </PropertyGroup>
    
  <PropertyGroup Condition="'$(Configuration)' == 'Release'">
      <PackageVersion>0.2.0</PackageVersion>
  </PropertyGroup>
  

Paketsymbol

Verwenden Sie das PackageIconUrl -Tag, um Ihrem Aktivitätspaket ein Symbol hinzuzufügen. In diesem Beispiel wird ein Beispielsymbol verwendet.

Schritt 2: Erneutes Erstellen des Pakets

Erstellen Sie das Paket neu und importieren Sie es in UiPath Studio wie im vorherigen Abschnitt. Öffnen Sie den Paketmanager und sehen Sie, wie Ihr Paket jetzt ein neues Symbol, eine neue Beschreibung und aktualisierte Metadaten hat.