Moderne Ordner wurden eingeführt, um die Orchestrierung von Automatisierungen zu verbessern und zu vereinfachen und bieten mehrere Vorteile im Vergleich zu klassischen Ordnern.
In Classic folders vs modern folders you can read more about the differences between these types of folders.

📘

Klassische Ordner werden im Oktober 2022 eingestellt.

Klassische Ordner sind nicht mehr der Standard für die Verwaltung von Automatisierungen und wurden durch moderne Ordner ersetzt, eine bessere und funktionsreichere Alternative. Aus diesem Grund haben wir die Option zum Erstellen neuer klassischer Ordner bereits entfernt und werden klassische Ordner ab Oktober 2022 einstellen.

 

Um Sie beim Übergang zu modernen Ordnern zu unterstützen, können Sie den modernen Migrationsassistenten verwenden, um Ihre klassische Ordnerhierarchie und Entitäten in modernen Ordnern leicht wiederherzustellen, wobei alle Abhängigkeiten erhalten bleiben.

 

Überblick über den Migrationsprozess

---

Um Ihre aktuelle Bereitstellung ganz oder teilweise in moderne Ordner zu konvertieren, müssen einige Entitäten erneut bereitgestellt werden, während andere vollständig neu erstellt werden müssen.

Hier finden Sie einen Überblick über die Aufgaben des Migrationsassistenten während und nach der Migration:

• Erstellt jeden klassischen Ordner neu als modernen Ordner mit einem Namen im Format Migrated <folder name>.
• Erstellt für jede Umgebung einen entsprechenden Unterordner im modernen Zielordner. Wenn nur eine Umgebung vorhanden ist, werden keine Unterordner erstellt.
• Jeder Prozess wird in den modernen Ordner (oder Unterordner) verlagert, der seinem vorherigen Ordner oder seiner vorherigen Umgebung entspricht.
• Migriert Assets, Warteschlangen und Trigger aus jedem klassischen Ordner in den entsprechenden modernen Ordner.
• Migrates each Test Suite entity to the modern subfolder that corresponds to the classic folder environment it previously belonged to.
• Migriert Roboter und Benutzerkonten in die entsprechenden modernen Ordner:
  • Maps each classic attended robot to a user account and sets up each user account with personal automation settings (previously known as attended robot settings), and access to the corresponding modern folders and machines needed to run the attended automations that it ran in classic folders. Two scenarios can occur in terms of roles:
    • If the user account to which a classic attended robot is mapped was not assigned to the tenant at the moment the migration started, it is automatically included in the tenant and granted the Allow to be Automation User tenant-level role.
    • If the user account to which a classic attended robot is mapped was already assigned to the tenant, its roles do not change, so you need to manually grant it the Allow to be Automation User tenant-level role. This prevents automations from breaking.
  • Maps each classic unattended robot to robot accounts (recommended), unless configured otherwise, and sets up each robot account with access to the corresponding modern folders and machines needed to run the automations that the unattended robot ran in classic folders.
    Grants the Automation User folder-level role to existing robot accounts that are mapped to classic unattended robots.
    New, automatically-generated robot accounts receive the Automation User folder-level role and the Allow to be Automation User tenant-level role.
• Einige Benutzerlizenzen, die Attended-Funktionen enthalten, werden möglicherweise nach Abschluss der Migration verfügbar. Dies liegt daran, dass in modernen Ordnern jeder Benutzer nur eine Benutzerlizenz für persönliche Automatisierungen (zuvor Attended) benötigt. Wenn derselbe Benutzer über mehrere Lizenzen verfügt, behält er die übergeordnete Lizenz und die untergeordnete wird freigegeben.
  Wenn beispielsweise einer der Attended-Roboter des Benutzers eine Attended-Lizenz und ein anderer eine Citizen Developer-Lizenz verwendet hat, behält der Benutzer die Citizen Developer-Lizenz und die Attended-Lizenz wird freigegeben.

🚧

Manuelle Aktion erforderlich

Während der Assistent den Migrationsprozess für Sie erheblich vereinfachen kann, müssen Sie nach der Migration Aufgaben ausführen, damit Ihre Automatisierungen ordnungsgemäß ausgeführt werden können.
Stellen Sie sicher, dass Sie über die erforderlichen Kenntnisse verfügen und dass Sie Zeit für die Ausführung dieser Aufgaben einplanen, bevor Sie mit der Migration beginnen.

