Studio-Benutzerhandbuch

Letzte Aktualisierung 17. Dez. 2024

Über die Veröffentlichung von Automatisierungsprojekten

Veröffentlichen eines Automatisierungsprojekts bedeutet, den Projektordner zu archivieren, damit er an Roboter gesendet und dann ausgeführt werden kann.

Standardmäßig werden alle Dateien im Projektordner mit Ausnahme von Testfällen veröffentlicht. Wenn Sie verhindern möchten, dass eine bestimmte Datei in das veröffentlichte Paket aufgenommen wird, klicken Sie im Projekt-Panel mit der rechten Maustaste darauf und wählen Sie dann Bei Veröffentlichung ignorieren aus (nicht für Workflowdateien in Bibliotheksprojekten verfügbar). Um zu verhindern, dass eine Workflowdatei als wiederverwendbare Komponente im Panel Aktivitäten angezeigt wird, wenn die veröffentlichte Bibliothek in einem Projekt installiert wird, klicken Sie im Projekt-Panel mit der rechten Maustaste darauf und wählen Sie dann Als privat festlegen aus.

Sie können Automatisierungsprojekte in Orchestrator, einem benutzerdefinierten NuGet-Feed oder lokal veröffentlichen. Nach der Veröffentlichung an Orchestrator wird das archivierte Projekt auf der Seite Pakete angezeigt und Sie können einen Prozess erstellen, der an Roboter verteilt werden soll. Wenn Sie einen Automatisierungsprozess im persönlichen Arbeitsbereich von Orchestrator veröffentlichen oder Testfälle veröffentlichen, wird ein Prozess automatisch erstellt, wenn er noch nicht vorhanden ist, und vorhandene Prozesse werden automatisch auf die neueste veröffentlichte Version aktualisiert.

Außerdem können Automationsprojekte in einem benutzerdefinierten NuGet-Feed veröffentlicht werden, mit der Option, auch einen API-Schlüssel hinzuzufügen, wenn der Feed Authentifizierung erfordert.

Wenn Sie Projekte lokal veröffentlichen, müssen Sie einen Pfad auf dem lokalen Computer angeben, der von dem Ort abweicht, an dem Prozesspakete veröffentlicht werden. Von hier aus können Sie die Pakete später manuell an die Roboter versenden, damit sie ausgeführt werden können. Der Standardort für die Veröffentlichung ist %ProgramData%\UiPath\Packages.

Um ein Projekt zu veröffentlichen, dürfen sich die Dateien project.json und design.json im Projektordner nicht an einem schreibgeschützten Speicherort befinden (wenn sich das Projekt beispielsweise in der Source Control befindet, müssen die Dateien zur Bearbeitung ausgecheckt werden).

Sie können Projekte über Studio oder über die Befehlszeile veröffentlichen. Um Abhängigkeiten für mehrere Projekte zu aktualisieren und sie alle gleichzeitig zu veröffentlichen, verwenden Sie das Massenaktualisierungstool für Projektabhängigkeiten.

Hinweis: Andere Softwareanwendungen können den Veröffentlichungsprozess beeinträchtigen, wenn Ordner, die mit einem Punkt (.) beginnen, ausgeblendet sind und daher bei der Veröffentlichung ignoriert werden.

Veröffentlichen von Projekten aus Studio

Um ein Projekt zu veröffentlichen, wählen Sie Veröffentlichen in der Registerkarte Design des Menübands von Studio aus.

Um ein Automatisierungsprojekt zu veröffentlichen:

Erstellen Sie in Studio ein neues Projekt.
Klicken Sie auf der Menübandregisterkarte Design auf Veröffentlichen. Das Fenster Veröffentlichen wird geöffnet. Beachten Sie, dass sich die Titelleiste des Fensters je nach Kontext ändert:
- Prozess veröffentlichen beim Veröffentlichen eines Prozesses;
- Bibliothek veröffentlichen beim Veröffentlichen eines Bibliotheksprojekts;
- UI-Bibliothek veröffentlichen beim Veröffentlichen eines UI-Bibliotheksprojekts;
- Testfälle veröffentlichen beim Veröffentlichen von Testfällen.
- Veröffentlichen von Vorlagen beim Veröffentlichen von Vorlagen.
Auf der Registerkarte Paketeigenschaften:
- Geben Sie einen Namen für das Paket ein. Die Dropdownliste enthält bis zu 5 der neuesten Namen von Paketen, die Sie zuvor veröffentlicht haben.
- Überprüfen Sie im Abschnitt Version die aktuelle Version Ihres Projekts, und geben Sie bei Bedarf eine neue Version ein. Aktivieren Sie das Kontrollkästchen Ist Vorabversion, um die Version als alpha zu markieren. Bitte beachten Sie, dass dadurch automatisch das Versionsschema des Projekts in semantisch geändert wird. Stellen Sie beim lokalen Veröffentlichen einer neuen Version der Datei sicher, dass der benutzerdefinierte Speicherort nicht bereits eine Datei mit derselben vorgeschlagenen Versionsnummer enthält. Weitere Informationen zur Projektversionierung finden Sie auf der Seite Über Automatisierungsprojekte.
- Verwenden Sie optional die Projektsymbol-Option, um ein benutzerdefiniertes Symbol für das Projekt zu definieren. Sie können nach einer Datei suchen und diese auswählen oder einen Pfad oder eine öffentliche URL zu einer jpeg-, jpg- oder png-Datei mit einer Größe von maximal 1 MB eingeben.
  
  Nachdem das Projekt veröffentlicht wurde, wird das Symbol wie folgt angezeigt:
  - Bei Prozessen im Assistant neben dem Prozessnamen, sodass sie in der Liste der Prozesse leichter identifiziert werden können.
  - Für Vorlagen neben der Vorlage in Start (Studio Backstage View) > Vorlagen.
  - Für Bibliotheken neben dem Paket im Fenster Pakete verwalten in Studio.
    
    Hinweis: Das Symbol ist in „Pakete verwalten“ nicht sichtbar, wenn eine lokale Datei für eine Bibliothek verwendet wird, die im Orchestrator oder in einem Feed veröffentlicht wurde, der keine eingebetteten Symbole unterstützt. In diesem Fall geben Sie das Symbol mithilfe eine URL an.
- Sie können im Projekt-Tags-Feld ein oder mehrere Tags zum Projekt hinzufügen, indem Sie entweder neue erstellen oder bereits im Orchestrator definierte Tags wiederverwenden. Es gibt zwei Arten von Tags: Beschriftungen und Eigenschaften (Schlüssel-Wert-Paare). Tags sind im veröffentlichten Paket enthalten und helfen bei der Beschreibung und Kategorisierung von Projekten. Sie können beispielsweise auf die automatisierte Anwendung (eine Excel-Beschriftung) oder die Abteilung (eine department:accounting-Schlüssel-Wert-Eigenschaft) verweisen.
  
  Wenn Sie mit der Eingabe beginnen, werden mögliche Übereinstimmungen aus bereits definierten Tags vorgeschlagen, und Sie können eines wiederverwenden, indem Sie es aus der Liste der Übereinstimmungen auswählen. Bei einer Eigenschaftsübereinstimmung wird zuerst der Schlüssel gefolgt von einem Doppelpunkt : angezeigt, und die zugehörigen Werte werden angezeigt, nachdem Sie den Schlüssel ausgewählt haben. Um ein neues Tag hinzuzufügen, klicken Sie nach der Eingabe des Namens auf den Eintrag mit dem Pluszeichen neben dem Namen. Trennen Sie Strings mit einem Doppelpunkt :, um Eigenschaften hinzuzufügen. Verwenden Sie keinen Doppelpunkt : bei den Einträgen, um Beschriftungen hinzuzufügen.
  
  Beschriftungen und Schlüssel-Wert-Eigenschaften sind auf 256 Zeichen begrenzt. Tag-Namen dürfen diese Zeichen nicht enthalten: <, >, %, &, \, ?, /, :.
  
  Projekt-Tags können automatisch auf Prozesse im Orchestrator angewendet werden. Weitere Informationen zur Verwendung von Tags finden Sie unter Organisieren von Ressourcen mit Tags im Orchestrator-Handbuch.
- Geben Sie im Textfeld Versionshinweise Details über die Version und andere relevante Informationen ein. Versionshinweise für veröffentlichte Projekte sind im Abschnitt Pakete in Orchestrator sichtbar. Beachten Sie, dass das Feld „Versionshinweise“ maximal 10.000 Zeichen enthalten kann.
Klicken Sie auf Weiter.

