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. Tragen Sie den Namen ein und suchen Sie einen Ort für die Bibliothek aus. Der Standardort ist C:\Users\<current_user>\Documents\UiPath. Fügen Sie eine Beschreibung hinzu und wählen Sie Erstellen (Create). Die neue Bibliothek wird erstellt und auf Ihrem lokalen Computer gespeichert.

Hinweis: Der Bibliothekname darf nicht länger als 128 Zeichen und die Beschreibung nicht länger als 500 Zeichen sein.

1. 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 ist. Wenn Sie eine bestimmte Datei als privat festlegen möchten, klicken Sie mit der rechten Maustaste darauf, und wählen Sie Bei Veröffentlichung ignorieren aus. In diesem Fall ist die Datei im Bibliothekspaket enthalten, aber sie ist nicht als wiederverwendbare Komponente im Aktivitäten-Panel 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 zu Aktivitätseigenschaften in den Projekten, in denen die Bibliothek als Abhängigkeit installiert ist. Anmerkungen, die Sie einem Argument in der Bibliothek hinzufügen, werden für die Eigenschaft als QuickInfo 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.
• Quellen einschließen – Wählen Sie Ja aus, um alle .xaml-Quellen in der generierten Assembly-Datei zu verpacken, einschließlich Workflows, die zuvor als privat festgelegt wurden. Bei Bedarf können Sie dann die Assembly-Datei dekompilieren und die Workflows extrahieren, was während des Debuggens hilfreich sein kann.
• 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.
• Bereit zur Ausführung – Wählen Sie Ja aus, um die generierten Assemblys für die schnellere JIT-Kompilierung zur Laufzeit zu optimieren.
• 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.
• Bibliotheken, die Invoke Workflow File-Aktivitäten enthalten und bei denen die Option Isolated aktiviert ist, können nicht veröffentlicht werden. Im Ausgabebereich wird eine Fehlermeldung eingeblendet.
• 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.

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

   • Bibliotheken sind vorwärtskompatibel. Das bedeutet, dass sie nur mit Projekten verwendet werden können, die mit Studioversionen ab v2018.3 erstellt wurden. Bibliotheken können nicht mit Orchestrator-Versionen vor 2018.3 veröffentlicht 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.

Bitte beachten Sie, dass die in der Bibliothek referenzierten Abhängigkeiten nicht importiert werden, wenn Sie mit Workflows importieren (Import Workflows) einen Workflow hinzufügen, der eine Bibliothek enthält.

Beim Importieren von zwei Versionen derselben benutzerdefinierten Bibliothek in ein Projekt in Studio sind die zusätzlichen benutzerdefinierten Aktivitäten, die nur in der zweiten Bibliothek enthalten sind, im Bedienfeld Aktivitäten nur sichtbar, wenn Sie die erste importierte Bibliothek entfernen.