Änderungen an den Mandanteneinstellungen

Nach dem Ausführen des modernen Migrationsassistenten ändern sich einige Einstellungen auf Mandantenebene automatisch. Diese Änderungen sind für verwendete moderne Ordner erforderlich.

Die folgenden Änderungen gelten, nachdem alle klassischen Ordner erfolgreich migriert wurden:

• Interactive sign-in is enforced.
  Nach Abschluss der Migration müssen Benutzer ihre UiPath Studio- oder UiPath Assistant-Verbindungseinstellungen aktualisieren, um von der Verwendung eines Maschinenschlüssels zur interaktiven Anmeldung zu wechseln, um in modernen Ordnern arbeiten zu können.
• Klassische Ordner und ihre Entitäten können weiterhin verwendet werden.
  Sie können diese beibehalten, bis die Validierung abgeschlossen ist. Danach können Sie sie löschen.
• Account-machine mappings are enabled at the tenant level.

 

Voraussetzungen

---

Berechtigungen

• To be able to successfully run the Modern migration wizard, you must be an organization administrator.

• Um den modernen Migrationsassistenten öffnen zu können, benötigen Sie die folgenden Berechtigungen:

  • Rollen: Anzeigen, Erstellen und Bearbeiten
  • Einstellungen: Anzeigen und Bearbeiten
  • Benutzer: Anzeigen, Erstellen und Bearbeiten
  • Roboter: Anzeigen, Erstellen, Bearbeiten und Löschen
  • Einheiten: Erstellen und Bearbeiten.

Volumenbegrenzung

Der moderne Migrationsassistent ist nicht für große Bereitstellungen geeignet, die dedizierte Migrationstools und -strategien erfordern.

Wir empfehlen, den Migrationsassistenten nicht für Ordner zu verwenden, die mehr als 2.000 klassische Roboter enthalten. Dies kann zu Problemen bei der Leistung und zum Scheitern der Migration führen.

 

Schritt 1. Verwenden des modernen Migrationsassistenten

---

Vorbereiten der Migration

🚧

Es ist wichtig, dass Sie keine Konfigurationsänderungen an Ihrem klassischen Ordner-Setup vornehmen, bis die Migration abgeschlossen ist.
Bitte beschränken Sie die Überprüfungen und Änderungen vor der Migration auf die unten aufgeführten Punkte.

Bekanntes Problem

Nachdem Sie die Migration gestartet haben, können Sie Warteschlangentrigger in klassischen Ordnern nicht mehr bearbeiten. Bei Problemen, die die Bearbeitung eines Warteschlangentriggers erfordern würden, können Sie den fehlerhaften Warteschlangentrigger zwischen dem Beginn der Migration und dem erfolgreichen Abschluss der Migration nicht mehr verwenden.

Ein- und Ausschließen von Ordnern

Bevor Sie den Assistenten starten, fügen Sie sich selbst zu allen klassischen Ordnern hinzu, die Sie migrieren möchten.
Ordner, denen Sie nicht zugewiesen sind, werden nicht migriert.

Ein- und Ausschließen klassischer Roboter

Bevor Sie den Assistenten starten, überprüfen Sie, ob alle Roboter, die Sie migrieren möchten, einer Umgebung hinzugefügt wurden.
Bei klassischen Robotern, die nicht Teil einer Umgebung sind, wird davon ausgegangen, dass sie nicht verwendet werden und nicht für die Migration vorgesehen sind.

If a robot is not migrated, the asset robot values and process schedules for that robot are not migrated either, unless also used by another robot that is migrated.

Verhinderung von Berechtigungserhöhungen

Nach der Migration wird Attended Usern und Roboterkonten automatisch die Rolle Automation Users auf Ordnerebene zugewiesen (in dem entsprechenden Ordner, dem sie zum Zeitpunkt der Migration zugewiesen sind). Wenn Sie die Rollen auf Dienstebene oder die Lizenzzuweisungsregel für diese Gruppe angepasst haben, empfehlen wir Ihnen, alle erhöhten Rollen oder zusätzlichen Lizenzen aus dieser Gruppe zu entfernen, bevor Sie mit der Migration fortfahren.

