Abonnieren

UiPath Studio

UiPath Studio-Anleitung

Verwalten von Aktivitätspaketen

Informationen über Aktivitätsfeeds

Studio verwendet NuGet-Feeds zur Installation von Aktivitätspaketen. Diese Feeds können in Studio auf zwei Arten gehandhabt werden:

  • application level - feeds are configured from the Settings > Manage Sources tab
  • Projektebene: Feeds werden mit der Schaltfläche Pakete verwalten auf dem Menüband konfiguriert.

Zum Deaktivieren eines Aktivitätsfeeds müssen Sie das entsprechende Kontrollkästchen deaktivieren. Das Aktivieren oder Deaktivieren eines Feeds ist sowohl auf Projekt- als auch auf Anwendungsebene möglich.

Die folgenden Aktivitätsfeeds sind standardmäßig in Studio konfiguriert:

  • Orchestrator - This activities feed is added by default if your Robot is connected to Orchestrator. For more info, see the About the Activities Feed chapter. This feed is enabled by default, and has the following source: https://[Orchestrator_host]/nuget/activities.
  • Local - The feed can be excluded when installing Studio with the .msi installer. If you choose not to install the local activities feed, the folder is still created, but contains only the default activities, UiPath.UIAutomation.Activities, UiPath.System.Activities, UiPath.Excel.Activities and UiPath.Mail.Activities, together with dependencies previously set to a project. If installed, the feed is enabled by default, and has the following source: %ProgramFiles(x86)%\UiPath\Studio\Packages. Check out the list of default activities packages here.
  • Official - The official online UiPath feed, where you can find the activity packages that are officially supported by us. This feed is disabled by default, and has the following source: https://www.myget.org/F/workflow/.
  • Go! - Der öffentliche Go!-Feed enthält alle Aktivitäten, die auf dem UiPath Go!-Marktplatz veröffentlicht wurden, unserer ständig wachsenden Community von Partnern, Freelancern und UiPath RPA-Entwicklern. Bitte beachten Sie, dass die Frage, ob Pakete von UiPath erstellt und offiziell unterstützt werden, im Fenster Pakete verwalten auf der Registerkarte Paketinformationen ausdrücklich beantwortet wird. Dieser Feed ist standardmäßig deaktiviert und hat die folgende Quelle: https://gallery.uipath.com/api/v2.
    Bitte berücksichtigen Sie, dass UiPath keine Kontrolle über die Entfernung von Paketen aus der Liste hat, die von Partnern und der Connect Feed-Community erstellt werden. UiPath hält jedoch nicht gelistete Pakete aktiviert, um die Rückwärtskompatibilität zu Ausführungszeitzwecken sicherzustellen.
10821082

📘

Hinweis:

Die Feed-Konfiguration bleibt bei einem Upgrade auf eine spätere Studio Enterprise Edition erhalten. Wenn Studio jedoch mit einer in Orchestrator bereitgestellten Lizenz aktiviert wird, sind standardmäßig nur die Feeds Local und Orchestrator aktiviert.

Hinzufügen benutzerdefinierter Feeds

📘

Hinweis:

In Enterprise-Installationen kann ein benutzerdefinierter Aktivitätsfeed nur in Workflows verwendet werden, die von Studio für diesen Benutzer gestartet wurden. Wenn ein Job auf demselben Computer von Orchestrator oder dem Agenten (Robot Tray) gestartet wird, kann der Robot das entsprechende Paket nicht abrufen. Um solche Szenarien zu vermeiden, sollten Sie den benutzerdefinierten Feed in der Datei UiPath.settings unter der Eigenschaft ActivitiesFeed hinzufügen, anstatt die unten stehende Methode zu verwenden.

  1. Im Fenster Pakete verwalten (Manage Packages) klicken Sie auf die Einstellungen (Settings). Die Paketquellen werden eingeblendet.
