Migrieren von Enterprise-Bots

Der Bot-Migrationsprozess nutzt den Bot-Migrationsassistent, um Enterprise 11- oder Enterprise 10-Bots (TaskBots und MetaBots) im .atmx- und .mbot-Format in das in Automation 360 verwendete .bot-Format zu konvertieren und lädt die erfolgreich migrierten Bots in den öffentlichen Arbeitsbereich des Control Room hoch.

Vorbereitungen

Stellen Sie sicher, dass alle Voraussetzungen für die Migration von Bots erfüllt sind: Prerequisite tasks for migrating Bots.

Alle manuellen Abhängigkeiten der Bots werden während der Migration automatisch als Control Room-Abhängigkeiten konvertiert. Mit der Aktion Control Room-Datei kopieren werden diese Abhängigkeiten vom Control Room an die entsprechenden Speicherorte kopiert.

Prozedur

Melden Sie sich bei Ihrer Automation 360-Staging-Umgebung an.
Klicken Sie auf Administration > Migration.

Anmerkung: Wenn Sie Bots von Enterprise 10 zu Enterprise 11 migriert haben, werden die Informationen zu dieser Migration nicht auf der Seite Migrationsliste angezeigt.
Klicken Sie im Bot-Migrationsassistent-Bildschirm auf Bots migrieren.

Wählen Sie auf der Registerkarte Einstellungen die gewünschten Optionen und Konfigurationen aus.

Option	Aktion
Name	Geben Sie einen Migrationsnamen ein oder verwenden Sie den Standardnamen. Der standardmäßige Migrationsname besteht aus dem Namen des angemeldeten Nutzers, dem aktuellen Datum und dem Zeitstempel.
Beschreibung	Geben Sie eine Beschreibung für die Migration ein.
Überschreiben, wenn ein Bot mit dem gleichen Namen vorhanden ist	Wählen Sie diese Option aus, um einen vorhandenen Bot zu überschreiben, wenn ein Bot mit demselben Namen im Ordner vorhanden ist.
Bot-Abhängigkeiten ausschließen	Wählen Sie diese Option aus, um untergeordnete Bots aus Unteraufgaben von der Migration oder Aktualisierung auszuschließen. Wenn Sie diese Option aktivieren, können Sie wählen, ob Sie die übergeordneten und untergeordneten Bots getrennt oder unabhängig voneinander migrieren möchten.
Legacy-Verhalten „Excel-Zelle Zeile“ verwenden	Wählen Sie diese Option aus, wenn Sie von einer älteren Version als Version 11.3.0 migrieren oder das Legacy-Verhalten der Systemvariablen Excel-Zelle Zeile beibehalten möchten.
Servereinstellungen für ausgehende E-Mails verwenden	Wählen Sie diese Option aus, wenn Ihr Bot den Befehl E-Mail senden enthält. Mit diesen Einstellungen legen Sie den Typ des zu verwendenden E-Mail-Servers fest.
Webdienst-Einstellungen einbeziehen	Wählen Sie diese Option, um eine benutzerdefinierte Proxykonfiguration zu unterstützen. Wenn Sie diese Option auswählen, werden die REST-Befehle mit benutzerdefinierten Proxykonfigurationen migriert, die die folgenden globalen Variablen verwenden: AAProxyHost für Hostname AAProxyPort für Port
Bots, die mit Internet Explorer erstellt wurden, mit Internet Explorer-Modus in Edge konvertieren	Wählen Sie diese Option, wenn Sie Enterprise 10- oder Enterprise 11-Bots, die Internet Explorer verwenden, zu Automation 360-Bots migrieren wollen, die den Microsoft Edge-IE-Modus verwenden.
\n-Zeichen in der Aktion „In Datei protokollieren“ in \r\n konvertieren	Wählen Sie diese Option aus, um \n-Zeichen (LF) in \r\n-Zeichen (CRLF) zu konvertieren, wodurch bei der Aktion In Datei protokollieren in migrierten Bots automatisch eine neue Zeile begonnen wird.
Bots und Variablen für Analysezwecke kennzeichnen	Wählen Sie diese Option, wenn Bot Insight-Daten in Enterprise 11-Bots enthalten sind und Sie auch die Bot Insight-Daten mit diesen Bots migrieren möchten. Wenn Sie diese Option wählen, werden die Optionen Bot Insight-Aktionen Öffnen und Schließen erstellt. Anmerkung: Um Bot Insight-Daten zu migrieren, müssen Sie diese Option aktivieren. Wenn Sie Bot Insight-Daten zusammen mit der Bot-Migration migrieren, stellen Sie sicher, dass die Voraussetzungen für Bot Insight erfüllt sind.Voraussetzungen für Bot Insight \| Voraussetzungen für Cloud Migration Utility Wenn die Voraussetzungen für Bot Insight nicht erfüllt sind, kann die Cloud-Migration mit Bot Insight im Status In Arbeit hängen bleiben. Unabhängig davon, ob die Voraussetzungen für Bot Insight und Cloud Migration Utility erfüllt sind oder nicht, importieren oder laden Sie die .atmx-Datei hoch > Migrieren. Dieses Problem tritt sowohl bei On-Premises- als auch bei Cloud-Bereitstellungen auf.

