Migrieren von klassischen Ordnern zu modernen Ordnern

Moderne Ordner wurden eingeführt, um die Orchestrierung von Automatisierungen zu verbessern und zu vereinfachen und bieten mehrere Vorteile im Vergleich zu klassischen Ordnern.

Hinweis: 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.
• Migriert jede Test Suite-Entität in den modernen Unterordner, der der klassischen Ordnerumgebung entspricht, zu der sie zuvor gehörte.

• Migriert Roboter und Benutzerkonten in die entsprechenden modernen Ordner:

  • Ordnet jeden klassischen Attended-Roboter einem Benutzerkonto zu und richtet jedes Benutzerkonto mit persönlichen Automatisierungseinstellungen (früher als Attended-Roboter-Einstellungen bezeichnet) und Zugriff auf die entsprechenden modernen Ordner und Maschinen ein, die zum Ausführen der Attended-Automatisierungen erforderlich sind, die in klassischen Ordnern ausgeführt wurden. In Bezug auf Rollen können zwei Szenarien auftreten:

    • Wenn das Benutzerkonto, dem ein klassischer Attended-Roboter zugeordnet ist, dem Mandanten in dem Moment, in dem die Migration gestartet wurde, nicht zugewiesen war, wird er automatisch in den Mandanten aufgenommen und erhält die Rolle Allow to be Automation User auf Mandantenebene.
    • Wenn das Benutzerkonto, dem ein klassischer Attended-Roboter zugeordnet ist, dem Mandanten bereits zugewiesen wurde, ändern sich seine Rollen nicht, sodass Sie ihm manuell die Rolle Allow to be Automation User auf Mandantenebene zuweisen müssen. Dadurch wird verhindert, dass Automatisierungen unterbrochen werden.

  • Ordnet jeden klassischen Unattended Robot Roboterkonten zu (empfohlen), sofern nicht anders konfiguriert, und richtet jedes Roboterkonto mit Zugriff auf die entsprechenden modernen Ordner und Maschinen ein, die zum Ausführen der Automatisierungen erforderlich sind, die der Unattended Robot in klassischen Ordnern ausgeführt hat.

    Gewährt die Rolle Automation User auf Ordnerebene vorhandenen Roboterkonten, die klassischen Unattended-Robotern zugeordnet sind.

    Neue, automatisch generierte Roboterkonten erhalten die Rolle Automation User auf Ordnerebene und die Rolle Allow to be Automation User auf Mandantenebene.

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

  Wichtig:

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

• Die interaktive Anmeldung wird erzwungen.

  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.

• Konto-Maschinen-Zuordnungen werden auf Mandantenebene aktiviert.

Voraussetzungen

Berechtigungen

• Um den modernen Migrationsassistenten erfolgreich ausführen zu können, müssen Sie ein Organisationsadministratorsein.

• 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
  • Ordner: 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

Wichtig:

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.

Wichtig: Wenn ein Roboter nicht migriert wird, werden auch die Inhalte und Ablaufpläne dieses Roboters nicht migriert, es sei denn, sie werden auch von einem anderen migrierten Roboter verwendet.

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.

Wichtig: Wenn die Migration beginnt, werden alle Aufträge beendet, die sich nicht im endgültigen Status befinden. Wenn ein beendeter Auftrag bis zum Abschluss der Migration nicht den Status „Angehalten“ erreicht, schlägt die Migration mit einem zugehörigen Fehler fehl.

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.

   Hinweis:

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

Verwenden des Assistenten für 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.

Wichtig:

• Wenn Sie kein Konto für einen Roboter festlegen, wird dieser Roboter nicht migriert. Die Prozesse, die diesem Roboter zugeordnet sind, können nicht mehr ausgeführt werden.
• Wenn der Benutzername eines Attended-Roboters, der an der Migration beteiligt ist, das @-Zeichen nicht enthält, ist die Migration nicht erfolgreich. Um dies zu umgehen, müssen lokale Benutzer in Verzeichnisbenutzer umgewandelt werden. Das erfolgt automatisch während der Installation oder des Upgrades, sofern sich die betroffenen Benutzer mindestens einmal beim Orchestrator anmelden. Wenn das nicht der Fall ist, können Sie dieses Skript verwenden, um sie umzuwandeln:

  DECLARE @domain VARCHAR(100) = 'your-domain-name-here'
  UPDATE u
  SET
      u.[UserName] = CONCAT(u.[UserName], '@', lower(@domain)),
      u.[Type] = 2
  FROM
      [dbo].[Users] u
      JOIN [dbo].[UserLogins] l ON u.[Id] = l.[UserId]
  WHERE 
      u.[Type] = 0
      AND l.[LoginProvider] = 'Windows'
      AND u.[IsDeleted] = 0