11251125
  1. Klicken Sie auf die Schaltfläche image alt textimage alt text, um einen Feed zur Kategorie Benutzerdefinierte Paketquellen (User defined package sources) hinzuzufügen.
  2. Geben Sie den Namen der Paketquelle oder den Namen des NuGet-Feeds ein.
  3. Geben Sie in das Feld Quelle (Source) den Pfad des lokalen Laufwerksordners, den Pfad des freigegebenen Netzwerkordners oder die NuGet-Feed-URL ein.
  4. Klicken Sie auf Hinzufügen (Add). Der neue Feed wird automatisch zu den benutzerdefinierten Paketquellen (User defined package sources) und in der Kategorie Alle Pakete (All Packages) des Fensters Pakete verwalten (Manage Packages) hinzugefügt. Der Feed ist per Standard aktiviert.
  5. Klicken Sie auf Speichern (Save), um alle Änderungen zu übernehmen.

Benutzerdefinierte und standardmäßige Paketquellen können im Fenster Pakete verwalten (Manage Packages aktiviert oder deaktiviert werden.

Bitte beachten Sie, dass Feeds sofort hinzugefügt werden. Durch Klicken auf die Schaltfläche Schließen (Close) oder Abbrechen (Cancel) nach dem Hinzufügen eines Feeds werden keine Änderungen rückgängig gemacht.

📘

Hinweis:

Wenn der benutzerdefinierte Feed ein Paket enthält, das beschädigt ist oder gerade in einem Editor geändert wird, kann das Fenster Pakete verwalten keine Pakete in den Feed laden.

Hinzufügen sicherer Feeds

If you want to add a custom NuGet feed that requires authentication, you can follow the steps explained here.

Sie müssen den NuGet-Feed, den Benutzernamen und das Passwort in der Datei NuGet.config hinzufügen, die im folgenden Pfad liegt: %AppData%\NuGet. Anschließend sollte der Feed im Fenster Paketverwaltung (Manage Packages) zu sehen sein.

<packageSources>
  <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  <add key="FeedName" value="https://FeedSource" />
  </packageSources>
  
 <packageSourceCredentials>
  <FeedName>
    <add key="Username" value="YourUsername" />
    <add key="Password" value="YourPassword" />
  </FeedName>
</packageSourceCredentials>

Bitte denken Sie daran, dass key="ClearTextPassword" durch key="Password" ersetzt werden muss, wenn keine verschlüsselten Passwörter verwendet werden.

Entfernen benutzerdefinierter Feeds

📘

Hinweis:

Nur benutzerdefinierte Paketquellen (User defined package sources) können im Fenster Pakete verwalten (Manage Packages) entfernt werden.

  1. Klicken Sie in der Kategorie Einstellungen (Settings) auf einen beliebigen Feed im Abschnitt Benutzerdefinierte Paketquellen (User defined package sources).
  2. Klicken Sie auf die Schaltfläche Entfernen (Remove) image alt textimage alt text. Der Feed wird aus der Kategorie Alle Pakete (All Packages) und dem Abschnitt Benutzerdefinierte Paketquellen (User defined package sources) entfernt.
  3. Klicken Sie auf Speichern (Save), um alle Änderungen zu übernehmen.

Bitte beachten Sie, dass Feeds sofort entfernt werden. Durch Klicken auf die Schaltfläche Schließen (Close) oder Abbrechen (Cancel) nach dem Hinzufügen von standardmäßigen oder benutzerdefinierten Feeds werden keine Änderungen rückgängig gemacht.

Herstellen einer Verbindung zu Feeds über einen Proxyserver

Wenn Ihr Computer über einen Proxyserver verbunden ist, müssen Sie die NuGet-Proxyeinstellungen so konfigurieren, dass Sie auf Feeds außerhalb Ihres Netzwerks zugreifen können:

  1. Laden Sie nuget.exe von https://www.nuget.org/downloads herunter.
  2. Öffnen Sie ein Eingabeaufforderungsfenster in dem Ordner, in den nuget.exe heruntergeladen wurde, und führen Sie die folgenden Befehle aus, um die Adresse, den Benutzernamen und das Kennwort für den Proxyserver zu konfigurieren:
    nuget.exe config -set http_proxy=<http://proxy.server.address:port>
    nuget.exe config -set http_proxy.user=<mydomain\myUserName>
    nuget.exe config -set http_proxy.password=<myPassword>
  3. Überprüfen Sie, ob die Datei NuGet.config in %AppData%\NuGet mit der neuen Konfiguration aktualisiert wurde:
<config>
    <add key="http_proxy" value="http://proxy.server.address:port" />
    <add key="http_proxy.user" value="mydomain\myUserName" />
    <add key="http_proxy.password" value="myEencryptedPassword" />
</config>
  1. Starten Sie Studio neu.

Verwaltung von Paketen

Die Funktion „Package Manager“ ermöglicht es Ihnen, Aktivitätspakete, Bibliotheken, Frameworks, Wrapper usw. herunterzuladen, bereits auf Ihrem Computer für Ihr Projekt installierte Pakete anzuzeigen und zu aktualisieren sowie Ihre eigenen hinzuzufügen und zu entfernen. Sie zeigt die Liste der verfügbaren Pakete pro Feed und die Liste der Abhängigkeiten im aktuellen Projekt an. Das Fenster Pakete verwalten (Manage Packages) öffnet sich immer mit der Liste Projektabhängigkeiten (Project Dependencies).

11251125

Ein Aktivitätspaket ist ein Bündel von Aktivitäten, das Ihnen helfen kann, eine bestimmte Anwendung (UiPath.Excel.Activities, UiPath.Word.Activities) oder eine App-Kategorie (UiPath.Mail.Activities, UiPath.Terminal.Activities) zu automatisieren, oder bestimmte Technologien in Ihren Automatisierungen zu verwenden (UiPath.OCR.Activities, UiPath.FTP.Activities).

Details zu Paketen und Bibliotheken werden im rechten Panel des Fensters Pakete verwalten (Manage Packages) angezeigt, wie Sie im obigen Screenshot sehen können.

📘

Hinweis:

Versionshinweise für Aktivitätspakete sind bedingt durch eine NuGet v3-Einschränkung nicht im Fenster Pakete verwalten (Manage Packages) sichtbar.

Wenn das Kontrollfeld Prereleases einschließen (Include Prerelease) neben der Suchleiste markiert ist, werden eventuelle Betaversionen der Bibliothekspakete angezeigt.
Aktivieren Sie das Kontrollkästchen Vorabversion einschließen, wenn Beschreibungen für die Abhängigkeiten des Projekts im Fenster Pakete verwalten nicht sichtbar sind.

📘

Wichtig:

UiPath.UIAutomation.Activities- und UiPath.System.Activities-Pakete sind mit Studio v2018.3 und höher kompatibel.

Installieren von Paketen

📘

Hinweis:

Eine Internetverbindung ist erforderlich, um die Aktivitätspakete herunterzuladen und zu installieren.

  1. Wählen Sie im Fenster Pakete verwalten (Manage Packages) die Kategorie Alle Pakete (All Packages) aus. Öffnet eine Liste aller Pakete, die von Ihren Feeds gesammelt wurden.
11251125
  1. Scrollen Sie in der Liste nach unten, um das Paket zu finden, das Sie installieren möchten, oder geben Sie dessen Namen in die Suchleiste ein. Markieren Sie das Kontrollfeld Früher Version einschließen (Include Prerelease) um mögliche Betaversionen der Aktivitätspakete einzuschließen.
  2. Wählen Sie ein Aktivitätspaket aus, um dessen Beschreibung, Version, Abhängigkeiten, die Projekt-URL und das Datum der Veröffentlichung anzuzeigen.
  3. Klicken Sie auf die Dropdownliste neben Version (Version), um eine Paketversion auszuwählen, und legen Sie dann eine Ausführungszeitregel (Runtime Rule) fest. Um weitere Informationen zum Festsetzen von Ausführungszeitregeln für Projektabhängigkeiten zu erhalten, gehen Sie auf die Seite Verwalten von Abhängigkeiten (Managing Dependencies).
  4. Klicken Sie auf die Schaltfläche Installieren (Install). Alternativ können Sie auf das Symbol image alt textimage alt text neben dem Paketnamen klicken, um ihn mit dem Symbol image alt textimage alt text zu markieren und zum Installieren fertigzumachen.
547547
  1. Das Fenster Lizenz akzeptieren (License Acceptance) wird eingeblendet, wenn das Aktivitätspaket es erfordert, dass Sie die Lizenzbedingungen akzeptieren. Klicken Sie auf Lizenz anzeigen (View License), um die Lizenzbedingungen zu lesen.
    • Klicken Sie auf Ich akzeptiere (I Accept), um die Lizenzbedingungen zu akzeptieren und das Paket zu installieren.
    • Klicken Sie auf die Schaltfläche Ich akzeptiere nicht (I decline), um die Installation abzubrechen und wieder das Fenster Pakete verwalten (Manage Packages) anzuzeigen.

📘

Hinweis:

Beim Installieren mehrerer Aktivitätspakete enthält das Fenster Lizenz akzeptieren (License Acceptance) einen Link zur Lizenzvereinbarung für jedes von ihnen. Durch Anklicken von Ich akzeptiere (I Accept) oder Ich akzeptiere nicht (I Decline) können Sie die Lizenzvereinbarungen für alle Pakete entweder akzeptieren oder nicht akzeptieren.

  1. Pakete, die keine Lizenzvereinbarungen (License Agreements) haben, werden erst in Ihrem Projekt installiert, wenn Sie auf Speichern (Save) klicken.

📘

Hinweis:

Wird beim Installieren eines Aktivitätspakets der Pfad verfälscht, wird die Installation nicht abgeschlossen. Wir empfehlen, zu sichern und den Inhalt der folgenden lokalen Ordner %userprofile%\.nuget\packages und %userprofile%\AppData\Local\UiPath\.cache dann zu löschen.

Deinstallieren von Paketen

Um Pakete zu deinstallieren (To uninstall packages), gehen Sie zur Kategorie Projektabhängigkeiten (Project Dependencies) und klicken Sie neben dem Paket, das Sie nicht mehr verwenden möchten, auf die Schaltfläche Deinstallieren (Uninstall). Das Paket wird erst nach Klicken auf Speichern (Save) entfernt.

Beim Ausführen eines Automationsprojekts ist die Schaltfläche Pakete verwalten (Manage Packages) deaktiviert. Dies bedeutet, dass Aktivitätspakete erst dann installiert oder entfernt werden können, wenn die Ausführung gestoppt wurde.

Ändern des Download-Ordners für Pakete

Standardmäßig werden Aktivitätspakete heruntergeladen und im Ordner %userprofile%\.nuget\packages installiert. Sie können einen anderen Ordner auf eine der folgenden Arten festlegen:

  • During installation, by installing from the command line with the option PACKAGES_FOLDER.

  • Nach der Installation durch manuelles Bearbeiten der Datei uipath.config:

    1. Öffnen Sie die Datei uipath.config in einem Texteditor. Standardmäßig befindet sich die Datei in C:\Program Files (x86)\UiPath\Studio.
    2. Fügen Sie im Knoten packageSettings den Schlüssel packagesInstallationFolder mit dem Pfad zum neuen Ordner als Wert hinzu.
    3. Speichern Sie die Änderungen und, wenn der Roboter als Dienst installiert ist, starten Sie den Dienst neu.

    Fügen Sie beispielsweise zu uipath.config Folgendes hinzu, um den Download-Speicherort zu C:\nuget zu ändern.

<packageSettings>
  <add key="packagesInstallationFolder" value="C:\nuget" />
</packageSettings>

Vor ungefähr einem Jahr aktualisiert


Verwalten von Aktivitätspaketen


Auf API-Referenzseiten sind Änderungsvorschläge beschränkt

Sie können nur Änderungen an dem Textkörperinhalt von Markdown, aber nicht an der API-Spezifikation vorschlagen.