Klicken Sie auf Weiter.
Wählen Sie die Bots und die Ordner aus, die die zu migrierenden Bots (TaskBots und MetaBots) enthalten.
Da Sie einen ganzen Ordner auswählen können, müssen Sie nicht mehr einzelne Bots in diesem Ordner auswählen.
- Wenn Sie einen Ordner ausgewählt haben, werden alle Unterordner in diesem Ordner und die Bots in diesen Unterordnern automatisch für die Migration ausgewählt.
- Wenn der Ordner leer ist, tritt ein Fehler beim Migrationsprozess auf.
Die Spalte Letzte Migration gibt an, wann der Bot zuvor migriert wurde. „N/A“ bedeutet, dass der Bot noch nicht migriert wurde.
Klicken Sie auf Weiter.
Wählen Sie einen oder mehrere Nutzernamen aus der Liste aus, um die Migration auszuführen, und klicken Sie auf den Pfeil nach rechts.
Nutzernamen können entweder die Meldung Zur Laufzeit ausgewählt oder den Gerätenamen in der Spalte Gerät anzeigen. Ein Gerätename gibt das für diesen Nutzer registrierte Gerät an. Zur Laufzeit ausgewählt wird angezeigt, wenn ein Nutzer kein Standardgerät hat, z. B. ein Nutzer, der kein Gerät registriert hat und dem ein Gerät von einem Systemadministrator zugewiesen wurde. Für alle ausgewählten Bot Runners muss ein Standardgerät konfiguriert werden.
- Bots werden in einer Round-Robin-Methode auf ausgewählte Bot Runner-Nutzer verteilt.
- Der erste Bot Runner-Nutzer in der ausgewählten Liste wird als erstes verwendet.
- Ein übergeordneter Bot und seine Abhängigkeiten werden einem einzelnen Bot Runner-Nutzer zugewiesen.
Klicken Sie auf Weiter.

Optional: Überprüfen Sie die abhängigen TaskBots und MetaBots auf der Seite Bot und abhängige Bots, bevor Sie sie migrieren.

Wenn Sie einen Ordner und Bots auf der Seite Bots ausgewählt haben, werden dieser Ordner und die Abhängigkeiten der ausgewählten Bots in der Tabelle angezeigt.

Abhängige Bots (TaskBots und MetaBots) werden vor dem primären Bot migriert.

Die Tabelle zeigt den primären Bot unten und seine Abhängigkeiten darüber. Die folgenden Informationen bedeuten beispielsweise, dass Sample05.atmx eine Abhängigkeit von Sample04.atmx hat und Sample04.atmx eine Abhängigkeit von MessageBox.atmx und MetaTask.mbot hat.


Typ	Name	Pfad
MetaBot (mbot)	MetaTask.mbot	Bots\My Metabots\MetaTask.mbot
TaskBot (atmx)	MessageBox.atmx	Bots\MyTasks\MessageBox.atmx
TaskBot (atmx)	Sample04.atmx	Bots\MyTasks\Sample04.atmx
TaskBot (atmx)	Sample05.atmx	Bots\MyTasks\Sample05.atmx