Wenn Sie eine Vorlage veröffentlichen, wird die Registerkarte Vorlageninformationen als nächstes geöffnet (Schritt 5). Fahren Sie andernfalls mit Schritt 6 fort.
(Nur für Vorlagen) Geben Sie auf der Registerkarte Vorlageninformationen die folgenden Informationen an und klicken Sie dann auf Weiter:
- Name – Der Name der Vorlage.
- Beschreibung - Die Vorlagenbeschreibung auf der Registerkarte Vorlagen.
- Standardprojektname - Der Standardprojektname beim Erstellen eines neuen Projekts mit dieser Vorlage.
  
  Hinweis: Vermeiden Sie die Verwendung von Interpunktionszeichen, Trennzeichen und Zeichen, die in Dateinamen nicht zulässig sind. Diese Zeichen können beim Verwenden der Vorlage aus dem Standardnamen entfernt werden.
- Standardprojektname - Die Standardbeschreibung beim Erstellen eines neuen Projekts mit dieser Vorlage.
Wählen Sie auf der Registerkarte Veröffentlichungsoptionen aus, wo das Projekt veröffentlicht werden soll. Die verfügbaren Optionen hängen vom Typ des Projekts ab, das Sie veröffentlichen:
- Für Prozesse (einschließlich StudioX-Projekte):
  - Orchestrator-Feed für Mandantenprozesse, Orchestrator-Feed für persönlichen Arbeitsbereich und, falls ein Ordner auf höchster Ebene mit einem separaten Paket-Feed oder einer in der Studio-Statusleiste ein Unterordner aus dem Ordnermenü ausgewählt ist, der Feed für diese Ordnerhierarchie. Diese Optionen stehen zur Verfügung, wenn Studio mit dem Orchestrator verbunden ist. Der Orchestrator-Feed für persönlichen Arbeitsbereich ist nur verfügbar, wenn bei Ihrem Benutzer die Funktion Persönlicher Arbeitsbereich im Orchestrator aktiviert ist.
    
    Wenn in Studio der persönliche Arbeitsbereich oder ein Ordner aus einer Hierarchie mit einem separaten Paket-Feed ausgewählt wird, ist der Feed für diesen Ordner die Standardoption. Andernfalls ist der Mandanten-Feed die Standardoption. Wenn Sie bereits ein Projekt in der aktuellen Sitzung veröffentlicht haben, dann ist der zuletzt verwendete Veröffentlichungsort die Standardauswahl, bis Sie Studio schließen oder den Orchestrator-Ordner in der Studio-Statusleiste ändern.
  - Assistent (Roboterstandards): der Standardpaketspeicherort für den Roboter und Assistenten, C:\ProgramData\UiPath\Packages. Die hier veröffentlichten Projekte werden automatisch im Assistenten angezeigt. Die Option ist nicht verfügbar, wenn Studio mit Orchestrator verbunden ist.
  - Benutzerdefiniert: entweder eine benutzerdefinierte NuGet-Feed-URL oder ein lokaler Ordner. Das Hinzufügen eines API-Schlüssels ist optional.
- Für Testfälle:
  - Die gleichen Optionen, die für Prozesse verfügbar sind, mit Ausnahme des Orchestrator-Feeds für den persönlichen Arbeitsbereich.
- Für Bibliotheken und UI-Bibliotheken:
  - Orchestrator-Feed für Mandantenbibliotheken oder Orchestrator-Feed für gemeinsam verwendete Bibliotheken – Verfügbar wenn Studio mit Orchestrator verbunden ist. Die verfügbare Option hängt davon ab, ob der Mandantenbibliotheksfeed in Orchestrator aktiviert ist.
  - Benutzerdefiniert: entweder eine benutzerdefinierte NuGet-Feed-URL oder ein lokaler Ordner. Das Hinzufügen eines API-Schlüssels ist optional.
- Für Vorlagen:
  - Orchestrator-Feed für Mandantenbibliotheken oder Orchestrator-Feed für gemeinsam verwendete Bibliotheken – Verfügbar wenn Studio mit Orchestrator verbunden ist. Die verfügbare Option hängt davon ab, ob der Mandantenbibliotheksfeed in Orchestrator aktiviert ist.
  - Lokal: der Speicherort für die lokale Veröffentlichung von Vorlagen, standardmäßig: C:\Users\User\Documents\UiPath\.templates.
  - Benutzerdefiniert: entweder eine benutzerdefinierte NuGet-Feed-URL oder ein lokaler Ordner. Das Hinzufügen eines API-Schlüssels ist optional.