1. Für jedes Zielkonto, das nicht korrekt oder nicht festgelegt ist, müssen Sie das Konto manuell festlegen:
   1. Klicken Sie in der Spalte Zielbenutzerkonto auf Zuweisen.
   2. Beginnen Sie im Feld Nach einem Benutzer suchen mit der Suche und wählen Sie dann den Benutzer aus den Ergebnissen aus.
   3. 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.
2. 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 über eine Integration mit einem externen Benutzerverzeichnis verfügen, 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.
  • Wenn die Einstellung für die Roboterauthentifizierung auf Mandantenebene auf Hybrid festgelegt ist und für das Zielbenutzerkonto die persönliche Automatisierung aktiviert ist, muss der Wert Benutzername für den Roboter mit dem Wert Domäne\Benutzername des Benutzers übereinstimmen, wie auf der Einrichtungsseite für persönliche Automatisierungen des Benutzers angezeigt.
  • Wenn die Roboter-Authentifizierungseinstellung auf Mandantenebene auf Hybrid festgelegt ist, für das Zielbenutzerkonto die persönliche Automatisierung aktiviert ist und die Option Lizenz von Benutzergruppe erben auf der Einrichtungsseite für persönliche Automatisierungen des Benutzers festgelegt ist, hat der Benutzer einen generierten persönlichen Automatisierungs-Benutzernamen. Der Name wird nicht angezeigt, muss aber mit dem Benutzernamen des Roboters übereinstimmen, andernfalls ist die Zuordnung nicht zulässig.

Wichtig: Wenn mehrere Attended-Roboter demselben Zielkonto zugeordnet sind, wird der Benutzername des Roboters im modernen Ordner einer der Benutzernamen der migrierten Roboter sein, der zufällig gewählt wird. Dies kann zu Zugriffsproblemen führen, wenn Sie versuchen, eine Verbindung mit Maschinen herzustellen.

Verwenden des Assistenten für Unattended-Benutzer

Unattended-Roboter müssen Sie neuen oder vorhandenen Roboterkonten zuordnen. Roboterkonten sind für die Ausführung von Unattended-Automatisierungen konzipiert und wir empfehlen, sie anstelle von Benutzerkonten zu verwenden.

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

1. Wählen Sie oben rechts unter Massenaktionenaus, 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.

2. Überprüfen Sie die Spalte Zielroboterkonto, um sicherzustellen, dass alle vorhandenen Zuordnungen korrekt sind.
   • Wenn Sie Roboterkonten automatisch generierenausgewä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.

     Wichtig: Alle klassischen Roboter, die keinem Zielroboterkonto zugeordnet sind, werden nicht in moderne Ordner migriert.
3. 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:

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

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

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

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

Wichtig: Wenn Sie mehrere Roboter mit unterschiedlichen Anmeldeinformationen demselben Roboterkonto zuordnen, verwendet das Roboterkonto nach der Migration die Anmeldeinformationen eines der klassischen Roboter nach dem Zufallsprinzip. Es besteht das Risiko, dass diese Anmeldeinformationen nicht auf allen Zielmaschinen funktionieren und nach der Migration dazu führen können, dass die Verbindung mit den Maschinen fehlschlägt.

Starten der Migration

1. Wenn Sie bereit sind, klicken Sie auf Migration ausführen, um den Prozess zu starten.

   Ein Bestätigungsdialogfeld wird geöffnet.

2. Klicken Sie auf Ausführen, um die Migration zu starten.

   Die Seite wird aktualisiert, um den Migrationsfortschritt für jeden Ordner anzuzeigen.

   Hinweis: 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.
3. Klicken Sie auf Schließen, um den Assistenten zu beenden.

Nächste Schritte: Wenn die Migration erfolgreich war, fahren Sie mit der Einrichtung nach der Migration fort.

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.

