Using The Activity Creator

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 mithilfe 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 nur 5 Minuten zu erstellen. In diesem Abschnitt erstellen wir ein Aktivitätspaket und füllen es im nächsten mit funktionalen Aktivitäten aus.

Was Sie benötigen

• Visual Studio Community/Professional/Enterprise 2022 mit der Workload .NET Desktop-Entwicklung ist installiert
• Feed des UiPath-Marktplatzes (https://galerie.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 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/Professional/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/Professional/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 SPX-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 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.