Wenn Sie eine Bibliothek oder ein beliebiges Projekt mit Windows- oder plattformübergreifender Kompatibilität veröffentlichen, mit Ausnahme von Vorlagen, sind zusätzliche Einstellungen auf der Registerkarte Veröffentlichungsoptionen unter Kompilierungseinstellungen verfügbar:
- (Nur für Bibliotheken) Stammkategorie von Aktivitäten –- Geben Sie einen Namen für die Kategorie ein, unter der die wiederverwendbare Komponente im Bedienfeld Aktivitäten aufgeführt wird.
- (Nur für Windows-Legacy-Bibliotheken) Aktivitätsausdrücke kompilieren – Wählen Sie diese Option aus, um alle Aktivitätsausdrücke zu kompilieren und zu verpacken. Dies beschleunigt die Ausführung.
- (Nur für Windows-Legacy-Bibliotheken) Bereit zur Ausführung – Wählen Sie diese Option aus, um die generierten Assemblys für die schnellere JIT-Kompilierung zur Laufzeit zu optimieren.
  
  Hinweis: Um herauszufinden, was eine erfolgreiche Veröffentlichung einer Bibliothek verhindern könnte, lesen Sie mehr über die Einschränkungen beim Veröffentlichen von Bibliotheken.
Klicken Sie auf Weiter, um zur Registerkarte Zertifikatsignatur zu wechseln, oder auf Veröffentlichen,, um Ihr Projekt zu veröffentlichen.
(Optional) Fügen Sie auf der Registerkarte Zertifikatsignatur neben dem Feld Zertifikat einen lokalen Zertifikatpfad hinzu. Fügen Sie außerdem das Zertifikatpasswort und bei Bedarf einen optionalen Zertifikatzeitstempel hinzu. Weitere Einzelheiten finden Sie auf der Seite Signieren von Paketen.

Hinweis: Derzeit werden die Zertifikatserweiterungen .pfx und .p12 zum Signieren von Projekten akzeptiert.
Klicken Sie auf Veröffentlichen. Eine NUPKG-Datei wird erstellt und in den Orchestrator oder in den benutzerdefinierten NuGet-Feed hochgeladen oder im lokalen Verzeichnis gespeichert. Bei Bibliotheken werden zwei Runtime-Dateien erstellt, wenn die Projekteinstellungsoption Runtime-Abhängigkeiten trennen aktiviert ist: eine Datei ist das Entwurfszeitpaket, das in Studio verwendet wird, und die andere Datei ist das Runtime-Paket, das vom Roboter beim Ausführen der Automatisierung verwendet wird. Je nach Projekt enthält das Paket:
- Bei Vorlagenprojekten und -prozessen mit „Windows – Legacy“-Kompatibilität: die Projektquelldateien.
- Bei Bibliotheken und Projekten mit der Windows- oder plattformübergreifenden Kompatibilität werden kompilierte DLL-Dateien erstellt.
Wenn das Projekt erfolgreich veröffentlicht wurde, wird das Dialogfeld Info angezeigt und das Projekt an den NuGet-Speicherort kopiert, der im Parameter NuGetServerUrl in der Datei UiPath.settings festgelegt wurde.

Das Dialogfenster Info zeigt:

Der Name, unter dem das Paket veröffentlicht wurde.
Die Versionsnummer, unter welcher das Paket veröffentlicht wurde.
Der Speicherort, an dem das Projekt veröffentlicht wurde, wenn das Projekt lokal oder im Standardwert des Roboters veröffentlicht wurde. Klicken Sie auf den Pfad, um zum Paket zu wechseln, es sei denn, der Veröffentlichungsort war Orchestrator.
Die Option Details, die eine Liste mit den Namen der Projektdateien erweitert, die veröffentlicht wurden.
Die Option In Zwischenablage kopieren (Copy to Clipboard)

Während der Veröffentlichung hinzugefügte Informationen, wie z. B. der Veröffentlichungsort, werden im Fenster beibehalten, sodass sie für nachfolgende Veröffentlichungsaktionen verwendet werden können, die für denselben Projekttyp ausgeführt werden. Jedes Mal, wenn Sie auf Veröffentlichen klicken, wird eine neue Version des Projekts erstellt und an den Paketfeed gesendet. Die Veröffentlichung in einem sicheren Feed kann entweder über den Roboterschlüssel, die Orchestrator-Anmeldeinformationen, die Windows-Authentifizierung oder den API-Schlüssel authentifiziert werden.