Stellen Sie sicher, dass keine Aufträge ausgeführt werden.

Stellen Sie sicher, dass vor dem Starten der Migration keine Aufträge ausgeführt werden.
Wenn Sie Trigger haben, die während der Migration einen Auftrag starten würden, empfehlen wir Ihnen, diese zu deaktivieren und nach Abschluss der Migration wieder zu aktivieren.

Bevor Sie mit der Migration beginnen, können Sie den Auftragsstatus auf der Seite Ordner > Überwachung jedes klassischen Ordners überprüfen, der migriert werden soll.

When the migration starts, all jobs that are not in a final state are terminated. If a terminated job does not reach the stopped status by the time the migration concludes, the migration fails with a related error.

 

Verwenden des Assistenten

So migrieren Sie klassische Ordner zu modernen Ordnern für einen Mandanten:

1. Navigieren Sie zu Mandant > Einstellungen.
   Die Seite Einstellungen wird auf der Registerkarte Allgemein geöffnet.
2. Klicken Sie im Abschnitt Klassische Ordner auf Migration starten.
   Der Assistent für die moderne Migration wird im Schritt Erste Schritte geöffnet.
3. Überprüfen Sie die Informationen und klicken Sie im Abschnitt Zusammenfassung auf Die Zusammenfassung oben kopieren und speichern Sie diese Informationen für Ihren Datensatz.
   In der Zusammenfassung sind die Typen und die Anzahl der Entitäten aufgeführt, die für die Migration enthalten sind.
   Hinweise:
   • Nur die klassischen Ordner, auf die Sie Zugriff haben, sind für die Migration vorgesehen. Ordner, denen Sie nicht hinzugefügt wurden, werden nicht migriert.
   • Von klassischen Robotern, die keiner Umgebung hinzugefügt werden, wird angenommen, dass sie nicht verwendet werden und nicht für die Migration bestimmt sind.
4. Wenn Sie fertig sind, klicken Sie auf Weiter, um mit dem Schritt Attended Users fortzufahren.

Attended-Benutzer

Da wir in modernen Ordnern die Beziehung zwischen Benutzern und Robotern anders verwalten und den Roboter des Benutzers automatisch erstellen, müssen Sie jeden klassischen Attended-Roboter dem Konto des Benutzers zuordnen, der ihn verwendet.

Auf der Seite Attended-Benutzer werden alle Attended-Roboter aufgeführt, die in den klassischen Zielordnern gefunden wurden, und deren Details.
In der Spalte Zielbenutzerkonto müssen Sie für jeden gefundenen Attended-Roboter das Konto des Benutzers auswählen, der den Attended-Roboter verwendet, basierend auf den Informationen in den anderen Spalten.

If you do not set an account for a robot, that robot is not migrated. The processes associated with that robot will no longer be able to run.

5. Für jedes Zielkonto, das nicht korrekt oder nicht festgelegt ist, müssen Sie das Konto manuell festlegen:
   a. Klicken Sie in der Spalte Zielbenutzerkonto auf Zuweisen.
   b. Beginnen Sie im Feld Nach einem Benutzer suchen mit der Suche und wählen Sie dann den Benutzer aus den Ergebnissen aus.
   c. Klicken Sie unten rechts auf Speichern, um das Zielkonto festzulegen und zur vorherigen Seite zurückzukehren.
   Informationen zum Zuordnen von Robotern zu Benutzerkonten finden Sie unter Zuordnungsregeln für Attended-Roboter.
6. Wenn Sie fertig sind, klicken Sie auf Weiter, um zum Schritt Unattended-Benutzer zu gelangen.

 

Zuordnungsregeln für Attended-Roboter

Nachfolgend finden Sie die von uns verwendeten Regeln, um Ihre Auswahl zu überprüfen, wenn Sie versuchen, ihren Benutzern klassische Attended-Roboter zuzuordnen.

• Roboter mit demselben Benutzernamen (angezeigt auf der Seite Attended Users) müssen demselben Zielbenutzerkonto zugeordnet sein.
  In ähnlicher Weise müssen Roboter mit einem anderen Benutzernamenswert verschiedenen Zielbenutzerkonten zugeordnet werden.

