Informationen über Bibliotheken

A library is a project which contains one or more workflows that can be reused as activities in other projects. Libraries are saved as NUPKG files when published and can be installed as dependencies from the Package Manager.

For example, you could create a library that collects data from an Excel spreadsheet and appends it to another, as explained in the Creating a Basic Library page. Next, the library can be packaged and used in other processes as an activity.

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.

Arguments you define in the library become activity properties in the projects where the library is installed as a dependency. Arguments that are marked as required are available in the body of the activity in the Designer panel. Annotations you add to an argument in the library are displayed as a tooltip for the property in the resulting activity's Properties panel. For more information about arguments, see Arguments 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 Eigenschaftenbereich 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 auf Einstellungen klicken im Bereich Projekt .

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 of an Automation Hub idea linked to the project. For more information, see Linking a Project to an Idea in 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.

  After the project is published, the icon is displayed next to the package in the Manage Packages window in Studio.

• 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.

• Modern Design Experience - set to Yes to enable a modern experience of working with UI Automation, including new and improved activities, recorders, and wizards, as well as the Object Repository.

Veröffentlichen einer Bibliothek

Publishing libraries is similar to publishing processes. For more information, see About Publishing Automation Projects.

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 Windows-Legacy-Kompatibilität können nicht veröffentlicht werden, wenn sie Invoke Workflow-Dateiaktivitäten mit der ausgewählten Option Isoliert enthalten. Eine Fehlermeldung wird im Ausgabebereich angezeigt, wenn Sie versuchen, zu veröffentlichen.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 Interaktiv wird für Bibliotheken nicht unterstützt.
• Die Verwendung von Invoke Workflow-Datei in einer Bibliothek zum Verweisen auf die Bibliothek selbst wird nicht unterstützt.
• If a library contains an activity that accepts a file path as input, when the component is used in a project, paths that include environment variables are interpreted as paths relative to the library folder. As a workaround, use either the Environment.GetEnvironmentVariable method or a Get Environment Folder activity to retrieve the folder path, and then use the output to construct an absolute path to pass to the reusable component.
• 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

• Libraries can only be installed in projects that have the same compatibility.

• 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.

• Bei der Verwendung benutzerdefinierter Aktivitäten aus einer Bibliothek werden alle definierten Standardwerte für Argumente automatisch im Eigenschaftenbereich der Aktivität ausgefüllt, wenn die Aktivität dem Workflow hinzugefügt wird. Wenn Sie den Wert aus einem Eigenschaftsfeld im Workflow löschen, wird der entsprechende Standardwert während der Runtime nicht verwendet. In diesem Fall wird ein leerer Wert explizit übergeben.

  Im Gegensatz dazu führt bei Verwendung der Aktivität „Invoke Workflow“ ein leerer Eingabefeld im Bereich „Argumente importieren“ dazu, dass der Standardwert im aufgerufenen Workflow zur Runtime verwendet wird.