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

1. 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.
2. 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.
3. 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: Per Standard sind die Abhängigkeiten, die für neue Bibliotheken zur Verfügung stehen, dieselben wie für neue leere Projekte, nämlich UiPath.Excel.Activities, UiPath.Mail.Activities, UiPath.System.Activities und UiPath.UIAutomation.Activities, mit der Ausführungszeitregel Niedrigste anwendbare Version (Lowest Applicable Version).

Um eine QuickInfo und einen Hilfelink zu einer Aktivität hinzuzufügen, klicken Sie mit der rechten Maustaste auf die Workflowdatei im Projekt-Panel und wählen Sie Eigenschaften aus. Die QuickInfo ist sichtbar, wenn Sie den Mauszeiger über die Aktivität in den Panels Aktivitäten und Designer in Projekten bewegen, in denen die Bibliothek installiert ist. Der Hilfelink wird geöffnet, wenn Sie die Aktivität im Designer-Panel auswählen und F1 drücken.

Argumente, die Sie in der Bibliothek definieren, werden in den Projekten zu Aktivitätseigenschaften, in denen die Bibliothek als Abhängigkeit installiert wird. Argumente, die als erforderlich markiert sind, sind im Textkörper der Aktivität im Designer-Panel verfügbar. Anmerkungen, die Sie einem Argument in der Bibliothek hinzufügen, werden als QuickInfo für die Eigenschaft im Eigenschaften-Panel der resultierenden Aktivität angezeigt. Weitere Informationen zu Argumenten finden Sie im Argumente-Panel.

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.

• Quellen einschließen – Wählen Sie Ja aus, um alle .xaml-Quellen im Bibliothekspaket einzuschließen, einschließlich Workflows, die zuvor privat waren. Für Windows – Legacy-Bibliotheken werden die Dateien in der generierten Assembly-Datei und im Ordner lib\net45 in der .nupkg-Datei gespeichert. Für Windows- und plattformübergreifende Bibliotheken werden die Dateien im content-Ordner in der .nupkg-Datei gespeichert.
• 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.

Einschränkungen bei öffentlichen Bibliotheken

Berücksichtigen Sie beim Veröffentlichen 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, werden Pfade, die Umgebungsvariablen enthalten, als Pfade relativ zum Bibliotheksordner interpretiert, wenn die Komponente in einem Projekt verwendet wird. Verwenden Sie als Problemumgehung entweder die Methode Environment.GetEnvironmentVariable oder eine Get Environment Folder-Aktivität, um den Ordnerpfad abzurufen, und verwenden Sie dann die Ausgabe, um einen absoluten Pfad zu konstruieren, der an die wiederverwendbare Komponente übergeben wird.
• Wenn eine Workflow-Datei, die sich in einem Ordner in einer Bibliothek befindet, als Namespace in einem Projekt verwendet wird, führt das Ändern des Ordnernamens, das erneute Veröffentlichen und das Installieren der aktualisierten Bibliothek im Projekt zu unbekannten Aktivitäten.

Hinzufügen wiederverwendbarer Komponenten zu Automationsprojekten

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

Hinweise zum Installieren von Bibliotheken in Projekten

• Bibliotheken können nur in Projekten installiert werden, die dieselbe Kompatibilität haben.
• Wenn eine plattformübergreifende Bibliothek einen Workflow mit UI-Automatisierungsaktivitäten enthält, führt das Hinzufügen der generierten Aktivität in einem plattformübergreifenden Projekt zu einem Validierungsfehler, wenn das Projekt ausgeführt wird.
• 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.