Wichtig: Veröffentlichte Projekte dürfen nicht entpackt werden. Um Änderungen vorzunehmen, öffnen Sie die erste .xaml-Datei in Studio, führen die Änderungen aus und veröffentlichen das Projekt dann erneut.

Veröffentlichen von Projekten über die Befehlszeile

Sie können Projekte mit dem Veröffentlichungsbefehl UiPath.Studio.CommandLine.exe veröffentlichen.

UiPath.Studio.CommandLine.exe ist im Installationsordner verfügbar:

Bei Installationen pro Maschine ist der Standardpfad C:\Programme\UiPath\Studio\.
Bei Installationen pro Benutzer ist der Standardpfad %localappdata%\Programs\UiPath\Studio\.

Die folgenden Argumente sind für den Veröffentlichungsbefehl möglich:

Argument	Beschreibung
-p, --project-path	Der Pfad zum project.json, das veröffentlicht werden soll. Das Argument ist obligatorisch.
-g, --target	Wo das Projekt veröffentlicht werden soll: Benutzerdefiniert – Benutzerdefinierte URL oder lokaler Ordner. Definieren Sie den Speicherort mit dem Argument „-f, --feed“. Roboter – Standardveröffentlichungsort für den Roboter, wenn er nicht mit dem Orchestrator verbunden ist. Nicht verfügbar für die Veröffentlichung von Bibliotheken oder Vorlagen. OrchestratorTenant – Orchestrator-Feed für Mandantenprozesse (für Prozesse und Testfälle) oder Orchestrator-Bibliotheksfeed (für Bibliotheken und Vorlagen). OrchestratorPersonalFolder – Orchestrator-Feed des persönlichen Arbeitsbereichs Nicht verfügbar zum Veröffentlichen von Bibliotheken, Vorlagen oder Testfällen. OrchestratorFolderHierarchy – Wenn ein Ordner der obersten Ebene mit einem separaten Paketfeed oder einem seiner Unterordner in der Statusleiste von Studio aus dem Ordnermenü ausgewählt wird, wird der Feed für diese Ordnerhierarchie angezeigt. Nicht verfügbar zum Veröffentlichen von Bibliotheken oder Vorlagen.
-f, --feed	Die benutzerdefinierte URL für die Veröffentlichung des Projekts. Dies kann auch ein benutzerdefiniertes lokales Verzeichnis sein, ähnlich dem Pfad auf der Registerkarte Veröffentlichungsoptionen in Studio.
-a, --api-key	Der API-Schlüssel zum Veröffentlichen des Projekts. Dieses Argument kann für ein benutzerdefiniertes Ziel verwendet werden.
-i, --icon	Pfad zum benutzerdefinierten Symbol, das für das Paket verwendet werden soll.
-n, --notes	Versionshinweise, die Änderungen am Projekt enthalten.
-v, --new-version	Die neue Version für das Projekt. Wenn nicht angegeben, wird die Version automatisch erhöht.
-t, --timeout	Legt den Timeout-Wert für die Veröffentlichung von Projekten fest. Das Standard-Timeout beträgt 30 Sekunden.
--cer-path	Der lokale Pfad zum Zertifikat für das Signieren von Paketen.
--cer-password	Das Passwort für das Zertifikat.
--timestamper-url	Die URL zum Zeitstempel.
--incl-all-feeds	Nicht erforderlich.
––Hilfe	Die für jeden Befehl verfügbaren Argumente anzeigen.
––Version	Überprüfen Sie die Version von UiPath.Studio.CommandLine.exe.

Zum Beispiel:

Der folgende Befehl veröffentlicht den Beispielprozess im Orchestrator-Feed der Mandantenprozesse:

UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json" --target OrchestratorTenant --notes "Fixed a couple of bugs."
Der folgende Befehl veröffentlicht denselben Prozess in einem lokalen Ordner:

UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json" --target Custom --feed "C:\Users\username\Desktop\myfeed" --notes "Fixed a couple of bugs."

Weitere Informationen zum Dienstprogramm CommandLine.exe finden Sie unter Massenhafte Aktualisierung von Befehlszeilenparametern.

Auf dieser Seite