Using The Activity Creator

Aktivitäten sind die Bausteine der Prozessautomatisierung. Jede enthält atomare Actions , die zusammen mit anderen Aktivitäten einen Workflow bilden.

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

Darüber hinaus können Sie mit der UiPath Activity Creator-Erweiterung für Visual Studio eigene benutzerdefinierte Aktivitäten erstellen, die speziell auf Ihre Anforderungen zugeschnitten sind. Mit den folgenden Schritten können Sie benutzerdefinierte Aktivitäten in fünf Minuten erstellen. In diesem Abschnitt erstellen wir ein Aktivitätspaket und füllen es mit funktionalen Aktivitäten auf.

Was Sie benötigen

• Visual Studio Community/Profi/Enterprise 2022 mit der Workload .NET-Desktopentwicklung
• Der UiPath-Marktplatz-Feed (https://galerie.uipath.com/api/v3/index.json) als Paketquelle in Visual Studio. Anweisungen zum Hinzufügen von Paketquellenfinden 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 UiPath-Marktplatz-Feed (https://galerie.uipath.com/api/v3/index.json) verfügbar sind. 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 Activities 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.

Close Visual Studio and, once the VSIX Installer appears, complete the installation.

Schritt 2: Erstellen eines UiPath-Projekts

Öffnen Sie Visual Studio erneut, und doppelklicken Sie auf dem Startbildschirm auf Neues Projekt erstellen .

Geben Sie auf dem Bildschirm Neues Projekt erstellen „uipath“ in die Suchleiste ein, wählen Sie UiPath-Standardaktivitätsprojekt 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 Projektmappen-Explorer und beachten Sie, dass jetzt drei Projekte, ein Ordner Freigegeben und viele Dateien zur Projektmappe hinzugefügt wurden. Dies ist die Grundlage jedes Aktivitätspakets.Die einfache Aktivität , um Ihre erste Aktivität hinzuzufügen.

The Simple Activity

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
• Using The Activity Creator

Schritt 1: Öffnen des Aktivitätserstellers

Öffnen Sie zunächst die im vorherigen Abschnitt erstellte Visual Studio-Projektmappe, und wählen Sie eines der Hauptprojekte (dies sind die mit der Bezeichnung MyCompany.MyProduct...) im Projektmappen-Explorer aus. Navigieren Sie dann in der Symbolleiste zu Erweiterungen > UiPath > Aktivitäten hinzufügen . Beachten Sie, dass dieses Menü deaktiviert ist, 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: Definieren der Aktivität

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 mit dem Namen Addition vorbereitet. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Bearbeiten, um der Aktivität Addition 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 drei 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 Fenster „Aktivitäten“ auf Fertig stellen. Dann sehen Sie einige neue Dateien, die Ihren Projekten hinzugefügt wurden.

Schritt 6: Hinzufügen von Funktionen

Ö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 Projektmappen-Explorer mit der rechten Maustaste auf Ihr Designprojekt, und wählen Sie Veröffentlichenaus. Mit dieser Option werden Ihre Projekte erstellt, zusammengepackt und das Paket an einen beliebigen Ort gesendet.

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 auf der Studio-Homepage unter Einstellungen > Quellen verwalten ), 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 (oder was auch immer Sie möchten) um und ändern Sie die Konfiguration zu Debug. Klicken Sie dann auf Veröffentlichen.

Weitere Informationen zu Debug- und Release-Konfigurationen 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!

Package Metadata

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
• Using The Activity Creator

Schritt 1: Öffnen des Designprojekts

Öffnen Sie das Projekt MyCompany.MyProduct.Activities.Design durch Doppelklick. Es gibt drei beschriftete Abschnitte:

• Package Metadata
• Paketversionen
• Paketsymbol

Package Metadata

Feld	Beschreibung
PackageLicenseExpression	Ein Bezeichner für die Lizenz, die Sie verwenden möchten. Der Standardwert ist Apache 2.0.
Beschreibung	Eine kurze Beschreibung Ihrer Aktivitäten, die im Paketmanager von UiPath Studio angezeigt wird.
Autoren und Unternehmen	Der Autor bzw. der Besitzer des Pakets.
Urheberrecht	Der standardmäßige Urheberrechtshinweis.
PaketTags	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 wird mit jedem Build erhöht, sodass Aktualisierungen vorgenommen und dann sofort in UiPath Studio getestet werden können.

• Release wird verwendet, um ein endgültiges Paket zu erstellen, das zur 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: Paket neu erstellen

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