Bot Scanner-Bericht für Migration analysieren
- Aktualisiert: 2022/12/27
Bot Scanner-Bericht für Migration analysieren
Sie können den vom Bot Scanner erstellten Bericht analysieren, um Informationen über die Bots (TaskBots und MetaBots) und Prozesse zu erhalten, die migriert werden können. Verwenden Sie den Bot Scanner, um zu entscheiden, ob Sie jetzt mit der Migration beginnen oder lieber warten wollen, bis mehr Befehle unterstützt werden.
Der Bot Scanner-Bericht enthält folgende Informationen:
- Bots: Im Bot Scanner-Bericht ist ein Bot ein einzelner TaskBot (.atmx) oder MetaBot (.mbot), der in anderen Bots verwendet wird.
Die Registerkarte Bots enthält detaillierte Informationen zu Bots, die migriert werden können, die eine Aktion oder Überprüfung erfordern bzw. solche, die nicht migriert werden können.
- Prozesse: Im Bot Scanner-Bericht ist ein Prozess ein Bot, der in keinen anderen Bots verwendet wird und ein oder mehrere untergeordnete Bots enthalten kann.
Auf der Registerkarte Prozesse finden Sie detaillierte Informationen zu Prozessen, die migriert werden können, die eine Aktion oder Überprüfung erfordern bzw. solche, die nicht migriert werden können.
- Anzahl der Bots und der analysierten Prozesse
- Eine allgemeine Zusammenfassung in Form von Übersichten, die den Migrationsstatus von Bots und Prozessen anzeigen
- Anzahl der Bots und Prozesse, die Sie nach Automation 360 migrieren können bzw. nicht migrieren können
- Befehle, die in Bots verwendet werden, und die Häufigkeit der Verwendung
- Gründe, warum Bots und Prozesse derzeit nicht migriert werden können, und Häufigkeit solcher Vorkommnisse
- Aktionen und Überprüfungen, die von Nutzern nach der Migration aufgrund von Änderungen im Verhalten der Befehle durchgeführt werden müssen
- Bots und Prozesse, die nicht migriert werden können, und die entsprechenden Fehlermeldungen
- Anzahl der Zeilen in Bots und Gesamtzahl der Zeilen aller Bots, die mit einem Prozess verknüpft sind
- Zeilennummern für einzelne Bots und Prozesse, die überprüft werden müssen oder Maßnahmen erfordern
Die meisten Funktionen in Enterprise 10 oder Enterprise 11 sind wie gehabt verfügbar; einige Funktionen werden jedoch anders implementiert, um Webvorgänge (ohne Client) zu unterstützen. Für diese Funktionen müssen Sie die Schreibweise der Bots ändern.
Der Bot Scanner ist für das Scannen von Bots (TaskBots und MetaBots) mit den Versionen Enterprise 10 und Enterprise 11 des Enterprise Client konzipiert. Die Gesamtanzahl der Dateien beinhaltet die Anzahl der übersprungenen und nicht gescannten Dateien.
Die Berichte stehen unter dem Ausgabepfad zur Verfügung, den Sie im Feld Zielordner auswählen des Dialogfelds Automation Anywhere Bot Scanner angegeben haben. Der Bot Scanner erstellt einen zusammenfassenden Bericht (summary.html) und eine separate XML-Datei für jeden gescannten Bot. Er erstellt einen separaten Bericht für jede Logik, die in einem MetaBot verfügbar ist.
Es wird ein raw-data-Ordner erstellt, der die Berichte (im XML-Format) für jeden gescannten Bot enthält. Es hilft unseren Ingenieuren, den Migrationsprozess weiter zu analysieren und gegebenenfalls Korrekturmaßnahmen zu ergreifen. Im zusammenfassenden Bericht bzw. in den einzelnen Berichten der gescannten Bots sind keine personenbezogenen Daten (PII) enthalten.
Wenn Sie die Berichte mit uns teilen möchten, um das Produkt zu verbessern, komprimieren Sie die Dateien im Ordner raw-data und stimmen Sie sich mit Ihrem Customer Success Manager (CSM) oder Partner Enablement Manager (PEM) ab. Es werden keine Daten automatisch an Automation Anywhere weitergegeben.
Zusammenfassungsbericht für alle Bots
- Ob Sie nach Automation 360 migrieren können
- Die Anzahl der gescannten Bots
- Bericht ausschließlich über Bots, der Informationen zu den Bots enthält, für die die Migration nach Automation 360 unterstützt wird (in Prozent)
- Bericht ausschließlich über Prozesse, der Informationen zu den Prozessen enthält, für die die Migration nach Automation 360 unterstützt wird
- Kombinierter Bericht zu Bots und Prozessen, der Informationen zu den Bots und Prozessen enthält, für die die Migration zu Automation 360 unterstützt wird
Nehmen wir zum Beispiel an, Bot Scanner hat 10 Bots gescannt. Wenn von den 10 Bots 8 Bots bereit für die Migration nach Automation 360 sind, dann beträgt der Prozentsatz von Bots, die migriert werden können, 80 % und der Prozentsatz der Bots, die jetzt nicht migriert werden können, beträgt 20 %.
- Identifizieren Sie die Aktionen und Überprüfungen, die Sie für die verbleibenden 5 % der Bots durchführen müssen, damit Sie einen Großteil Ihrer Bots erfolgreich migrieren und nach der Migration in Automation 360 ausführen können.
- Identifizieren Sie Bots, die ohne jeglichen manuellen Eingriff nach Automation 360 migriert werden können.
- Geben Sie den Grund, aus dem 2 % der Bots derzeit nicht migriert werden können, sowie den voraussichtlichen Zeitpunkt an, zu dem Sie sie später migrieren können. Der Grund dafür könnte in Befehlen und Variablen liegen, die noch nicht in Automation 360 unterstützt werden.
- Klicken Sie auf die Registerkarte Prozesse.
- Klicken Sie auf die Registerkarte „Meldungen“, die Sie überprüfen möchten.
- Klicken Sie in der Spalte Hauptaufgabenreferenz auf das Erweiterungssymbol (
), um den Prozess anzuzeigen. - Klicken Sie auf einen Prozessnamen, um die Meldung anzuzeigen.
- Identifizieren Sie die Aktionen und Überprüfungen, die Sie an den verbleibenden 15 Prozessen durchführen müssen, damit Sie einen Großteil Ihrer Prozesse erfolgreich migrieren und sie nach der Migration in Automation 360 verwenden können.
- Identifizieren Sie Prozesse, die ohne jeglichen manuellen Eingriff nach Automation 360 migriert werden können.
- Identifizieren Sie den Grund, aus dem dieser Prozess derzeit nicht migriert werden kann, sowie den voraussichtlichen Zeitpunkt, zu dem er später migrieren kann.
Der Grund dafür könnte in Befehlen und Variablen liegen, die noch nicht in Automation 360 unterstützt werden.
Das folgende Bild zeigt einen Beispielbericht aus dem Bot Scanner:
Die folgende Tabelle beschreibt die verschiedenen Felder im Bot Scanner-Beispielbericht (wie in der vorherigen Abbildung nummeriert):
| Feld/Option | Beschreibung |
|---|---|
| 1 | Liefert eine Zusammenfassung und den Status der Migrationsbereitschaft Ihrer Bots. Überprüfen Sie den Status der migrierten Daten anhand der folgenden Signale:
|
| 2 | Bietet einen Überblick über die folgenden Informationen zu Bots:
|
| 3 | Stellt zusätzliche Ressourcen zur Verfügung, um den Migrationsprozess zu erleichtern. |
| 4 | Bietet einen Überblick über die folgenden Informationen zu Prozessen:
|
| 5 |
Anmerkung: Jede Meldung enthält Informationen, die Sie nach der Migration überprüfen müssen. Eine Liste dieser veralteten Meldungen finden Sie unter Migrationsmeldungen. Verwenden Sie den Meldungscode (z. B.
R102), um die jeweilige Meldung schnell anzuzeigen. |
| 6 | oder : In dieser Ansicht finden Sie die Liste der Bots oder Prozesse, die nach der Migration nach Automation 360 Aktionen erfordern.
Anmerkung: Jede Meldung enthält Informationen, die Sie nach der Migration überprüfen müssen. Eine Liste dieser veralteten Meldungen finden Sie unter Migrationsmeldungen. Verwenden Sie den Meldungscode (z. B.
R102), um die jeweilige Meldung schnell anzuzeigen. |
| 7 |
Klicken Sie auf den Meldungscode, um Informationen über Änderungen im Automation 360-Verhalten des Befehls im Vergleich zum Verhalten in Enterprise 11 oder Enterprise 10 anzuzeigen. Anmerkung: Jede Meldung enthält Informationen, die Sie nach der Migration überprüfen müssen. Eine Liste dieser veralteten Meldungen finden Sie unter Migrationsmeldungen. Verwenden Sie den Meldungscode (z. B.
R102), um die jeweilige Meldung schnell anzuzeigen. |
| 8 | oder : In dieser Ansicht finden Sie eine Liste der Bots oder Prozesse, die ohne manuellen Eingriff nach Automation 360 migriert werden können. |
| 9 | oder : In dieser Ansicht finden Sie eine Liste der Bots oder Prozesse, die derzeit nicht nach Automation 360 migriert werden können. |
| 10 | : In dieser Ansicht finden Sie eine Liste der Befehle, die migriert werden können, mit der Anzahl ihrer Vorkommnisse in allen gescannten Bots. |
| 11 |
Klicken Sie auf den Meldungscode, um die manuellen Schritte anzuzeigen, die Sie durchführen müssen, um den migrierten Prozess erfolgreich in Automation 360 auszuführen. Sie können auch die Befehle anzeigen, die der Bot enthält, sowie die Häufigkeit bzw. die Anzahl der Verwendungen des Befehls im Bot. Anmerkung: Jede Meldung enthält die Ursache und die Aktion, die Sie nach der Migration durchführen müssen. Eine Liste dieser veralteten Meldungen finden Sie unter Migrationsmeldungen. Verwenden Sie den Meldungscode (z. B.
A101), um eine bestimmte Meldung schnell anzuzeigen. |
| 12 | Gibt den Speicherort des Bots an. |
| 13 | Gibt den Status des Bots oder Prozesses an. |
| 14 |
|
| 15 | Bei Prozessen werden in diesem Feld die Anzahl der Bots in einem Prozess angezeigt, die nach der Migration nach Automation 360 eine Aktion erfordern. Klicken Sie auf das Erweiterungssymbol () und klicken Sie dann auf den Namen einer Aufgabenreferenz, der mit Aktion erforderlich gekennzeichnet ist. Klicken Sie auf den Meldungscode, um Informationen über Änderungen im Automation 360-Verhalten des Befehls im Vergleich zum Verhalten in Enterprise 11 oder Enterprise 10 anzuzeigen. Anmerkung: Dieses Feld ist nur für Prozesse verfügbar.
|
| 16 | Bei Prozessen werden in diesem Feld die Anzahl der Bots in einem Prozess angezeigt, die nach der Migration nach Automation 360 überprüft werden müssen. Klicken Sie auf das Erweiterungssymbol () und klicken Sie dann auf den Namen einer Aufgabenreferenz, der mit Überprüfung erforderlich gekennzeichnet ist. Klicken Sie auf den Meldungscode, um Informationen über Änderungen im Automation 360-Verhalten des Befehls im Vergleich zum Verhalten in Enterprise 11 oder Enterprise 10 anzuzeigen. Anmerkung: Dieses Feld ist nur für Prozesse verfügbar.
|
| 17 | Laden Sie die Liste der Bots, Prozesse oder Befehle, die migriert werden können oder nicht, herunter (als CSV-Datei), damit Sie die Datei mit anderen teilen können. |
| 18 |
|
Der Bericht ist gültig, bis die nächste Version von Bot Scanner verfügbar ist. Wenn die nächste Version von Bot Scanner verfügbar ist, wird eine Meldung zum Ablauf des Berichts angezeigt. Sie müssen die neueste Version von Bot Scanner herunterladen und die Bots erneut scannen.
Erforderliche Prüfungen und Maßnahmen nach der Migration
Einige Befehle in den Bots werden möglicherweise im Bot Scanner-Bericht als „Überprüfung erforderlich“ markiert. Für diese Elemente müssen Sie nach der Migration eine bestimmte Validierung durchführen oder die Bots aktualisieren.
Die folgenden Bot Scanner-Meldungen erfordern eine Überprüfung oder verschiedene Maßnahmen:
- Der Pfad des untergeordneten Bots ist vollständig variabel und wird zur Laufzeit aufgelöst. Bot schlägt bei der Ausführung fehl, wenn der in der Variablen angegebene Pfad ungültig ist. Prüfen Sie den migrierten Bot.
Stellen Sie sicher, dass der untergeordnete Bot an der im variablen Pfad angegebenen Stelle vorhanden ist. Wenn der Pfad im übergeordneten Bot nicht korrekt ist, aktualisieren Sie den Pfad so, dass er auf den richtigen untergeordneten Bot verweist.
- Der von der Systemvariablen „Error Description“ zurückgegebene Wert kann von älteren Versionen abweichen. Prüfen Sie den migrierten Bot.
Die Beschreibung einiger Fehlermeldungen in Automation 360 kann von jenen von Enterprise 11 oder Enterprise 10 für denselben Fehler abweichen. Wenn ein Enterprise 11- oder Enterprise 10-Bot so konfiguriert ist, dass Entscheidungen auf der Grundlage der Beschreibung der Fehlermeldungen getroffen werden, müssen Sie möglicherweise den migrierten Bot anhand der neuen Beschreibung der Fehlermeldungen aktualisieren.
- Die Migration des Befehls „Datenbank – Verbinden“ ist abgeschlossen, für „Windows-Authentifizierung“ ist jedoch eine zusätzliche Konfiguration erforderlich. Weitere Informationen finden Sie in der Dokumentation zum Datenbankpaket.
Führen Sie die angegebenen Schritte aus, um eine Verbindung mit einem Microsoft SQL Server mit Windows-Authentifizierung herzustellen. Einzelheiten finden Sie unter Herstellen einer Verbindung zu Microsoft SQL Server mit Windows-Authentifizierung.
- Migration von „IF“ mit variabler Bedingung ist abgeschlossen. Da das Datumsformat der Nutzervariablen jedoch nicht bestimmt werden konnte, wurde es mit dem Standarddatumsformat MM/TT/JJJJ HH:mm:ss migriert. Überprüfen Sie das Format und ändern Sie es bei Bedarf.
Aktualisieren Sie das Datumsformat im migrierten Bot auf das gleiche Format, das in Enterprise 11 für den Bot verwendet wird.
- Es konnte nicht festgestellt werden, ob eine Variable, die als Position verwendet wird, ein Index- oder Spaltenname ist. Die Indexposition beginnt bei 0 statt bei 1. Führen Sie daher bei Bedarf die erforderlichen Maßnahmen durch.
Wenn Sie die Systemvariablen FileData Column[$variable$] oder Excel Column[$variable$] im Enterprise 11- oder Enterprise 10-Bot verwendet haben, gehen wir davon aus, dass Sie den Spaltennamen in $variable$ verwendet haben. In solchen Fällen enthält der migrierte Bot den Ausdruck FileData Column{$variable$}. Wenn $variable$ im Enterprise 11- oder Enterprise 10-Bot die Spaltennummer enthält, müssen Sie den Ausdruck im migrierten Bot zu FileDataColumn[$var.String:toNumber()$] aktualisieren.
- Der Befehl „Logik ausführen“, der die Anmeldedatenvariablen als Eingabe für die Logik eines MetaBots verwendet.
Bots, die den Befehl Logik ausführen verwenden, der Credential Vault-Attribute von einer TaskBot- an eine MetaBot-Logik weitergibt, können nach Automation 360 migriert werden. Der Anmeldeinformationsname und der Attributname werden in den Feldern in der entsprechenden Zeile des migrierten Bots angezeigt.
Wenn Sie die Migration mithilfe der wiederhergestellten Enterprise 11-Datenbank durchgeführt haben, wird ein entsprechender Locker in Automation 360 für die im Enterprise 11-Bot verwendeten Anmeldeinformationsvariablen erstellt.
Wählen Sie eine der folgenden Optionen, um die migrierten Bots erfolgreich auszuführen:- Option 1: Übergeben Sie die Variablen des Typs „Anmeldedaten“.
- Erstellen Sie eine Anmeldedatenvariable in den untergeordneten Bots als Eingabevariablen.
- Aktualisieren Sie in der Ausführen-Aktion des TaskBot-Pakets die Eingabewertfelder des übergeordneten Bots, um die Credential Vault-Attribute für die für den untergeordneten Bot erstellte Anmeldedatenvariable (entsprechend der MetaBot-Logik) zu verwenden.
- Option 2: Übergeben Sie die Anmeldedaten als globalen Wert.
- Erstellen Sie den globalen Wert in Automation 360 für die Anmeldedaten, die im Befehl Logik ausführen in Enterprise 11 verwendet werden.
- Aktualisieren Sie in der Ausführen-Aktion des TaskBot-Pakets die Eingabewertfelder des übergeordneten Bot, um die globalen Werte für die für den untergeordneten Bot erstellte Anmeldedatenvariable (entsprechend der MetaBot-Logik) zu verwenden.
Wenn Sie die wiederhergestellte Enterprise 11-Datenbank bei der Installation Automation 360 nicht verwendet haben, müssen Sie zuerst den erforderlichen Locker für die im Enterprise 11-Bot verwendeten Anmeldeinformationsvariablen erstellen, bevor Sie die vorherigen Schritte ausführen.Anmerkung: Automation 360 bietet erhöhte Sicherheit, da Sie den Variablen des Typs „Anmeldedaten“ nur Credential Vault-Attribute zuweisen können. Dies schränkt die unsichere Handhabung von Credential Vault-Attributen ein, bei der sie möglicherweise Nicht-Anmeldedatenvariablen zugewiesen wurden. - Option 1: Übergeben Sie die Variablen des Typs „Anmeldedaten“.
Bericht für einen einzelnen Bot
Der Bericht für jeden Bot enthält Informationen über seine Abhängigkeiten, Variablen und verwendeten Befehle.
Der Bericht für einen einzelnen Bot sieht dem folgenden Code ähnlich:
<analysis version="1.3.0"> <stat> <dependencies ucount="0" count="0"/> <errors ucount="6" count="12"> <error count="1">System variable $AAApplicationPathlt;/error> <error count="1">Command [If FolderNotExist] is not supported</error> <error count="3">System variable $CurrentDirectorylt;/error> <error count="3">System variable $Extensionlt;/error> </errors> </stat> <commands> <command target-action="assign" name="VariableOperation" line="1" grp="VariableOperation" api="VarOpe"> <msg type="error" review="true" category="variable">System variable $AAApplicationPathlt;/msg> <msg type="info" review="false" category="default">Command parameter [Option] of type [String] is not required.</msg> </command> <command target-action="createFolder" name="createFolder" line="3" grp="FilesFolders" api="CreateFolder"/> <command target-action="copyFiles" name="CopyFiles" line="5" grp="FilesFolders" api="CreateFolder"/> <command target-action="connect" name="Connect" line="3" grp="Database" api="Connect"/> <command target-action="OpenCSVTXT" name="ReadFrom" line="9" grp="CsvText" api="Csv" <msg tpye="info" review="false" category="command">Line in 11.x client, there is no separate option given for CSV and TEXT in Automation 360</msg> <msg type="error" review="true" category="variable">System variable $CurrentDirectorylt;/msg> <msg type="error" review="true" category="variable">System variable $Extensionlt;/msg> <msg type="error" review="true" category="variable">System variable $FileNamelt;/msg> </command> </commands> <variables> <variable name="$CSV-TXT-Default-DATAquot; type="TABLE" value-type=""/> </varaibles> </analysis>| Knoten | Attribut | Beschreibung |
|---|---|---|
| Stat | -- | Liefert Informationen über die Anzahl der Abhängigkeiten, Fehler und Warnungen. |
| -- | Abhängigkeiten | Gibt die Anzahl der Abhängigkeiten für den Bot an. ucount zeigt die Anzahl der eindeutigen Abhängigkeiten und count die Gesamtanzahl der Abhängigkeiten an. |
| -- | Fehler | Gibt die Anzahl der Fehler für den Bot an. ucount zeigt die Anzahl der eindeutigen Fehler und count die Gesamtanzahl der Fehler an. |
| Befehl | -- | Liefert Informationen zu den verschiedenen Befehlen und Aktionen, die im Bot verwendet werden. |
| -- | Zielaktion Befehl | Gibt die Aktion an, die für den Befehl ausgeführt wird. |
| -- | name | Gibt den Namen des Befehls an. |
| -- | Zeile | Gibt die Zeilennummer an, in der der Befehl im Bot vorhanden ist. |
| -- | grp | Gibt die Befehlsgruppe an, zu der der Befehl gehört. |
| -- | api | Gibt den Namen der API an, die der Befehl verwendet. |
| -- | Meldungstyp | Bietet Informationen zum Meldungstyp. Der Typ error zeigt an, dass der Befehl nicht nach Automation 360 migriert werden kann, und der Typ info zeigt an, dass der Befehl migriert werden kann, aber einige seiner Attribute während der Migration geändert werden. |
| -- | überprüfen | Enthält Informationen darüber, ob der Befehl überprüft werden muss. Dieses Attribut ist immer wahr bei Meldungen des Typs |
| -- | category | Liefert Informationen über den Befehl oder die Variable, für den/die die Meldung angezeigt wird. |
| Variablen | Liefert Informationen über die Systemvariablen, die vom Bot verwendet werden. | |
| -- | Variablenname | Gibt den Namen der Variablen an. |
| -- | type | Gibt den Variablentyp an. |
| -- | Werttyp | Gibt den Typ des Werts an, der für diese Variable bereitgestellt wird. |
Sehen Sie sich das folgende Video zur Analyse des Scannerberichts an.