Klicken Sie auf Bots migrieren.
Das System überprüft, ob der Nutzer, der die Migration initiiert hat, und die ausgewählten Bot Runner-Nutzer über die erforderlichen Berechtigungen zum Durchführen der Migration verfügen. Das System prüft, ob dem Nutzer, der die Migration durchführt, und den von Ihnen ausgewählten Bot Runners alle folgenden Berechtigungen gewährt werden:
- Nutzer, der die Migration durchführt:
  - Berechtigung Migration anzeigen
  - Berechtigung Migration verwalten
  - Berechtigung für die Ordner, die die Bots und MetaBots enthalten, die Sie migrieren möchten
  - Eine Rolle, die Zugriff auf die Bot Runners hat, die die Migration ausführen sollen (wie auf der Seite Administration > Migration > Ausführen als ausgewählt)
  - Berechtigung ALLE Attributwerte für Anmeldedaten anzeigen und bearbeiten
- Bot Runners:
  - Eine unbeaufsichtigte Bot Runner-Lizenz
  - Status Autologin-Set
  - Berechtigung Einem Bot Runner-Nutzer erlauben, Migrationen auszuführen
  - Berechtigung Standardattribute für Anmeldedaten erstellen
  - Berechtigung Ordner erstellen
  - Berechtigung Paket anzeigen
  - Berechtigung Gerät registrieren
  - Berechtigungen Meine Bots anzeigen und Meine Bots ausführen
  - Berechtigungen Einchecken und Auschecken für die Ordner My Tasks und My MetaBots in Automation 360
  - Einstellungen für Standardgeräte
Wenn eine der erforderlichen Berechtigungen nicht erteilt wird, zeigt das System diese Berechtigungen in den Validierungsergebnissen an. In diesem Fall müssen Sie die erforderlichen Berechtigungen erteilen und den Migrationsprozess erneut starten.
Wenn den Nutzern alle erforderlichen Berechtigungen erteilt werden, beginnt das System mit der Migration der ausgewählten Bots und ihrer abhängigen Bots.

Nach der Migration lädt das System erfolgreich migrierte Bots, die zugehörigen Bot Insight-Daten und die veröffentlichten Dashboards in den öffentlichen Arbeitsbereich des Automation 360 Control Room hoch (in den Ordner, in dem die .atmx-Datei verfügbar ist). Im öffentlichen Arbeitsbereich werden nur Bot-Migrationen gespeichert, die vom Control Room aus initiiert wurden.

Details zu Validierungsfehlern für jeden Bot werden in den Bot-Migrationsergebnissen angezeigt. Die Fehlerdetails umfassen die Zeilennummer, die Fehlerdetails, den Grund und die Empfehlung.
Die Bot-Migrationsergebnisse zeigen die Anzahl der migrierten Bots zusammen mit ihrem individuellen Status an. Klicken Sie auf den Spalte Status, um für eine schnelle Analyse nach Bots zu filtern.

Klicken Sie in der Spalte Gründe auf Migrationsprobleme anzeigen, um detaillierte Gründe für den Fehler anzuzeigen. Das Dialogfeld Migrationsprobleme anzeigen zeigt die Zeilennummer, in der der Fehler aufgetreten ist, eine Zusammenfassung des Fehlers und einen detaillierten Fehlerbericht für Sie zur Überprüfung an.
1. Checken Sie den Bot aus, um die mit dem Bot verbundenen privaten Dashboards zu migrieren.
  Die privaten Dashboards werden nur für den Nutzer migriert, der den zugehörigen Bot zum ersten Mal ausgecheckt hat.
2. Zeigen Sie auf der Seite Aktivität > In Arbeit aktive Migrationsaktivitäten an.
Im folgenden Video sehen Sie, wie Sie Enterprise 11- oder Enterprise 10-Bots migrieren:
<span>Video zur Durchführung der Bot-Migration</span>

Wenn Sie während der Migration auf Fehler stoßen, lesen Sie die folgenden Ressourcen:

Nächste Maßnahme

Überprüfen der Bot-Migration | Berichte zur Migration anzeigen