• Wenn Sie eine Integration mit einem externen Benutzerverzeichnis haben, muss beim Zuordnen von Robotern zu Verzeichnisbenutzerkonten der Wert Benutzername des Roboters mit der E-Mail-Adresse oder dem Benutzernamen des Zielbenutzerkontos übereinstimmen.
  Sie können die E-Mail-Adresse und den Benutzernamen für ein Benutzerkonto auf der Seite Mandant > Zugriff verwalten > Rollen zuweisen anzeigen.

• Beim Zuordnen von Robotern zu lokalen Benutzerkonten:

  • Wenn die interaktive Anmeldung für den Mandanten erzwungen wird, können Sie jedem Benutzer einen beliebigen klassischen Roboter zuordnen.
  • If the tenant-level robot authentication setting is set to Hybrid and the target user account has personal automation enabled, the Username value for the robot must match user's Domain\Username value, as shown on the user's Personal automations setup page.
  • If the tenant-level robot authentication setting is set to Hybrid, the target user account has personal automation enabled, and the option Inherit license from user's group is set in user's Personal automations setup page, then the user has a generated personal automation username which is not shown, but is required to match the Username of the robot, otherwise mapping is not allowed.

When multiple attended robots are mapped to the same target account, the robot username in the modern folder will be one of the usernames of the migrated robots, at random. This can result in access problems when trying to connect to machines.

 

Unattended-Benutzer

For unattended robots, you must map them to new or existing robot accounts. Robot accounts are designed for running unattended automations and we recommend using them instead of user accounts.

Auf der Seite Unattended-Benutzer werden alle Unattended-Roboter aufgeführt, die in klassischen Ordnern gefunden wurden.

7. Wählen Sie oben rechts unter Massenaktionen aus, wie der Assistent klassische Unattended-Roboter behandeln soll, denen kein Ziel-Roboterkonto zugeordnet ist:
   • Empfohlen: Wählen Sie Roboterkonten automatisch generieren aus, wenn Sie alle aufgelisteten Unattended-Roboter migrieren und dem Assistenten erlauben möchten, neue Roboterkonten für sie zu erstellen.Details…
   • Nicht empfohlen: Wählen Sie Ignorieren aus, wenn Sie nur einige der gefundenen klassischen Roboter migrieren möchten.
8. Überprüfen Sie die Spalte Zielroboterkonto, um sicherzustellen, dass alle vorhandenen Zuordnungen korrekt sind.
   • Wenn Sie Roboterkonten automatisch generieren ausgewählt haben, überspringen Sie diesen Schritt.
   • Wenn Sie Ignorieren ausgewählt haben, müssen Sie nur die klassischen Unattended-Roboter manuell zuordnen, die Sie zu einem Zielroboterkonto migrieren möchten, indem Sie in der Spalte Zielroboterkonto auf Zuweisen klicken.Sie können zu diesem Zeitpunkt bei Bedarf auch neue Roboterkonten erstellen.
     Alle klassischen Roboter, die keinem Zielroboterkonto zugeordnet sind, werden nicht in moderne Ordner migriert.
9. Wenn Sie fertig sind, klicken Sie auf Weiter, um mit dem letzten Schritt fortzufahren.
   Die Seite Fertig stellen wird geöffnet.

 

Was die automatische Erstellung von Roboterkonten bewirkt

Wenn diese Option ausgewählt ist, versucht der Assistent zum Zeitpunkt der Migration, jeden klassischen Roboter wie folgt automatisch zuzuordnen:
i. Sucht nach einem vorhandenen Benutzer- oder Roboterkonto mit einem übereinstimmenden Unattended-Benutzernamen.
Wenn er gefunden wird, wird der Unattended-Roboter diesem vorhandenen Konto zugeordnet. Wenn keine Übereinstimmungen gefunden werden, wird mit dem nächsten Schritt fortgefahren.
ii. Sucht nach anderen klassischen Unattended-Robotern mit demselben Benutzernamen, die bereits einem Konto zugeordnet wurden.
Wenn er gefunden wird, ordnet er diesen Roboter demselben Konto zu. Wenn keine Übereinstimmungen gefunden werden, wird ein neues Roboterkonto für den klassischen Roboter erstellt.
Neue Roboterkonten, die vom Assistenten erstellt werden, haben einen Namen im Format Migrated folderName_robotName.

