Verwalten von Aktivitätspaketen

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

• Anwendungsebene - Feeds werden auf der Registerkarte Einstellungen > Quellen verwalten konfiguriert.
• Projektebene: Feeds werden mit der Schaltfläche Pakete verwalten auf dem Menüband konfiguriert.

Zum Deaktivieren eines Aktivitätenfeeds 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 Feeds sind standardmäßig in Studio konfiguriert:

• Orchestrator-Mandant und Orchestrator-Host – Diese Aktivitätenfeeds werden standardmäßig hinzugefügt, wenn Ihr Roboter mit dem Orchestrator verbunden ist, und sie können nicht deaktiviert werden. Die Option „Orchestrator-Mandant“ ist nur verfügbar, wenn der Bibliotheks-Feed des Mandanten im Orchestrator aktiviert ist. Die Feeds haben die folgende Quelle: https://[Orchestrator_host]/nuget/activities.
• Lokal – Der Feed für lokal mit Studio installierte Pakete. Der Feed hat die Quelle: %ProgramFiles%\UiPath\Studio\Packages für Installationen pro Maschine oder %localappdata%\Programs\UiPath\Studio\Packages für Installationen pro Benutzer.
  Hinweis: Das Veröffentlichungsdatum, das im Fenster „Pakete verwalten“ für Pakete aus dem lokalen Feed angezeigt wird, ist das Datum, an dem das Studio-Installationsprogramm erstellt wurde, nicht das Datum, an dem die Pakete veröffentlicht wurden.
• Offiziell (Official) - Der offizielle UiPath-Feed, in dem Sie die Aktivitätspakete finden, die offiziell von uns unterstützt werden. Dieser Feed hat die folgende Quelle: https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json.
• Marktplatz – Dieser öffentliche Feed enthält alle Aktivitäten, die auf dem UiPath-Marktplatz veröffentlicht wurden. 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 ist. Dieser Feed hat die folgende Quelle: https://gallery.uipath.com/api/v3/index.json.

  Bitte beachten Sie, dass UiPath keine Kontrolle über das Entfernen von Paketen aus der Liste hat, die von Partnern oder der UiPath-Marktplatz-Community erstellt wurden. Bei UiPath bleiben jedoch nicht gelistete Pakete weiterhin aktiviert, um die Rückwärtskompatibilität aus Gründen der Ausführungszeit sicherzustellen.

  
  

  

  
  
  Hinweis: Die Feedkonfiguration wird beim Upgrade auf eine spätere Studio-Version beibehalten.

Die Feedverwaltung und -konfiguration ist im Fenster Pakete verwalten verfügbar, wenn eine Governance-Richtlinie nicht erzwungen wurde. Wenn eine solche Richtlinie erzwungen wird und eingeschränkte Rechte in Bezug auf die Feedverwaltung enthält, wird eine Meldung im Fenster angezeigt. Lesen Sie mehr über Governance.

Hinzufügen benutzerdefinierter Feeds

Hinweis: In Enterprise-Installationen kann ein benutzerdefinierter Aktivitätsfeed nur in Workflows verwendet werden, die von Studio für den Benutzer gestartet wurden. Das Starten eines Auftrags auf derselben Maschine vom Orchestrator oder dem UiPath Assistant aus führt dazu, dass der Roboter das entsprechende Paket nicht abrufen kann. Um solche Szenarien zu vermeiden, sollten Sie den benutzerdefinierten Feed in der UiPath.settings-Datei unter der ActivitiesFeed-Eigenschaft hinzufügen, anstatt die untenstehende Methode zu verwenden.

1. Im Fenster Pakete verwalten (Manage Packages) klicken Sie auf die Einstellungen (Settings). Die Paketquellen werden eingeblendet.
   
   

   

   
   
2. Klicken Sie auf die Schaltfläche , um einen Feed zur Kategorie Benutzerdefinierte Paketquellen (User defined package sources) hinzuzufügen.
3. Geben Sie den Namen der Paketquelle oder den Namen des NuGet-Feeds ein.
4. Geben Sie in das Feld Quelle (Source) den Pfad des lokalen Laufwerksordners, den Pfad des freigegebenen Netzwerkordners oder die NuGet-Feed-URL ein.
5. 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.
6. 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

Wenn Sie einen benutzerdefinierten NuGet-Feed hinzufügen möchten, der Authentifizierung erfordert, können Sie die hier erläuterten Schritte durchführen.

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) . 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="myEncryptedPassword" />
   </config>

4. 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).

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.

Hinweis: 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.

Hinweis: Wenn Ihre Organisation erzwungene Paketsignierung verwendet, müssen Sie vertrauenswürdige Zertifikate für UiPath hinzufügen, um offizielle Pakete installieren zu können. Mehr dazu erfahren Sie hier.

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.
   
   

   

   
   