In diesem Fall wird der Status „Beendet“ nach 24 Stunden automatisch in den Status „Angehalten“ umgewandelt. An diesem Punkt können Sie die Migration neu starten.

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.

     Tipp: Wenn die Migration mit einem Fehler für Testdaten-Warteschlangen oder Testdaten-Warteschlangenelemente fehlschlägt, aktivieren Sie das Kontrollkästchen Vor erneutem Versuch bereinigen, bevor Sie die Migration neu starten. Dadurch werden doppelte Testdaten-Warteschlangenelemente in den modernen Ordnern verhindert.

   • 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 Verwendung 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. Stellen Sie alle anderen vorhandenen Entitäten, z. B. Aktionskataloge, im entsprechenden modernen Ordner erneut bereit.

   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. Heben Sie die Verknüpfung der Testsätze mit den klassischen Ordnern auf, indem Sie sie aus den entsprechenden Test Manager-Projekten löschen.
   
   

   

   
   
4. Verknüpfen Sie die Testsätze erneut, indem Sie die Testsätze auswählen, deren Beschreibung [ Migriert ] hat.
   
   

   

   
   
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.
   Hinweis: 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. Entfernen Sie die jetzt nicht 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.

Manuelle Migration

Um die Funktionen moderner Ordner zu nutzen, müssen Sie vorhandene Workflows neu kompilieren, die Orchestrator-Aktivitäten verwenden oder direkte HTTP-Aufrufe an die Orchestrator-API mit UiPath.System.Activities v19.10.1 oder höher durchführen. Sie müssen auch alle anderen vorhandenen Entitäten in einer modernen Ordnerstruktur erneut bereitstellen, außer: Roboter – da sie automatisch für Benutzer mit Zugriff auf den neuen modernen Ordner bereitgestellt werden; und Umgebungen – da sie nicht im Kontext eines modernen Ordners verwendet werden.

Wichtig:

Durch das Upgrade der vorhandenen Entitäten auf das moderne Modell wird die Abwärtskompatibilität komplett entfernt. Die neu kompilierten Workflows sind nur ausführbar von 2019.10+ Robotern.

Migrieren zu modernen Ordnern

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. Allgemeiner Überblick über den Migrationsprozess:

• Jede Umgebung wird zu einem separaten Unterordner oder alternativ zum eigenen Ordner der obersten Ebene, wenn Sie die Benutzer und Prozesse vollständig getrennt halten möchten.

• Der Workflow jedes Pakets muss mit aktuellen Aktivitäten neu kompiliert und dann erneut veröffentlicht oder in den Orchestrator hochgeladen werden.

• Mithilfe der neu kompilierten Pakete muss jeder Prozess im Ordner (oder Unterordner) erneut bereitgestellt werden, der der vorherigen Umgebung entspricht.

• Jeder Benutzer muss den Ordnern hinzugefügt werden, die den Prozessen entsprechen, auf die er zugreifen können muss.

Diese Migration kann für den Benutzer nahtlos durchgeführt werden, wobei der Orchestrator-Administrator die gesamte moderne Ordnerstruktur und die erforderlichen Entitäten erstellt und hinzufügt, während die Benutzer weiterhin die vorhandenen Entitäten in den klassischen Ordnern verwenden, in denen sie zugewiesen sind. Während dieser Zeit können Sie zwei Roboter mit dem gleichen domain\username erstellen, einen in einem klassischen Ordner und einen in einem modernen Ordner, und der Benutzer sieht und führt nur die klassischen Prozesse aus, die ihnen zur Verfügung stehen. Wenn der klassische Roboter gelöscht wird, übernimmt und führt der moderne Roboter die neu erstellten und hinzugefügten modernen Versionen der gleichen Prozesse aus, ohne dass sich die Benutzererfahrung ändert.

Wichtig:

Wenn ein klassischer Roboter mit dem gleichen domain/username wie ein Benutzer in einem modernen Ordner existiert, hat der Benutzer nur Zugriff auf den klassischen Roboter und verwandte Prozesse. Damit der Attended-Roboter in einem modernen Kontext funktionieren kann, muss der klassische Floating-Roboter deaktiviert werden. Nachdem die Migration erfolgreich getestet und geprüft wurde, kann der klassische Roboter sicher gelöscht werden.

Unterstützte Migration mit dem Orchestrator-Manager

Um die Migration zu modernen Ordnern zu vereinfachen, können Sie den UiPath-Orchestrierungs-Managerverwenden. Dies ist ein Studio-Projekt, das die Orchestrator-API verwendet, um Entitäten basierend auf Microsoft Excel-Arbeitsmappen zu bearbeiten. Eine Anleitung zur Verwendung für die Migration finden Sie in der Produktdokumentation.