Zuordnungsregeln für Unattended-Roboter

Die folgenden Regeln gelten, wenn Sie versuchen, klassische Unattended-Roboter Roboter- oder Benutzerkonten zuzuordnen.
Wenn Sie sich dafür entscheiden, die Roboter manuell Roboterkonten zuzuordnen (nicht empfohlen), anstatt dem Assistenten zu erlauben, neue Roboterkonten zu erstellen, müssen Sie folgende Regeln beachten.

i. Sucht nach einem vorhandenen Roboterkonto, das dieselben Anmeldeinformationen wie der klassische Unattended-Roboter verwendet.
Wenn eine Übereinstimmung gefunden wird, erfordert der Assistent, dass Sie den klassischen Unattended-Roboter dem vorhandenen Roboterkonto zuordnen. Wenn nicht, geht es zum nächsten Schritt über.
ii. Sucht nach einem anderen klassischen Unattended-Roboter, der über dieselben Anmeldeinformationen wie der klassische Roboter verfügt, der zugeordnet werden soll. Wenn er gefunden und bereits einem Zielkonto zugeordnet wurde, verlangt der Assistent, dass Sie den aktuellen Roboter demselben Zielkonto zuordnen.

If you map multiple robots with different credentials to the same robot account, after migration the robot account uses the credentials of one of the classic robots, at random. There is a risk that these credentials do not work on all of the target machines and, after migration, can result in a failure to connect to machines.

 

Starten der Migration

10. Wenn Sie bereit sind, klicken Sie auf Migration ausführen, um den Prozess zu starten.
    Ein Bestätigungsdialogfeld wird geöffnet.
11. Klicken Sie auf Ausführen, um die Migration zu starten.
    Die Seite wird aktualisiert, um den Migrationsfortschritt für jeden Ordner anzuzeigen.
    Wenn Fehler auftreten, überprüfen Sie die angezeigten Fehlermeldungen. Nachdem Sie das Problem in jedem klassischen Ordner behoben haben, können Sie die Migration neu starten oder wiederholen.
12. Klicken Sie auf Schließen, um den Assistenten zu beenden.

Next steps: If migration was successful, continue with Post-migration setup.

 

Fehlersuche und ‑behebung

Aufträge sind noch nicht im Endzustand.

Zu Beginn der Migration beendet der Assistent automatisch alle laufenden Aufträge, damit die Migration durchgeführt werden kann. Wenn ein beendeter Auftrag zum Zeitpunkt des Abschlusses der Migration im Status „Beendet“ verbleibt und nicht den Status „Angehalten“ erreicht, schlägt die Migration fehl.

If this happens, after 24 hours, we automatically set Terminating jobs to Stopped status. At this point, you can restart the migration.

 

Neustarten oder Wiederholen der Migration

Wenn die Migration für einige oder alle Ordner fehlgeschlagen ist, können Sie es erneut versuchen, nachdem Sie die Fehlkonfigurationen, die zu Fehlern geführt haben, behoben haben.

So starten Sie eine fehlgeschlagene Migration neu oder wiederholen sie:

1. Überprüfen Sie die Fehlermeldungen für jeden Ordner und überprüfen Sie dann die klassische Ordnereinrichtung, um die Fehler zu beheben.
2. Nachdem Sie alle Fehler behoben haben, wechseln Sie zu Mandant > Einstellungen > Migration starten.
   Der Assistent wird auf der letzten Seite geöffnet.
3. So führen Sie die Migration erneut aus:
   • Wenn Sie die Migration mit Ihren vorherigen Einstellungen erneut ausführen möchten, klicken Sie auf das Symbol Wiederholen () rechts neben der Zeile eines Ordners, bei dem die Migration fehlgeschlagen ist.Mit dieser Option wird die Migration wieder so gestartet, wie sie zuvor eingerichtet wurde, ohne dass Sie die Möglichkeit haben, Zuordnungen zu ändern.
     (Optional) Aktivieren Sie das Kontrollkästchen Bereinigung vor Wiederholung, wenn Sie alle teilweise migrierten Daten für Ordner löschen möchten, für die die Migration fehlgeschlagen ist. Wenn Sie dieses Kontrollkästchen nicht aktivieren, wird die Migration nur für die Entitäten durchgeführt, die zuvor nicht migriert werden konnten.
     Tip: If the migration fails with an error for Test Data Queues or Test Data Queue items, select the Clean-up before retrying checkbox before restarting the migration. This prevents duplicate Test Data Queue items in the modern folders.
   • Wenn Sie die Zuordnungen für Attended- und Unattended-Roboter wiederholen möchten, klicken Sie unten rechts auf Neu starten. Mit dieser Option kehren Sie zum ersten Schritt des Assistenten zurück. Befolgen Sie die Anweisungen unter Verwenden des Assistenten, um die Einrichtung noch einmal abzuschließen.

 