2. Suchen Sie das Paket, das Sie installieren möchten. Bitte beachten Sie, dass die verfügbaren Aktivitätspakete und -versionen von der für das Projekt ausgewählten Kompatibilität abhängen.

   Sie können:

   • in der Liste nach unten scrollen, um das Paket zu finden
   • nach dem Paket suchen, indem Sie einen Teil des Namens oder der Beschreibung in die Suchleiste eingeben.

   • Filtern Sie die Liste, indem Sie auf das Filter -Symbol neben der Suchleiste klicken und dann nur die Optionen auswählen, die Sie anzeigen möchten:

     • Einschließlich Vorabversionen: Betaversionen von Paketen einschließen, sofern verfügbar.
     • Nur StudioX – Listet nur Pakete auf, die für StudioX entwickelt wurden. (Diese Option ist nur im StudioX-Profil verfügbar)
     • Nur UiPath: Nur von UiPath veröffentlichte Pakete auflisten.
     • Nur Aktivitäten: Nur Aktivitätenpakete auflisten.
     • Nur Bibliotheken – Listet nur Bibliotheken auf.
     • Nur UI-Bibliotheken: Nur UI-Bibliotheken auflisten, die über das Object-Repository veröffentlicht wurden.
     • Nur kompatibel – Nur Pakete auflisten, deren neueste Version mit dem Projekt kompatibel ist. Wählen Sie diese Option nicht aus, wenn Sie Pakete mit älteren Versionen sehen möchten, die mit dem Projekt kompatibel sind.
3. Wählen Sie ein Aktivitätspaket aus, um dessen Beschreibung, Version, Abhängigkeiten, die Projekt-URL und das Datum der Veröffentlichung anzuzeigen.
4. 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).
5. Klicken Sie auf die Schaltfläche Installieren (Install). Alternativ können Sie auf das Symbol neben dem Paketnamen klicken, um ihn mit dem Symbol zu markieren und zum Installieren fertigzumachen.
6. Im Fenster Zustimmung zur Lizenz werden die Lizenzbedingungen für jedes Drittanbieterpaket angezeigt, das Sie installieren möchten. Klicken Sie auf Lizenz anzeigen, um die Lizenzbedingungen zu lesen.
   • Klicken Sie auf Ich akzeptiere, um die Lizenzbedingungen zu akzeptieren und die Pakete 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: Die allgemeinen Geschäftsbedingungen für UiPath-Pakete und ihre Abhängigkeiten werden bei der Installation von Studio implizit akzeptiert. Lesen Sie die UiPath-Nutzungsbedingungen und die Datenschutzerklärung.
7. Klicken Sie auf Speichern, um die Pakete zu installieren oder die Versionen zu aktualisieren.
   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, wechseln Sie zur Kategorie Projektabhängigkeiten und klicken Sie neben dem Paket, das Sie nicht mehr verwenden möchten, auf die Schaltfläche Deinstallieren. Das Paket wird erst entfernt, nachdem Sie auf Speichern geklickt haben.

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.

Downgrade von Paketen

Es wird nicht empfohlen, Aktivitätspakete herunterzustufen. Der Hauptgrund sind die negativen Auswirkungen auf Abhängigkeiten. Abhängigkeiten zwischen verschiedenen Aktivitätspaketen werden in jeder Version sorgfältig verwaltet. Daher kann eine Herabstufung zu Inkonsistenzen oder sogar zu fehlerhaften Workflows führen. Außerdem bieten neuere Aktivitätspakete verbesserte Funktionen und Funktionalitäten, die in älteren Versionen möglicherweise nicht verfügbar sind. Für eine optimale Leistung und zur Vermeidung potenzieller Fehler ist es daher ratsam, die Aktivitätspakete auf dem aktuellen Stand zu halten oder auf die neuesten Versionen zu aktualisieren.

Ä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:

• Während der Installation, durch Installieren über die Befehlszeile mit der 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\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>

Hinweis: Das Löschen des Inhalts des .nuget-Ordners führt beim Öffnen eines Projekts in Studio zu Abhängigkeitskonflikten.

Verwalten von Paketen in Offline-Umgebungen

Wenn Sie Studio auf einem Computer verwenden, der nicht mit dem Internet verbunden ist, können Sie Pakete auf einen anderen Computer herunterladen und sie manuell auf den Computer übertragen, auf dem Studio installiert ist. Das ist nur erforderlich, wenn keine Orchestrator-Verbindung verfügbar ist. Wenn Studio mit dem Orchestrator verbunden ist, können Pakete über Orchestrator-Feeds installiert werden.

Hinweis: Um zu vermeiden, dass Studio Pakete aus Online-Feeds herunterlädt, deaktivieren Sie alle Online-Feeds auf den Maschinen, die offline sind.

Installieren eines Pakets auf einer Offline-Studio-Maschine:

1. Laden Sie den NuGet Package Explorer auf einem Computer mit Internetzugang herunter und installieren Sie ihn.
2. Öffnen Sie den NuGet Package Explorer und wählen Sie Paket von einem Onlinefeed öffnen aus.
3. Geben Sie im Feld Paketquelle die URL des Feeds ein, aus dem das Paket heruntergeladen werden soll. Der offizielle Feed für UiPath-Pakete ist https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json.
4. Suchen Sie das Paket im Feed und laden Sie es herunter.
5. Übertragen Sie die NUPKG-Datei auf den Studio-Computer in einem Ordner, der in Studio als Paketquelle definiert ist. Um das Paket zum standardmäßigen lokalen Feed hinzuzufügen, kopieren Sie die Datei nach %ProgramFiles%\UiPath\Studio\Packages für Installationen pro Maschine oder %localappdata%\Programs\UiPath\Studio\Packages für Installationen pro Benutzer.