Pakete und Bibliotheken

NuGet-Pakete, die von UiPath Robot verwendet werden: Standardfeeds, lokale und Orchestrator-Feeds, Verhalten bei der Paketzwischenspeicherung und Feedkonfiguration in Studio.

Ein Paket ist ein Bundle, das alle Automatisierungselemente wie Aktivitäten, Workflows, Dateien und Datenquellen enthält. Wenn Sie ein Projekt in Studio erstellen, veröffentlichen Sie es als Paket an einem bestimmten Speicherort oder Feed. Von hier aus kann der Roboter es herunterladen und verwenden, um die Automatisierung auszuführen.

Wichtig:

Verwenden Sie absolute Pfade, um den Speicherort von Paketen anzugeben.

Standardfeeds

Folgende Speicherorte und 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.

• Local - The feed for the packages installed locally with Studio. When Studio of the same version is installed side by side with the Robot, the feed is the Packages folder of Studio, %ProgramFiles%\UiPathPlatform\Studio\<version>\Packages for per-machine installations or %LocalAppData%\Programs\UiPathPlatform\Studio\<version>\Packages for per-user installations. Otherwise, it's the Packages folder in the Robot installation folder, which might not exist.

  Hinweis:

  Das im Fenster Pakete verwalten angezeigte Veröffentlichungsdatum für Pakete aus dem lokalen Feed ist das Datum, an dem das Installationsprogramm von Studio erstellt wurde, und nicht das Datum, an dem die Pakete veröffentlicht wurden.

• Offiziell – Der offizielle Online-UiPath-Feed, in dem Sie die Aktivitätspakete finden, die von uns offiziell unterstützt werden. Dieser Feed hat die folgende Quelle: https://pkgs.uipath.com/official/index.json.

• Marketplace – Dieser öffentliche Feed enthält alle Aktivitäten, die auf dem UiPath Marketplace veröffentlicht wurden.

  Hinweis:

  Ob Pakete erstellt und offiziell von UiPath unterstützt werden, wird ausdrücklich im Fenster Pakete verwalten auf der Registerkarte Paketinformationen angegeben.

  Dieser Feed hat die folgende Quelle: https://gallery.uipath.com/api/v3/index.json.

Benutzerdefinierte Feeds

In Enterprise installations, a custom activity feed can only be used in workflows started from Studio on that user. Starting a job on the same machine from Orchestrator or the Assistant results in the Robot not being able to retrieve the appropriate package. To avoid such scenarios, add the custom feed to the NuGet.config file of the Robot. For the steps, refer to Configuring activity feeds.

Wichtig:

Um benutzerdefinierte Feeds zu verwenden, stellen Sie sicher, dass der Roboter Zugriff auf den benutzerdefinierten Speicherort hat.

Aktivitätsfeeds

Wenn mehrere Feeds verwendet werden, wählt NuGet den Feed aus, der am schnellsten reagiert. Da Aktivitätspakete mehrere Versionen haben können, sucht der Roboter nach einer Version, die auf den runtime-Regeln in Studio basiert:

• Für die Regel „Strict runtime“ sucht der Roboter nur nach der angegebenen Paketversion.Wenn Sie beispielsweise Version 2.5.0 auswählen und die runtime-Regel auf Strict festlegen, sucht der Roboter nur nach Version 2.5.0.Wenn nicht gefunden, wird ein Fehler ausgegeben.
• Für die Laufzeitregel mit der niedrigsten anwendbaren Version sucht der Roboter nach der angegebenen Paketversion oder höher. Wenn Sie beispielsweise Version 2.5.0 auswählen und die runtime-Regel als niedrigste anwendbare Version festlegen, sucht der Roboter nach Versionen, die mit 2.5.0 beginnen (2.5.0, 2.5.1, 2.5.2 usw.).Wenn nicht gefunden, wird ein Fehler ausgegeben.

Wenn ein Feed signierte Pakete und Abhängigkeiten fehlen, schlägt die Automatisierung möglicherweise fehl. Dies liegt daran, dass der Roboter erwartet, dass alle Pakete und Abhängigkeiten signiert sind. Um dies zu verhindern, stellen Sie sicher, dass alle konfigurierten Feeds nur signierte Pakete und Abhängigkeiten enthalten.

Wichtig:

• Jedes Mal, wenn Sie Konfigurationsdateien ändern, müssen Sie den Roboterdienst neu starten, damit die Änderungen wirksam werden.

• Um HTTPS feeds von NuGet.config zu ignorieren, fügen Sie folgende Zeile in UiPath.config, unter <packageSettings> hinzu:

  <add key="skipHttpConfigurationSources" value="true" />
  

The UiPath Platform Installer adds two feeds to the NuGet.config file in the Robot installation folder: the Local feed, and the Executors feed, which holds the executor packages for agents, functions, and API workflows. Both are enabled by default.

Wenn Sie den Roboter mit Orchestrator verbinden, wird ein NuGet-Feed von Orchestrator bereitgestellt. Er enthält die Aktivitätspakete, die offiziell von UiPath unterstützt werden. Dieser Feed ist standardmäßig aktiviert und hängt von Ihren Speichereinstellungen ab.

In der folgenden Liste sind die vom Roboter verwendeten Feeds zusammengefasst, je nach Verbindung des Roboters zu Orchestrator:

• Mit Orchestrator verbundener Roboter
  • Wenn NuGet.Repository.Type auf Legacy festgelegt ist, werden Aktivitäten standardmäßig am ~/NuGetPackages/Activities-Speicherort gespeichert. Dieser Wert ist anpassbar und wird auf der Orchestrator-Maschine im NuGet.Activities.Path-Parameter der Datei web.config gespeichert.
  • Wenn NuGet.Repository.Type auf Composite festgelegt ist, werden Aktivitäten an dem Speicherort gespeichert, der durch Storage.Type und Storage.Location Parameter angegeben ist.
    Wichtig:

    Die Option Composite schränkt die Verwendung von Kopieren-Einfügen-Befehlen im Paketverzeichnis ein.

• Wenn der Roboter nicht mit dem Orchestrator verbunden ist oder die erforderlichen Aktivitäten im lokalen Feed nicht findet, verwendet er den folgenden Feed:

  https://pkgs.uipath.com/official/index.json
  

Dies ist der offizielle Online UiPath-Feed, der die Quelle ist, aus der der Paketmanager in Studio seine Aktivitäten abruft.Standardmäßig ist dieser Feed nicht aktiv. Um ihn zu aktivieren, gehen Sie in Studio zu Einstellungen > Quellen verwalten und wählen Sie hier die entsprechende Option.

Fallback-Paketordner

Ein Fallback-Paketordner ist ein Sicherungsordner, aus dem der Roboter notwendige Pakete abrufen kann, wenn die primäre Quelle ausfällt.

Um diesen Ordner einzurichten, fügen Sie die NUGET_FALLBACK_PACKAGESUmgebungsvariable auf der Robotermaschine hinzu.Die Variable sollte die Liste der vollständigen Pfade zu diesen Sicherungsordnern enthalten, die jeweils durch ein Semikolon getrennt sind. Wenn die Umgebungsvariable nicht existiert, versucht der Roboter, die Fallback-Ordner der NuGet-Pakete aus der Datei Nuget.configzu lesen.

Wichtig:

Sie können keine Fallback-Ordner verwenden, um ganze Automatisierungen oder Workflows zu speichern und auszuführen.

Prozesse, die in Fallback-Ordnern bereitgestellt werden, werden nicht unterstützt, nur Abhängigkeiten.