Schritt 2. Einrichtung nach der Migration

---

Nach Abschluss der Migration müssen Sie die folgenden manuellen Schritte ausführen, um Abwärtskompatibilitätsprobleme zu beheben:

1. Kompilieren Sie vorhandene Workflows erneut, die Orchestrator-Aktivitäten verwenden oder direkte HTTP-Aufrufe an die Orchestrator-API senden, um die Version 2019.10 oder höher für UiPath.System.Activities zu verwenden.
2. Re-provision all other existing entities, such as action catalogs, in the corresponding modern folder.
   Sie müssen Attended- und Unattended-Roboter (sie werden automatisch für Benutzer mit Zugriff auf den neuen modernen Ordner bereitgestellt) sowie Umgebungen (sie werden nicht im Kontext eines modernen Ordners verwendet) nicht erneut bereitstellen.
3. Unlink the Test Sets from the classic folders, by deleting them from the corresponding Test Manager projects.

4. Link the Test Sets again, by selecting the Test Sets that have [Migrated] as their description.

5. Aktualisieren Sie den klassischen Ordnerprozess, der in UiPath Apps verwendet wird, um den neu migrierten modernen Ordnerprozess zu verwenden.
6. Aktualisieren Sie alle Workflows, die:
   • eine Abhängigkeit vom alten Ordnerpfad haben
   • die Aktivität Start Job verwenden. In klassischen Ordnern, in denen Sie processName_envName hatten, müssen Sie jetzt für moderne Ordner zu processName wechseln.
7. Aktivieren Sie, falls noch nicht geschehen, die interaktive Anmeldung für den Mandanten. Dies ist für die Arbeit in modernen Ordnern obligatorisch.
8. Führen Sie die Unattended-Prozesse über den Orchestrator mit Start Job aus, um sie in einem modernen Setup zu testen.

📘

Warten Sie nach Abschluss der Migration 10 Minuten, bis der Assistent die Roboter aus den migrierten klassischen Ordnern deaktiviert hat. Dies ist erforderlich, damit Lizenzen freigegeben werden und in modernen Ordnern verwendet werden können.

9. Aktualisieren Sie Endbenutzer-Workstations, um die UiPath Robot-Version 2019.10 oder höher zu verwenden.
10. (Optional) Entfernen Sie die jetzt nicht mehr verwendeten klassischen Ordner.

 

Zurückkehren zu klassischen Ordnern

---

Wenn Sie den Migrationsassistenten ausgeführt haben, aber Ihre Automatisierungen in modernen Ordnern nicht ordnungsgemäß ausgeführt werden, können Sie Ihre Einrichtung für klassische Ordner vorübergehend wieder aktivieren, so dass Sie weiterhin Automatisierungen ausführen können, bis Sie die Probleme mit der Migration beheben und erfolgreich zu modernen Ordnern wechseln können.

So kehren Sie nach der Migration vorübergehend zur Verwendung von klassischen Ordnern zurück:

1. Legen Sie die Roboterauthentifizierungseinstellungen für den Mandanten wieder auf Hybrid fest.
2. Aktivieren Sie alle klassischen Roboter.
3. Aktivieren Sie Trigger in klassischen Ordnern.
4. Löschen Sie die modernen Ordner.
5. Löschen Sie die neuen Roboterkonten.
6. Prüfen Sie, was in der Einrichtung der klassischen Ordner die Ursache für die fehlgeschlagenen Automatisierungen ist und bereinigen Sie möglicherweise Ihre klassischen Ordner.
7. Führen Sie die Migration erneut aus.