Migration von MetaBots
- Zuletzt aktualisiert2022/12/04
Migration von MetaBots
Wenn Sie einen MetaBot nach Automation 360 migrieren, werden äquivalente Bots für die verschiedenen im MetaBot verfügbaren Logiken erstellt, mit Ausnahme der Anwendungsbildschirme. Nach erfolgreicher Migration wird jede Logik in einer .mbot-Datei in eine TaskBot-Datei konvertiert.
Ein MetaBot enthält Assets und Logik. Assets sind die Anwendungsbildschirme oder DLLs, die zur Automatisierung einer Aufgabe in einer Anwendung verwendet werden. Logik ist ein Satz von Befehlen, um eine Operation durchzuführen und mit anderen Logiken und Bots zu interagieren.
- Bevor Sie mit dem Bot-Migrationsassistent .atmx oder .mbot migrieren, vergewissern Sie sich, dass sämtliche Logik, dlls, .mbots, .atmx-Dateien und andere Abhängigkeiten, die mit den zuvor migrierten MetaBots oder TaskBots zusammenhängen, sich nicht im Zustand Ausgecheckt befinden. Andernfalls tritt während der erneuten Migration der folgende Fehler auf:
Bot ist nicht bereit für die Migration.
- Wenn der Bot, den Sie migrieren, ausgecheckt oder zuvor migriert wurde, vergewissern Sie sich, dass der zu migrierende Bot sich im Zustand Eingecheckt befindet. Um den migrierten Bot wiederzuverwenden, wählen Sie im Bot-Migrationsassistent die Option Überschreiben, wenn ein Bot mit dem gleichen Namen vorhanden ist. Wenn Sie einen aktualisierten Bot verwenden möchten, deaktivieren Sie die Option Überschreiben, wenn ein Bot mit dem gleichen Namen vorhanden ist.
- Konvertiert MetaBot-Logik in entsprechende TaskBots.
- Behält die Ordnerstruktur der MetaBots nach der Migration bei. Die neuen Ordner, die in Automation 360 erstellt wurden, enthalten die TaskBots für jede zu Automation 360 migrierte Logik.
- Aktualisiert die TaskBots, die MetaBot-Logik verwenden, um auf die neuen TaskBots zu verweisen, die für die migrierte MetaBot-Logik erstellt wurden.
Sie müssen die TaskBots nicht manuell aktualisieren.
Funktionen wie die Verwendung von DLLs, Eingabe- und Ausgabevariablen und die Ausführen-Berechtigung, die nur für MetaBots verfügbar waren, stehen jetzt für alle TaskBots zur Verfügung.
- MetaBot-Name: MetaTask
- Assets:
- Anmeldebildschirm
- General.dll
- DLL\Binary.dll
- Logik:
- Common
- Process1\Connect
- Process1\Disconnect
- Process1\Operations\Numeric
Vorteile der wiederverwendbaren TaskBots in Automation 360
Automation 360 wiederverwendbarer TaskBots | v11 MetaBots |
---|---|
Mit der Finder-Komponente können Sie mit weniger Klicks zu einem untergeordneten Bot navigieren und dadurch Zeit sparen. Navigieren Sie zu , um den untergeordneten Bot zu erreichen. | Sie müssen durch die Aktion Bot zu erreichen. | navigieren, um den untergeordneten
Sie können die untergeordneten Bots sowohl im privaten als auch im öffentlichen Arbeitsbereich durchsuchen, um sie in TaskBots zu verwenden. | Sie müssen die MetaBots in das lokale Repository herunterladen, um einen untergeordneten Bot in den TaskBots zu verwenden. |
Nur eine bestimmte Logik wird bereitgestellt, wenn es in einer Aufgabe verwendet wird, was Zeit und Bandbreite spart. | Ein gesamter MetaBot wird auf dem Bot Runner Computer bereitgestellt, auch wenn nur eine Logik in der Aufgabe verwendet wird. |
Bietet eine bessere RBAC, mit der Sie Berechtigungen anpassen können. | MetaBots erzwingen gleiche Berechtigungen für alle Logik, selbst wenn mehrere Logik über verschiedene Ordner verteilt sind. |
MetaBot-Migrationsprozess
Das System erstellt einen Ordner mit dem gleichen Namen wie der MetaBot innerhalb des Ordners My MetaBots, der im Ordner Bots verfügbar ist. Die Ordnerstruktur von Enterprise 11 wird beibehalten. Wenn die Ordnerstruktur in Enterprise 11 beispielsweise Accounts/Tax/MetaTask.mbot lautet, behält das System die Ordnerstruktur als Accounts/Tax/MetaTask.mbot bei. Alle Komponenten eines MetaBots werden in dem dafür erstellten MetaBot-Ordner gespeichert. In diesem Beispiel erstellt das System den Ordner MetaTask im Ordner Bots\My MetaBots und speichert alle Komponenten des MetaBots in diesem Ordner.
Enterprise 10-Bots, die direkt DLLs und Screens in einem MetaBot aufrufen, ohne MetaBot-Logik zu verwenden, werden zu den entsprechenden TaskBots und Aktionen in Automation 360 migriert. Wenn in Enterprise 10 eine DLL Parameter vom Typ „Liste“ oder „Array“ zurückgibt und die Ausgabe dieser DLL mit einem Parameter vom Typ „Wert“ abgebildet wird, wird am Anfang des Ausgabewerts ein zusätzliches Leerzeichen hinzugefügt. Der zusätzliche Speicherplatz wird dem Ausgabewert nicht hinzugefügt, nach dem der Bot migriert ist.
Migration von DLLs
Das System behält die Ordnerstruktur für Assets nicht bei, um die Referenzen zwischen den DLLs zu erhalten. Im obigen Beispiel werden General.dll und Binary.dll im Ordner MetaTask gespeichert, obwohl Binaary.dll im DLL-Unterordner gespeichert ist.
Das folgende Video enthält Informationen zur Migration von MetaBots mit DLLs nach Automation 360:
Überblick über den MetaBot-Migrationsprozess
- Konzept der DLL-Sitzung im migrierten Bot
-
Folgende DLL-Änderungen treten im migrierten Bot auf:
- Wenn Sie einen TaskBot mit mehreren MetaBots migrieren, die DLLs mit demselben Namen enthalten, wird ein Sitzungsname mit dem Namen der ersten DLL erstellt. Wenn die nachfolgende DLL mit demselben Namen aus einem anderen MetaBot migriert wird, wird die ID des Ordners, in dem sich die DLL befindet, als Sitzungsname verwendet.
Beispiel:
M_DLL_Session-<MetabotFolderId>_<DLLName>.
- Wenn der Befehl DLL ausführen in Enterprise 11 nach Automation 360 migriert wird, wird der Befehl in die Aktionen Öffnen und Funktion ausführen und die If-Bedingung DLL-Sitzung existiert nicht konvertiert.
- Der Name der DLL-Sitzung wird durch Anhängen des DLL-Namens an das Token „M-DLL-Session-“ erstellt. Lautet der DLL-Name beispielsweise Sample.dll, lautet der DLL-Sitzungsname nach der Migration M-DLL-Session-Sample.
- Die DLL-Sitzung stellt die DLL dar, die zur Ausführung der DLL-Funktionen verwendet wird.
- Wenn Sie mehrere Funktionen über dieselbe DLL ausführen möchten, muss im Feld Sitzungsname derselbe DLL-Sitzungsname angegeben werden.
- Wenn Sie einen TaskBot mit mehreren MetaBots migrieren, die DLLs mit demselben Namen enthalten, wird ein Sitzungsname mit dem Namen der ersten DLL erstellt. Wenn die nachfolgende DLL mit demselben Namen aus einem anderen MetaBot migriert wird, wird die ID des Ordners, in dem sich die DLL befindet, als Sitzungsname verwendet.
- Bedingung für die Prüfung auf das Vorhandensein einer DLL-Sitzung in einem migrierten Bot
-
Wenn nach der Migration dieselbe DLL in mehreren Logiken desselben MetaBots verwendet wird, wird für jede DLL eine Bedingung hinzugefügt, um zu prüfen, ob bereits eine DLL-Sitzung geöffnet ist. So wird gewährleistet, dass die DLL-Sitzung nur einmal geöffnet wird. Einige DLLs, die in MetaBots verwendet werden, teilen sich Sitzungen oder globale Variablen über mehrere DLL-Funktionen hinweg. Wenn solche DLL-Funktionen von verschiedenen Logiken aus aufgerufen werden, ist die gemeinsame Nutzung solcher Sitzungen und Variablen nur möglich, wenn die DLL-Sitzung nur einmal geöffnet wird und eine Bedingung hinzugefügt wird, um zu prüfen, ob bereits eine DLL-Sitzung verfügbar ist. Wenn eine DLL-Sitzung fehlt, erstellt Automation 360 eine DLL-Sitzung vom Typ Global.
- Was geschieht mit einem migrierten TaskBot, der zwei DLL-Funktionen aus derselben oder aus verschiedenen Logiken eines MetaBots referenziert?
-
Wenn in Enterprise 11 ein TaskBot eine Logik referenziert hat, die zwei Funktionen mit dem Befehl Logik ausführen aufrief, wird in Automation 360 eine DLL-Sitzung in dem TaskBot erstellt (Logiken werden als TaskBots migriert) und in der Aktion Funktion ausführen verwendet. Wenn ein TaskBot mehrere Logiken referenziert, die mehrere Funktionen aufrufen, verwenden die TaskBots außerdem denselben DLL-Sitzungsnamen, um die Funktionen auszuführen. Mit der DLL-Sitzungsbedingungsprüfung wird gewährleistet, dass nur eine solche logikübergreifende Sitzung erstellt wird.
Wenn ein TaskBot beispielsweise MetaBot1-Logik und MetaBot2-Logik verwendet, wobei MetaBot1-Logik und MetaBot2-Logik mehrere Funktionen aufrufen, wird beim Ausführen des Taskbots ein DLL-Sitzungsname erstellt, um MetaBot1-Logik auszuführen. Der Name der DLL-Sitzung, die zur Ausführung von MetaBot1-Logik erstellt wurde, wird auch für MetaBot2-Logik verwendet.
Migration von Bildschirmen
Jeder Bildschirm in einem MetaBot wird in eine Windows-Variable konvertiert und die auf dem Bildschirm ausgeführten Aktionen werden zu den entsprechenden Aktionen in Automation 360 migriert.
Browser | Internet Explorer Google Chrome (nur für Objektwiedergabetyp) |
Bildschirmtyp | Standard |
Technologie | Java, HTML, MSAA, .Net, Nutzeroberflächenautomatisierung (nur für Objektwiedergabetyp) |
Wiedergabetyp | Objekt, Bild, Koordinate |
Sie können MetaBots auch mit Bildschirmen migrieren, die in der Citrix-Umgebung von Anwendungen erfasst werden, die auf Java, Benutzeroberflächenautomatisierungen und MSAA-Technologien basieren.
Die verknüpften Objekte auf einem MetaBot-Bildschirm, die mit dem Objektwiedergabetyp erfasst werden, werden zur Erfassen-Aktion des Recorder-Pakets migriert. Das Quellobjekt wird auf der Registerkarte Start und das verknüpfte Objekt auf der Registerkarte Anker der Aktion Erfassen angezeigt.
Wiedergabetyp | Aktion in Enterprise 11 | Aktion in Automation 360 |
---|---|---|
Objekt | Eigenschaft abrufen, Gesamtanzahl der Elemente abrufen, Ausgewählten Index abrufen, Ausgewählten Text abrufen, Element nach Text auswählen, Element nach Index auswählen, Klick, Linksklick, Rechtsklick, DoppelklickText setzen, Text anhängen, Eigenschaft abrufen, Aktivieren, Deaktivieren, Umschalten, Erweitern, Auswählen, Status abrufen, | Migriert zur Erfassen-Aktion des Recorder-Pakets. Die Befehle Namen aller untergeordneten Objekte abrufen und Werte aller untergeordneten Objekte abrufen in Enterprise 11/Enterprise 10 geben Variablenwerte vom Typ „Zeichenfolge“ zurück. In Automation 360 geben sie Listenwerte zurück. Im Migrationsprozess werden die Listenwerte zusammengeführt und in einer Zeichenfolgenvariablen gespeichert, um das Bot-Verhalten in allen Versionen einheitlich zu halten. Der Befehl Klonen von Objekten mit der Aktion In CSV-Datei exportieren in Enterprise 11/Enterprise 10 wird migriert zu:
|
Wiedergabetyp | Aktion in Enterprise 11 | Aktion in Automation 360 |
---|---|---|
Bild | Left Click | Migration zur Fenster in Fenster suchen-Aktion des Bilderkennung-Pakets mit Linksklick in der Liste Aktion ausgewählt. |
Right Click | Migration zur Fenster in Fenster suchen-Aktion des Bilderkennung-Pakets mit Rechtsklick in der Liste Aktion ausgewählt. | |
Doppelklick | Migration zur Fenster in Fenster suchen-Aktion des Bilderkennung-Pakets mit Doppelklick in der Liste Aktion ausgewählt. | |
Mittelklick | Migration zur Fenster in Fenster suchen-Aktion des Bilderkennung-Pakets mit Linksklick in der Liste Aktion ausgewählt. | |
Text festlegen | Migriert nach:
|
|
Text abrufen | Migriert zur Bereich erfassen-Aktion des OCR-Pakets. | |
GetVisibility | Migriert zu IF-Aktion mit Bedingung Bilderkennung:Fenster in Fenster suchen. Die Aktion GetVisibility gibt den Wert Wahr oder Falsch zurück, je nachdem, ob das Objekt in einem Bild sichtbar ist oder nicht. Auf ähnliche Weise wird die Bedingung innerhalb der IF-Aktion danach ausgewertet, ob das Fenster in einem anderen Fenster zu finden ist. Das Ergebnis wird in einer temporären Variablen gespeichert. |
Wiedergabetyp | Aktion in Enterprise 11 | Aktion in Automation 360 |
---|---|---|
Koordinate | Klick | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Linke Maustaste und Klick ausgewählt. |
Left Click | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Linke Maustaste und Klick ausgewählt. | |
Right Click | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Rechte Maustaste und Klick ausgewählt. | |
Mittelklick | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Mittlere Maustaste und Klick ausgewählt. | |
Doppelklick | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Linke Maustaste und Doppelklick ausgewählt. | |
Text festlegen | Migriert nach:
|
|
Text abrufen | Migriert nach:
|
Wiedergabetyp | Aktion in Enterprise 11 | Aktion in Automation 360 |
---|---|---|
Koordinate | Klick | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Linke Maustaste und Klick ausgewählt. |
Left Click | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Linke Maustaste und Klick ausgewählt. | |
Mittelklick | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Mittlere Maustaste und Klick ausgewählt. | |
Doppelklick | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Linke Maustaste und Doppelklick ausgewählt. | |
Text festlegen | Migriert zu:
|
|
Text abrufen | Migriert zu:
|
Wiedergabetyp | Aktion in Enterprise 11 | Aktion in Automation 360 |
---|---|---|
Text | Klick | Migration zur Aktion Fenster in Fenster suchen des Bilderkennung-Paketmit Linksklick, dass aus der Liste Aktion ausgewählt wurde. |
Left Click | Migration zur Aktion Fenster in Fenster suchen des Bilderkennung-Paketmit Linksklick, dass aus der Liste Aktion ausgewählt wurde. | |
Doppelklick | Migration zur Aktion Fenster in Fenster suchen des Bilderkennung-Paket mit Doppelklick, dass aus der Liste Aktion ausgewählt wurde. | |
Text festlegen | Migriert zu:
|
|
Text abrufen | Migriert zur Bereich erfassen-Aktion des OCR-Pakets. |
Migration der Logik
Jede Logik in einem MetaBot wird in einen TaskBot konvertiert und jeder in einer Logik verwendete Befehl wird in Automation 360 in die entsprechende Aktion konvertiert. Die in einer Logik verwendete Variable wird in Automation 360 in eine äquivalente Variable konvertiert. In der Logik verwendete Anmeldedatenvariablen werden zu Automation 360 migriert und in den entsprechenden Aktionen in den migrierten Bots verwendet. Wenn der Parametertyp einer Variablen ein- oder ausgegeben wird, wird dies beibehalten, nachdem diese Variable nach Automation 360 migriert wurde. Wenn beispielsweise der Parametertyp der Variablen ABC als Eingabe festgelegt ist, wird für die in Automation 360 erstellte Variable ABC nach der Migration die Option Als Eingabe verwenden ausgewählt. Das System behält die interne Ordnerstruktur der Logiken bei. Für das obige Beispiel werden alle migrierten Logiken wie in der folgenden Tabelle aufgeführt gespeichert:
Ordnerstruktur in Automation 360 | Eintrag |
---|---|
MetaTask | Allgemein |
MetaTask\Process1 | Verbinden |
MetaTask\Process1 | Trennen |
MetaTask\Process1\Operations | Numeric |
Wiedergabetyp | Aktion in Enterprise 11 | Aktion in Automation 360 |
---|---|---|
Objekt | Eigenschaft abrufen, Gesamtanzahl der Elemente abrufen, Ausgewählten Index abrufen, Ausgewählten Text abrufen, Element nach Text auswählen, Element nach Index auswählen, Klick, Linksklick, Rechtsklick, Doppelklick | Migriert zur Erfassen-Aktion des Recorder-Pakets. |
Bild | Left Click | Migration zur Fenster in Fenster suchen-Aktion des Bilderkennung-Pakets mit Linksklick in der Liste Aktion ausgewählt. |
Right Click | Migration zur Fenster in Fenster suchen-Aktion des Bilderkennung-Pakets mit Rechtsklick in der Liste Aktion ausgewählt. | |
Doppelklick | Migration zur Fenster in Fenster suchen-Aktion des Bilderkennung-Pakets mit Doppelklick in der Liste Aktion ausgewählt. | |
Mittelklick | Migration zur Fenster in Fenster suchen-Aktion des Bilderkennung-Pakets mit Linksklick in der Liste Aktion ausgewählt. | |
Text festlegen | Migriert nach:
|
|
Koordinate | Klick | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Linke Maustaste und Klick ausgewählt. |
Left Click | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Linke Maustaste und Klick ausgewählt. | |
Mittelklick | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Mittlere Maustaste und Klick ausgewählt. | |
Doppelklick | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Linke Maustaste und Doppelklick ausgewählt. | |
Text festlegen | Migriert nach:
|
Wiedergabetyp | Aktion in Enterprise 11 | Aktion in Automation 360 |
---|---|---|
Objekt | Eigenschaft abrufen, Gesamtanzahl der Elemente abrufen, Ausgewählten Index abrufen, Ausgewählten Text abrufen, Element nach Text auswählen, Element nach Index auswählen, Klick, Linksklick, Rechtsklick, Doppelklick | Migriert zur Erfassen-Aktion des Recorder-Pakets. |
Bild | Left Click | Migration zur Fenster in Fenster suchen-Aktion des Bilderkennung-Pakets mit Linksklick in der Liste Aktion ausgewählt. |
Right Click | Migration zur Fenster in Fenster suchen-Aktion des Bilderkennung-Pakets mit Rechtsklick in der Liste Aktion ausgewählt. | |
Doppelklick | Migration zur Fenster in Fenster suchen-Aktion des Bilderkennung-Pakets mit Doppelklick in der Liste Aktion ausgewählt. | |
Mittelklick | Migration zur Fenster in Fenster suchen-Aktion des Bilderkennung-Pakets mit Linksklick in der Liste Aktion ausgewählt. | |
Text abrufen | Migriert zur Bereich erfassen-Aktion des OCR-Pakets. | |
Koordinate | Klick | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Linke Maustaste und Klick ausgewählt. |
Left Click | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Linke Maustaste und Klick ausgewählt. | |
Mittelklick | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Mittlere Maustaste und Klick ausgewählt. | |
Doppelklick | Migriert zur Klick-Aktion des Maus-Pakets mit den Optionen Linke Maustaste und Doppelklick ausgewählt. | |
Text abrufen | Migriert nach:
|
Migration des Befehls „Logik ausführen“
Der Befehl Logik ausführen wird in einem Bot verwendet, um eine bestimmte Logik aus einem MetaBot in Enterprise 11 auszuführen. Wenn Sie diesen Bot migrieren, wird der Befehl Logik ausführen in die Aktion Ausführen des TaskBot-Pakets konvertiert.
Die Eingabevariablen werden in entsprechende Variablen in Automation 360 konvertiert und die Ausgabevariablen in eine Wörterbuchvariable migriert. Um den zugehörigen Wert zu verwenden, verwenden Sie den Schlüssel der Wörterbuchvariablen. Die Wörterbuchvariable kann andere Variablentypen enthalten, z. B. Liste, Wert, Ganzzahl und Array. Sie können die in der Wörterbuchvariablen verfügbaren Variablen anderen Variablentypen zuordnen. So können Sie beispielsweise die in der Wörterbuchvariablen verfügbare Variable vom Typ „Liste“ den Variablen vom Typ „Liste“, „Wert“ und „Array“ zuordnen.
Migration des Befehls „Ausführen“
Die DLLs in MetaBots verwenden den Befehl Ausführen, um eine Funktion aus dieser DLL auszuführen. Nach der Migration zu Automation 360 wird jeder Ausführen-Befehl in die Aktionen Öffnen, Funktion ausführen und Schließen des DLL-Pakets konvertiert. Welche Funktion aus der DLL ausgeführt und welche Parameter verwendet werden sollen sowie weitere Informationen aus dem Befehl Ausführen werden zur Aktion Ausführen migriert.
MetaBot-Variablentyp | Rückgabetyp der DLL-Funktion |
---|---|
Wert | Zweidimensionales Array, Liste, Byte in Array (Byte[]), vorzeichenlose Ganzzahlen (UInt32, UInt64), vorzeichenbehaftete Ganzzahlen, IDictionary, IList und vorzeichenlose Ganzzahlen im Array (UInt16[], UInt32[], UInt64[]), vorzeichenbehaftetes Byte |
Array | Zweidimensionales Array, Liste, vorzeichenlose Ganzzahlen (UInt16[], UInt32, UInt64), vorzeichenbehaftete Ganzzahlen, IList, vorzeichenbehaftetes Byte und IDictionary |
Variablentyp des MetaBots | Typ der Eingabevariablen, den die DLL akzeptiert |
---|---|
Liste | Zweidimensionales Array, Liste, Byte, vorzeichenlose Ganzzahlen (UInt16, UInt32, UInt64), vorzeichenbehaftete Ganzzahlen, vorzeichenbehaftete Byte, Byte in Array (Byte[]) und vorzeichenlose Ganzzahlen in Array (UInt16[], UInt32[], UInt64[]) |
Array | Zweidimensionales Array, Liste, Byte, vorzeichenlose Ganzzahlen (UInt16, UInt32, UInt64), vorzeichenbehaftete Ganzzahlen, vorzeichenbehaftete Byte, Byte in Array (Byte[]) und vorzeichenlose Ganzzahlen in Array (UInt16[], UInt32[], UInt64[]) |
Wert | Byte, vorzeichenlose Ganzzahlen (UInt16, UInt32, UInt64), Ganzzahlen mit Vorzeichen, Byte mit Vorzeichen |
Wörterbuch | Byte, vorzeichenlose Ganzzahlen (UInt16, UInt32, UInt64), Ganzzahlen mit Vorzeichen, Byte mit Vorzeichen |