Informationen über Bibliotheken

Eine Bibliothek ist ein Projekt, das einen oder mehrere Workflows enthält, die als Aktivitäten in anderen Projekten wiederverwendet werden können. Bibliotheken werden bei der Veröffentlichung als NUPKG-Dateien gespeichert und können als Abhängigkeiten vom Paketmanager installiert werden.

Beispielsweise könnten Sie eine Bibliothek erstellen, die Daten aus einer Excel-Tabelle sammelt und sie an eine andere anhängt, wie auf der Seite Erstellen einer Basisbibliothek erläutert. Dann kann die Bibliothek verpackt und in anderen Prozessen als Aktivität verwendet werden.

Erstellen einer Bibliothek

Gehen Sie in die Studio-Backstage-Ansicht (Studio Backstage View > Starten (Start) > Bibliothek (Library). Das Fenster Neue leere Bibliothek (New Blank Library) wird geöffnet.
Geben Sie den Namen ein und wählen Sie einen Speicherort für die Bibliothek aus. Der standardmäßige Speicherort ist C:\Users\<current_user>\Documents\UiPath. Fügen Sie eine Beschreibung hinzu, wählen Sie die Projektkompatibilität und Sprache aus, und wählen Sie dann Erstellen aus. Die neue Bibliothek wird erstellt und auf Ihrer lokalen Maschine gespeichert.
Hinweis:
- Der Bibliothekname darf nicht länger als 128 Zeichen und die Beschreibung nicht länger als 500 Zeichen sein.
- Verwenden Sie lib nicht als Bibliotheksnamen, da dies zu einem Kompilierfehler in Projekten führt, in denen die Bibliothek installiert ist.
Im Projektbereich sehen Sie die Baumstruktur mit Projektordner, Abhängigkeiten und dem NewActivity.xaml, der den aktuellen Workflow enthält.

Jede Workflowdatei in einer Bibliothek ist als Aktivität in Projekten verfügbar, in denen die Bibliothek als Abhängigkeit installiert wird. Wenn Sie eine bestimmte Datei als privat festlegen möchten, klicken Sie mit der rechten Maustaste darauf und wählen Als privat festlegen aus. In diesem Fall ist die Datei im Bibliothekspaket enthalten, ist aber nicht als wiederverwendbare Komponente im Panel Aktivitäten verfügbar.

Hinweis:Die Abhängigkeiten, die für neue Bibliotheken verfügbar sind, sind standardmäßig dieselben wie für neue Projekte mit der Laufzeitregel Niedrigste gültige Version.

Extrahieren eines Projekts als Bibliothek

Sie können jedes Prozess- oder Testautomatisierungsprojekt als Bibliothek extrahieren, um es in anderen Projekten wiederzuverwenden. Sie können beispielsweise ein Testautomatisierungsprojekt konvertieren, um seine Vorlagen in anderen Automatisierungsprojekten zu verwenden.

Öffnen Sie ein Projekt in Studio.
Wählen Sie im Menüband Entwurf die Option Exportieren als und dann Bibliothek aus.
Wählen Sie die Workflows aus, die Sie als Bibliothek exportieren möchten. Standardmäßig wird das gesamte Projekt zusammen mit den Einstiegspunkten (Hauptworkflow und Testfälle) deaktiviert.
Konfigurieren Sie die folgenden Extraktionsoptionen:
- Testfälle einschließen: Standardmäßig ist diese Option für ein Prozessprojekt aktiviert und für ein Testautomatisierungsprojekt deaktiviert. Sie sollten diese Option aktivieren, wenn Sie Testfälle als Teil der extrahierten Bibliothek einschließen möchten.
- Bibliothek veröffentlichen und installieren: Wird automatisch ausgewählt, um das Paket in einem freigegebenen Feed zu veröffentlichen, und installiert die Bibliothek als Projektabhängigkeit. Sie können diese Option deaktivieren, wenn Sie die Bibliothek erstellen möchten, ohne sie zu veröffentlichen. Wenn sie deaktiviert ist, sind die restlichen Optionen nicht konfigurierbar.
- Ihre Workflows nach der Paketinstallation ändern: Wählen Sie diese Option aus, um die Workflows mit kompilierten Aktivitäten aus der Bibliothek zu ändern.
- Ersatzmodus: Wählen Sie die Workflow-Ersetzungsmethode aus.
  - Wählen Sie Inhalte aufgerufener Workflows ersetzen zum Ändern der Workflows, die vom Einstiegspunkt aufgerufen werden, oder der Testfälle mit entsprechenden Aktivitäten aus der extrahierten Bibliothek.
  - Verwenden Sie diese Option, wenn Sie die Eigenschaften „Isoliert“ und „Zielsitzungen“ für „Invoke Workflow“-Aktivitäten verwenden, um sie in einem separaten Windows-Prozess auszuführen bzw. in einer anderen Sitzung zu starten.
  - Wählen Sie „Invoke Workflow“-Aktivitäten ersetzen, um die Invoke Workflow -Aktivitäten mit Aktivitäten aus der extrahierten Bibliothek zu ändern.
    
    Warnung: Wählen Sie diese Option nicht aus, wenn Sie die Eigenschaften „Isoliert“ und „Zielsitzungen“ für „Invoke Workflow“-Aktivitäten verwenden.
- Ersetzte Workflows löschen: Löschen Sie die Workflows, die durch die extrahierten Bibliotheksaktivitäten ersetzt wurden.
- Ausführungsvorlagen aus Bibliothek festlegen: Fügen Sie Ausführungsvorlagen zur Bibliothek hinzu.
Klicken Sie auf Exportieren, um die Bibliotheksoptionen zu bestätigen.
Klicken Sie auf Erstellen, um die Erstellung der Bibliothek abzuschließen.
(Optional) Veröffentlichen Sie die Bibliothek, wenn Sie in Schritt 3 die Option Bibliothek veröffentlichen und installieren ausgewählt haben, und klicken Sie dann auf Veröffentlichen.

Hinweis: Wenn Sie die Option Bibliothek veröffentlichen und installieren nicht aktiviert haben, werden Sie aufgefordert, die Bibliothek zu öffnen oder mit dem aktuellen Projekt fortzufahren.

Wichtig: Das Ersetzen von Workflows oder aufgerufenen Aktivitäten aus der extrahierten Bibliothek erfolgt nicht für Workflows, bei denen Pseudo-Tests verwendet werden.

Konfigurieren des Layouts einer Aktivität

Argumente, die Sie in der Bibliothek definieren, werden zu Aktivitätseigenschaften in den Projekten, in denen die Bibliothek als Abhängigkeit installiert ist.

Um das Design und Verhalten einer Aktivität, wenn sie in einem Projekt verwendet wird, zu konfigurieren, klicken Sie mit der rechten Maustaste auf die Workflowdatei im Projekt-Bereich der Bibliothek und wählen Sie dann Aktivitätslayout aus. Das Fenster mit den Aktivitätseigenschaften wird je nach Bibliothekskompatibilität (Windows – Legacy, Windows oder Plattformübergreifend) mit verschiedenen Optionen angezeigt.

Optionen für Windows- und plattformübergreifende Bibliotheken

Wählen Sie Aktivitätseigenschaften im Menü auf der linken Seite aus und geben Sie Folgendes ein:

Anzeigename – Der Name der Aktivität, der im Bereich Aktivitäten angezeigt wird.
QuickInfo – QuickInfo, die angezeigt wird, wenn Sie in Projekten, in denen die Bibliothek installiert ist, mit der Maus auf die Aktivität in den Aktivitäten- und Designer-Bereichen zeigen.
Hilfelink – Der Hilfelink, der geöffnet wird, wenn Sie die Aktivität im Bereich Designer auswählen und F1 auf der Tastatur drücken.
SVG-Symbol – SVG-Symbol, das neben dem Aktivitätsnamen angezeigt wird.
Farbe – Farbe zum Hervorheben, die für die Aktivität im Designer-Bereich angezeigt wird.

Die in der Workflowdatei definierten Argumente werden unter Aktivitätseigenschaften im Menü auf der linken Seite aufgelistet.

Um die generierte Eigenschaft anzupassen, wählen Sie sie aus und konfigurieren Sie Folgendes:
- Anzeigename – Die Bezeichnung, die in der Aktivität für die Eigenschaft angezeigt wird.
- QuickInfo – QuickInfo, die angezeigt wird, wenn Sie mit der Maus auf die Aktivitätseigenschaft zeigen.
- Eingabetyp – Typ der Eingabe für die Eigenschaft. Sie können die Standardeingabe für den Eigenschaftstyp verwenden oder je nach Typ eine Eingabeoption auswählen:
  - Boolescher Wert – Verwenden Sie den Standard, Umschalten (Standard), Bedingungsgenerator, Optionsschalter.
  - Numerisch (int, double, decimal, long, short, sbyte, byte, ulong, ushort, unit, float) – Verwenden Sie den Standard, Zahleneditor, Dropdown. Geben Sie für das Dropdownmenü im Feld Werte jeden einzelnen Wert ein, indem Sie die Eingabetaste auf Ihrer Tastatur drücken.
  - String – Verwenden Sie den Standard, Text-Composer (Standard), Rich-Text-Composer, Dropdown, Autocomplete, Optionsfeld. Geben Sie für Dropdownmenü, Autovervollständigung und Optionsfeld im Feld Werte jeden einzelnen Wert ein, indem Sie die Eingabetaste auf der Tastatur drücken.
  - String[] – Verwenden Sie den Standard, String-Array.
  - Datum/Uhrzeit – Verwenden Sie den Standard, Datum/Uhrzeit.
  - Zeitraum – Verwenden Sie den Standard, Zeitraum.
  - Wörterbuch – Verwenden Sie den Standard, Wörterbuch.
  - Alle anderen Typen – Verwenden Sie den Standard, Eingabe.
- Platzhalter – Platzhaltertext, der für die Eingabe angezeigt werden soll, wenn kein Wert ausgewählt ist.
- Erforderlich – Gibt an, ob die Eigenschaft erforderlich ist.
- Nur erweitert – Gibt an, ob die Eigenschaft nur im Abschnitt mit den erweiterten Optionen der Aktivität angezeigt werden soll. Eigenschaften aus dem Abschnitt mit den erweiterten Optionen können auch in Kategorien organisiert werden.
Um eine Kategorie hinzuzufügen, unter der mehrere verwandte Eigenschaften gruppiert werden sollen, wählen Sie Neue Kategorie unten links im Fenster aus. Kategorien sind nur im Abschnitt mit den erweiterten Optionen der generierten Aktivität verfügbar und können erweitert oder reduziert werden. Wenn eine Kategorie leer ist, wird sie entfernt, wenn Sie auf Speichern klicken, um das Fenster zu schließen.
Um die Reihenfolge von Eigenschaften und Kategorien zu ändern oder Eigenschaften zu Kategorien hinzuzufügen, verschieben Sie die Elemente per Drag-and-drop auf der Liste.

Optionen für Windows-Legacy-Bibliotheken

Wählen Sie Aktivitätseigenschaften im Menü auf der linken Seite aus und geben Sie Folgendes ein:

QuickInfo – QuickInfo, die angezeigt wird, wenn Sie in Projekten, in denen die Bibliothek installiert ist, mit der Maus auf die Aktivität in den Aktivitäten- und Designer-Bereichen zeigen.
Hilfelink – Der Hilfelink, der geöffnet wird, wenn Sie die Aktivität im Bereich Designer auswählen und F1 auf der Tastatur drücken.

Die in der Workflowdatei definierten Argumente werden unter Aktivitätseigenschaften im Menü auf der linken Seite angezeigt.

Um die generierte Eigenschaft anzupassen, wählen Sie sie aus und konfigurieren Sie Folgendes:
- Anzeigename – Die Bezeichnung, die in der Aktivität für die Eigenschaft angezeigt wird.
- QuickInfo – QuickInfo, die angezeigt wird, wenn Sie mit der Maus auf die Aktivitätseigenschaft zeigen.
- Erforderlich – Gibt an, ob die Eigenschaft erforderlich ist.
- Nur Erweitert – Gibt an, ob die Eigenschaft nur im Eigenschaften-Bereich angezeigt werden soll. Wenn diese Option ausgewählt ist, wird die Eigenschaft für die generierte Aktivität nicht im Designer-Bereich angezeigt.
Um die Reihenfolge zu ändern, in der die Eigenschaften in der Aktivität angezeigt werden, verschieben Sie sie per Drag-and-drop auf der Liste.
Hinweis:
- Im Fall von Bibliotheken wird empfohlen, Nothing zum Zuweisen eines Nullwerts zu einer Variablen zu verwenden, anstatt "". Dadurch sollen Inkonsistenzen bei der Verwendung der gepackten Bibliothek als Abhängigkeit zu einem Projekt vermieden werden.
- Die Eigenschaft ImplementationVersion des Objekts System.Activities.ActivityBuilder wird nicht unterstützt. Das Festlegen eines Werts für diese Eigenschaft führt dazu, dass Argumente nicht gespeichert werden. Dieses Objekt wird im Bereich Eigenschaften angezeigt, wenn Sie den leeren Bereich des Bereichs Designer auswählen.

Anpassen der Bibliothekseinstellungen

Um die Einstellungen eines Bibliotheksprojekts zu konfigurieren, öffnen Sie das Fenster Projekteinstellungen, indem Sie im Bereich Projekt auf Einstellungen klicken.

Die folgenden Optionen sind auf der Registerkarte Allgemein verfügbar:

Name - Bearbeiten Sie den Namen des Projekts.
Beschreibung - Bearbeiten Sie die Beschreibung des Projekts.
Automation Hub URL – URL einer Automation Hub-Idee, die mit dem Projekt verknüpft ist. Weitere Informationen finden Sie unter Verknüpfen eines Projekts mit einer Idee im Automation Hub.
Projektsymbol – Definieren Sie optional ein Symbol für das Projekt. Sie können nach einer Datei suchen und diese auswählen, oder Sie geben einen Pfad oder eine öffentliche URL zu einer ico-, jpeg-, jpg-, oder png-Datei mit einer Größe von maximal 1 MB ein.

Nachdem das Projekt veröffentlicht wurde, wird das Symbol neben dem Paket im Fenster Pakete verwalten in Studio angezeigt.
Aktivitätsausdrücke kompilieren – Wählen Sie Ja aus, um alle Aktivitätsausdrücke mit der Bibliothek zu kompilieren und zu verpacken. Dies beschleunigt die Ausführung. Nur für Windows-Legacy-Bibliotheken verfügbar.
Bereit zur Ausführung – Wählen Sie Ja aus, um die generierten Assemblys für die schnellere JIT-Kompilierung zur Laufzeit zu optimieren. Nur für Windows-Legacy-Bibliotheken verfügbar.
Moderne Designumgebung – Legen Sie Ja fest, um eine moderne Arbeitsumgebung für UI-Automatisierung zu aktivieren, einschließlich neuer und verbesserter Aktivitäten, Recorder und Assistenten sowie des Object Repository.

Veröffentlichen einer Bibliothek

Das Veröffentlichen von Bibliotheken ähnelt dem Veröffentlichen von Prozessen. Weitere Informationen finden Sie unter Über die Veröffentlichung von Automatisierungsprojekten. Im Gegensatz zu Prozessen werden beim Veröffentlichen einer Bibliothek zwei NUPKG-Dateien erstellt – ein Paket für die Entwurfszeit und ein Paket für die Runtime. Dies gilt nur für Windows- und plattformübergreifende Bibliotheken, wenn die Projekteinstellungsoption Runtime-Abhängigkeiten trennen aktiviert ist.

Hinweis:

Aufgrund der Trennung zwischen Entwurfszeit- und Laufzeitpaketen kann nicht garantiert werden, dass benutzerdefinierte Bibliotheken, die in Studio 2023.4 veröffentlicht werden, mit früheren Studio-Versionen kompatibel sind.
Sie können nur das Entwurfszeitpaket in einem Projekt installieren, da es beim Veröffentlichen durch das Laufzeitpaket ersetzt wird. Wenn Sie nur das Laufzeitpaket installieren, führt dies zu unerwarteten Problemen in Studio.

Einschränkungen bei der Verwendung von Bibliotheken

Berücksichtigen Sie beim Verwenden von Bibliotheken die folgenden Einschränkungen:

Aufgrund von NuGet-Einschränkungen:
- Sie können keine Bibliotheken an Speicherorte veröffentlichen, die durch Benutzer eingeschränkte Unterordner enthalten, die Windows-Umgebungspfadvariablen verwenden.
- Versionshinweise für veröffentlichte Bibliotheken sind nur in Orchestrator sichtbar.
Bibliotheken mit Sonderzeichen in den Namen der darin enthaltenen .xaml-Dateien werden möglicherweise nicht veröffentlicht.
Wenn eine Bibliothek eine .xaml-Datei und ein Argument mit demselben Namen enthält, kann die Bibliothek nicht veröffentlicht werden.
Bibliotheksprojekte mit der Kompatibilität „Windows – Legacy“ können nicht veröffentlicht werden, wenn sie Invoke Workflow File-Aktivitäten mit der ausgewählten Option Isoliert enthalten. Beim Veröffentlichen wird im Ausgabe-Panel eine Fehlermeldung angezeigt. Diese Einschränkung gilt nicht für Bibliotheken, die die Windows- oder plattformübergreifende Kompatibilität verwenden.
Wenn Sie die Aktivität Workflow-Datei aufrufen (Invoke Workflow File) verwenden, müssen Sie sicherstellen, dass die aufgerufene Datei in demselben Ordner wie das Bibliotheksprojekt liegt.
Die Aktivität Launch Workflow Interactive wird bei Bibliotheken nicht unterstützt.
Die Verwendung von Workflow-Datei aufrufen in einer Bibliothek zum Verweisen auf die Bibliothek selbst wird nicht unterstützt.
Wenn eine Bibliothek eine Aktivität enthält, die einen Dateipfad als Eingabe akzeptiert, fügen Sie die globale Konstante UiPath.Constants.Project.Location hinzu, wenn Sie auf den Pfad verweisen (verwenden Sie genau diese Groß-/Kleinschreibung), um sicherzustellen, dass der Pfad in Projekten, in denen die Bibliothek installiert ist, korrekt aufgelöst wird. Dadurch wird das Ändern von Environment.CurrentDirectory in den Bibliotheksordner zu Beginn der Ausführung für eine Bibliotheksaktivität deaktiviert und stattdessen die Konstante verwendet.

Wenn beispielsweise eine Datei namens Employee.txt, die sich im InputData-Unterordner im Bibliotheksprojekt befindet, in einer Read File-Aktivität verwendet wird, geben Sie den Pfad wie folgt an:

UiPath.Constants.Project.Location+"InputData\Employee.txt"

Hinweis:: Die Konstante darf nicht in Invoke Workflow File-Aktivitäten in Bibliotheken verwendet werden.
Um auf einen Speicherort im Projektordner zu verweisen, an dem eine Bibliothek installiert ist, übergeben Sie den Pfad zur Bibliothek als Argument.

Hinzufügen wiederverwendbarer Komponenten zu Automationsprojekten

Öffnen oder Erstellen eines neuen Projekts.
Wählen Sie unter der Kategorie Alle Pakete (All Packages) den Feed, unter dem die Bibliothek gespeichert ist, und installieren Sie das Paket.
Klicken Sie auf OK. Das Paket wird zur Projektdefinition hinzugefügt.
Die Aktivität befindet sich in der benutzerdefinierten Kategorie des Panels Aktivitäten.

Hinweise zum Installieren von Bibliotheken in Projekten

Bibliotheken mit der plattformübergreifenden Kompatibilität können in plattformübergreifenden und Windows-Projekten installiert werden. „Windows – Legacy“- und „Windows“-Bibliotheken können nur in Prozessen mit derselben Kompatibilität installiert werden.
Fehler können auftreten, wenn Sie ein Projekt ausführen, das benutzerdefinierte Aktivitäten aus einer Bibliothek enthält, die in einer älteren Version von Studio als 2019.10.1 erstellt und mit einer neueren Version als 2019.10.1 veröffentlicht wurde. In diesem Szenario müssen Sie die Bibliothek neu erstellen und erneut veröffentlichen.
Wenn Sie Workflows importieren verwenden, um einen Workflow hinzuzufügen, der eine Bibliothek in einem Bibliotheksprojekt enthält, werden die in der Bibliothek referenzierten Abhängigkeiten nicht importiert.
Beim Importieren von zwei Versionen derselben benutzerdefinierten Bibliothek in ein Projekt sind die zusätzlichen benutzerdefinierten Aktivitäten, die nur in der zweiten Bibliothek enthalten sind, im Panel Aktivitäten nur sichtbar, wenn Sie die erste importierte Bibliothek entfernen.
Durch die Verwendung von Punkten (.) im Bibliotheksnamen wird die Bibliothek bei der Anzeige im Aktivitätenbereich in geschachtelte Gruppen aufgeteilt.