Pakete und Bibliotheken

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.
• Lokal – Der Feed für die Pakete, die lokal mit Studio installiert wurden. Der Feed hat die Quelle: %ProgramFiles%\UiPath\Studio\Packagesfür Installationen pro Maschine oder %localappdata%\Programs\UiPath\Studio\Packages für Installationen pro Benutzer.
  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 folgende Quelle:https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json
• Marketplace – Dieser öffentliche Feed enthält alle Aktivitäten, die im UiPath Marketplace veröffentlicht wurden. Beachten Sie, dass im Fenster Pakete verwalten auf der Registerkarte Paketinformationen ausdrücklich angegeben ist, ob Pakete erstellt und von UiPath offiziell unterstützt werden. Dieser Feed hat folgende Quelle:https://gallery.uipath.com/api/v3/index.json.

Benutzerdefinierte Feeds

In Enterprise-Installationen kann eine benutzerdefinierte Aktivität nur in Workflows verwendet werden, die von Studio für diesen Benutzer gestartet wurden.Das Starten eines Auftrags auf derselben Maschine über Orchestrator oder den Assistenten führt dazu, dass der Roboter das entsprechende Paket nicht abrufen kann. Um solche Szenarien zu vermeiden, fügen Sie den benutzerdefinierten Feed hinzu

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.

• Wenn die runtime-Regel der niedrigsten anwendbaren Version angezeigt wird, 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" />

In der folgenden Liste sind die vom Roboter verwendeten Feeds zusammengefasst, je nachdem, wie der Feed konfiguriert ist:

• Wenn Sie den lokalen Feed installieren, wird der Ordner %ProgramFiles%\UiPath\Studio\Packages erstellt. Er enthält die Aktivitätspakete, die zur Installationszeit offiziell von UiPath unterstützt werden. Der Feed ist standardmäßig aktiviert.
• Wenn Sie den lokalen Feed nicht installieren, wird der Ordner %ProgramFiles%\UiPath\Studio\Packages erstellt, der jedoch nur die Pakete enthält, die einem neuen Projekt als Standardabhängigkeiten hinzugefügt werden:

  • UiPath.UIAutomation.Activities

  • UiPath.System.Activities

  • UiPath.Excel.Activities

  • UiPath.Mail.Activities

Wenn Sie den Roboter mit Orchestrator verbinden, wird ein NuGet-Feed von Orchestrator bereitgestellt. Es enthält die Aktivitätspakete, die von UiPath offiziell 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.

Roboter ist nicht mit Orchestrator verbunden

Wenn der Roboter nicht mit Orchestrator verbunden ist oder die erforderlichen Aktivitäten im lokalen Feed nicht findet, verwendet er folgenden Feed: https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/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.