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 aus dem Paketmanager installiert werden.

Sie können beispielsweise eine Bibliothek erstellen, die Daten aus einer Excel-Tabelle erfasst und an eine andere anfügt, wie auf der Seite Erstellen einer Basisbibliothek erläutert. Als nächstes kann die Bibliothek gepackt 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 Bibliotheksname darf 128 Zeichen nicht überschreiten, und die Beschreibung darf 500 Zeichen nicht überschreiten.* Verwenden Sie nicht libals Bibliotheksnamen, da dies in Projekten, in denen die Bibliothek installiert ist, zu einem Fehler bei der Kompilierung führt.
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:

   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.

1. Öffnen Sie ein Projekt in Studio.

2. Wählen Sie im Menüband Entwurf die Option Exportieren als und dann Bibliothek aus.

   

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

   

4. Konfigurieren Sie die folgenden Extraktionsoptionen:

   • Include Test Cases: By default, this option is enabled for a Process project and disabled for a Test Automation project. You should enable this option if you want to include test cases as part of the extracted library.
   • Publish and install the library: Automatically selected to publish the package to a shared feed and install the library as a project dependency. You can disable this option if you want to create the library without publishing it. If disabled, the remainder options are not available for configuration.
   • 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.
     • Select Replace invoked workflows content to change the workflows invoked from entry point, or test cases with corresponding activities from the extracted library.
     • 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 durch Aktivitäten aus der extrahierten Bibliothek zu ändern.
       Hinweis:

       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.

5. Klicken Sie auf Exportieren, um die Bibliotheksoptionen zu bestätigen.

   

6. Klicken Sie auf Erstellen, um die Erstellung der Bibliothek abzuschließen.

   

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

   In case you didn't enable the Publish and install the library option, you'll be prompted to open the library or continue with the current project.

   

   Wichtig:

   Das Ersetzen von Workflows oder aufgerufenen Aktivitäten aus der extrahierten Bibliothek erfolgt nicht für Workflows, bei denen Mock-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.Der Anzeigename sollte nicht geändert werden, wenn die Bibliothek in einem Projekt verwendet wird.
• Tooltip - The tooltip that is visible when you hover over the activity in the Activities and Designer panels in projects where the library is installed.
• Help Link - The help link that opens when you select the activity in the Designer panel and press F1 on your keyboard.
• SVG Icon - The SVG icon to display next to the activity name.
  Hinweis:

  Das Symbol ist in Pakete verwalten nicht sichtbar, wenn eine lokale Datei für eine Bibliothek verwendet wird, die im Orchestrator veröffentlicht wurde, oder für einen Feed, der keine eingebetteten Symbole unterstützt. Geben Sie in diesem Fall das Symbol mithilfe einer URL an.

• Color - The highlight color displayed for the activity in the Designer panel.

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.
  • Tooltip - The tooltip that is visible when you hover over the activity property.
  • Input Type - The type of input for the property. You can use the default input for the property type or select an input option depending on the type:
    • 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.
  • Placeholder - The placeholder text to display for the input when no value is selected.
  • 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

Select Activity Properties in the left-side menu and enter the following:

• Tooltip - The tooltip that is visible when you hover over the activity in the Activities and Designer panels in projects where the library is installed.
• Help Link - The help link that opens when you select the activity in the Designer panel and press F1 on your keyboard.

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.
  • Tooltip - The tooltip that is visible when you hover over the activity property.
  • 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 Falle von Bibliotheken wird empfohlen, Nothingeiner Variable einen Null-Wert zuzuweisen, anstatt dies anders zu tun"".Dadurch werden Inkonsistenzen bei der Verwendung der verpackten Bibliothek als Abhängigkeit für ein Projekt vermieden.* Die Eigenschaft ImplementationVersion des System.Activities.ActivityBuilderObject 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 Informationen zur Automatisierung und Veröffentlichung von Projekten.Im Gegensatz zu Processes werden beim Veröffentlichen einer Bibliothek zwei NUPKG-Dateien erstellt – ein Designzeitpaket und ein runtime-Paket.Dies gilt nur für Windows und plattformübergreifende Bibliotheken, wenn die Option Separate Runtime-Abhängigkeiten-Projekteinstellungen 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.
• Ab Studio 2023.10.0 erfolgt die Trennung zwischen Designzeit- und Laufzeitpaketen nur, wenn:
  • Während des Kompilierungsprozesses wird eine ViewModels.dll-Datei generiert. Die ViewModels.dll-Datei wird für Windows- und plattformübergreifende Bibliotheken generiert, wenn die Eigenschaften der Viewmodel-Aktivität für mindestens eine Workflow-Datei in der Bibliothek konfiguriert werden.
  • Die Option Separate Runtime-Abhängigkeiten ist aktiviert.

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

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

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 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 installiert werden, die dieselbe Kompatibilität haben.
• 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.
• 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.