La migration des MetaBots
- Dernière mise à jour2022/12/04
La migration des MetaBots
Lorsque vous migrez un MetaBot vers Automation 360, des équivalents robots sont créés pour les diverses logiques disponibles dans le MetaBot, à l’exception des écrans d’application. Après une migration réussie, chaque logique d'un fichier .mbot est convertie en fichier Bot de tâche.
Un MetaBot contient des actifs et une logique. Les actifs sont les écrans d’application ou DLL utilisés pour automatiser une tâche sur une application. La logique est un ensemble de commandes pour effectuer une opération et interagir avec d’autres logiques et robots.
- Avant de migrer un .atmx ou un .mbot à l'aide de Assistant de Migration de Bot, assurez-vous que tous les fichiers Logics, dlls, .mbots, .atmx et autres dépendances liés aux MetaBots ou aux Robots de tâches qui ont été précédemment migrés ne sont pas à l'état Extrait. Sinon, l'erreur suivante se produit pendant la nouvelle migration :
Le robot n'est pas prêt pour la migration.
- Si le robot que vous migrez a été extrait ou précédemment migré, assurez-vous que le robot qui doit être migré est à l'état Archivé. De même, pour réutiliser le robot migré, dans Assistant de Migration de Bot, sélectionnez l'option Écraser si un robot avec le même nom existe. Pour utiliser un robot mis à jour, désactivez l'option Écraser si un robot avec le même nom existe.
- Convertit la logique MetaBot en Robots de tâches correspondants.
- Maintient la structure de dossiers des MetaBots après leur migration. Les nouveaux dossiers créés dans Automation 360 contiennent les Robots de tâches pour chaque logique migrée vers Automation 360.
- Met à jour les Robots de tâches qui utilisent la logique MetaBot pour faire référence aux nouveaux Robots de tâches créés pour la logique MetaBot migrée.
La mise à jour manuelle des Robots de tâches n'est pas nécessaire.
Les fonctionnalités telles que l'utilisation des DLL, des variables d'entrée et de sortie et l'autorisation Exécuter qui étaient uniquement disponibles pour les MetaBots sont désormais disponibles pour tous les Robots de tâches.
- Nom du MetaBot : Méta-tâche
- Actifs :
- Écran de connexion
- General.dll
- DLL\Binary.dll
- Logique :
- Common
- Process1\Connect
- Process1\Disconnect
- Process1\Operations\Numeric
Avantages de la réutilisation de Robots de tâches dans Automation 360
Automation 360 réutilisable(s) Robots de tâches | MetaBots v11 |
---|---|
Vous pouvez naviguer vers un robot enfant en moins de clics à l'aide du composant Finder, ce qui vous fait gagner du temps. Accédez à pour atteindre le robot enfant. | Vous devez passer par robot enfant. | pour atteindre le
Vous pouvez rechercher le robots enfant à partir de l'espace de travail privé, ainsi que de l'espace de travail public pour les utiliser dans Robots de tâches. | Vous devez télécharger le MetaBots dans le référentiel local pour utiliser un robot enfant dans le Robots de tâches. |
Seul un spécifique Logique est déployé lorsqu'il est utilisé dans une tâche, ce qui permet d'économiser du temps et de la bande passante. | L'ensemble de MetaBot est déployé sur la machine Bot Runner même si un seul Logique est utilisé dans la tâche. |
Fournit un meilleur RBAC, qui vous permet de personnaliser les autorisations. | MetaBots force tous les Logique à avoir les mêmes autorisations, même si plusieurs Logique sont répartis dans différents dossiers. |
Processus de migration d’un MetaBot
Le système crée un dossier avec le même nom que le MetaBot dans le dossier My MetaBots disponible dans le dossier Bots, et la même structure de dossiers que celle de Enterprise 11 est conservée. Par exemple, si la structure de dossiers dans Enterprise 11 est Accounts/Tax/MetaTask.mbot, le système conserve la structure de dossiers sous Accounts/Tax/MetaTask.mbot. Tous les composants d’un MetaBot sont stockés dans le dossier créé pour ce MetaBot. Dans cet exemple, le système crée le dossier MetaTask dans le dossier Bots\My MetaBots et stocke tous les composants du MetaBot dans ce dossier.
Les robots Enterprise 10 qui appellent directement les DLL et les écrans dans un MetaBot sans utiliser la logique de MetaBot sont migrés vers les Robots de tâches équivalents et les actions dans Automation 360. Dans Enterprise 10, si une DLL qui renvoie des paramètres de type liste ou tableau, et que la sortie de cette DLL est mappée avec un paramètre de type valeur, un espace supplémentaire est ajouté au début de la valeur de sortie. L'espace supplémentaire n'est pas ajouté à la valeur de sortie après la migration de robot.
Migration des DLL
Le système ne conserve pas la structure de dossiers pour les actifs afin de conserver les références entre les DLL. Pour l'exemple ci-dessus, General.dll et Binary.dll sont stockés dans le dossier MetaTask bien que Binaary.dll soit stocké dans le sous-dossier DLL.
Regardez la vidéo suivante pour des informations sur la migration de MetaBots avec les DLL vers Automation 360 :
Aperçu du processus de migration d'un MetaBot
- Concept de session DLL dans le robot migré
-
Les changements de DLL suivants sont observés dans la version du robot migré :
- Lorsque vous migrez un Bot de tâche avec plusieurs MetaBots qui contiennent des DLL portant le même nom, un nom de session utilisant le nom de la première DLL est créé. Lors de la migration de la DLL suivante portant le même nom et provenant d'un autre MetaBot, l'ID du dossier dans lequel réside la DLL est utilisé comme nom de session.
Par exemple :
M_DLL_Session-<MetabotFolderId>_<DLLName>.
- Lorsque la commande Exécuter DLL dans Enterprise 11 est migrée vers Automation 360. La commande est convertie en action Ouvrir et Exécuter la fonction et en condition If La session DLL n'existe pas.
- Le nom de la session DLL est créé en ajoutant le nom de la DLL au jeton « M-DLL-Session- ». Par exemple, si le nom de la DLL est Sample.dll, après la migration, le nom de la session DLL devient M-DLL-Session-Sample.
- La session DLL représente la DLL qu'elle utilise pour exécuter les fonctions DLL.
- Pour exécuter plusieurs fonctions à partir d'une même DLL, le même nom de session DLL doit être fourni dans le champ Nom de session.
- Lorsque vous migrez un Bot de tâche avec plusieurs MetaBots qui contiennent des DLL portant le même nom, un nom de session utilisant le nom de la première DLL est créé. Lors de la migration de la DLL suivante portant le même nom et provenant d'un autre MetaBot, l'ID du dossier dans lequel réside la DLL est utilisé comme nom de session.
- Condition pour vérifier l'existence d'une session DLL dans un robot migré
-
Après la migration, lorsque la même DLL est utilisée dans plusieurs logiques du même MetaBot, une condition permettant de vérifier si une session DLL est déjà ouverte est ajoutée pour chaque DL afin de garantir que la session DLL n'est ouverte qu'une seule fois. Certaines DLL qui sont utilisées dans un MetaBot partagent des sessions ou des variables globales entre plusieurs fonctions DLL. Si ces fonctions DLL sont appelées à partir de différentes logiques, le partage de ces sessions et variables n'est possible que si la session DLL n'est ouverte qu'une seule fois et qu'une condition est ajoutée pour vérifier si une session DLL est déjà disponible. Si une session DLL est manquante, Automation 360 crée une session DLL de type Global.
- Qu'arrive-t-il à un Bot de tâche migré qui fait référence à deux fonctions DLL provenant de logiques identiques ou différentes d'un MetaBot ?
-
Dans Enterprise 11, si un Bot de tâche fait référence à une logique qui appelle deux fonctions à l'aide de la commande Exécuter la logique, dans Automation 360, une session DLL est créée dans le Bot de tâche (les logiques sont migrées en tant que Robots de tâches) et est utilisée dans l'action Exécuter la fonction. De même, lorsqu'un Bot de tâche fait référence à plusieurs logiques qui appellent plusieurs fonctions, les Robots de tâches utilisent le même nom de session DLL pour exécuter les fonctions. Le contrôle de la condition de la session DLL garantit qu'une seule session est créée dans ces logiques.
Par exemple, si un Bot de tâche utilise Logique MetaBot1 et Logique MetaBot2 où Logique MetaBot1 et Logique MetaBot2 appellent plusieurs fonctions, lorsque vous exécutez le Taskbot, un nom de session DLL est créé pour exécuter Logique MetaBot1. Le nom de session DLL qui a été créé pour exécuter Logique MetaBot1 est également utilisé pour exécuter Logique MetaBot2.
Migration des écrans
Chaque écran d'un MetaBot est converti en variable de fenêtre et les actions effectuées sur l'écran sont migrées vers les actions équivalentes dans Automation 360.
Navigateur | Internet Explorer Google Chrome (pour le type de lecture Objet uniquement) |
Type d'écran | Standard |
Technologie | Java, HTML, MSAA, .Net, UI Automation (pour le type de lecture Objet uniquement) |
Type de lecture | « Objet », « Image », « Coordonnée » |
Vous pouvez également migrer MetaBots avec des écrans capturés dans l'environnement Citrix à partir d'applications basées sur les technologies Java, UI Automation et MSAA.
Les objets liés d'un écran de MetaBot capturés à l'aide du type de lecture Objet sont migrés vers l'action Capture du package Enregistreur. L'objet source s'affiche dans l'onglet Principal et l'objet lié s'affiche dans l'onglet Ancrage de l'action Capture.
Type de lecture | Action Enterprise 11 | Action Automation 360 |
---|---|---|
Objet | Obtenir la propriété, Obtenir le total des éléments, Obtenir l'index sélectionné, Obtenir le texte sélectionné, Sélectionner l'élément par texte, Sélectionner l'élément par index, Cliquer, Clic gauche, Clic droit, Double-clic, Définir le texte, Ajouter du texte, Obtenir la propriété, Cocher, Décocher, Basculer, Développer, Sélectionner, Obtenir le statut, | Migration vers l'action Capture du package Enregistreur. Les commandes GetAllChildrenName et GetAllChildrenValue dans Enterprise 11/Enterprise 10 renvoient des valeurs de variable de type chaîne. Dans Automation 360, elles renvoient des valeurs de liste. Le processus de migration associe les valeurs de la liste et les stocke dans une variable de chaîne pour maintenir la cohérence du comportement des robots dans l’ensemble des versions. La commande Clonage d'objet avec l'action Exporter vers CSV dans Enterprise 11/Enterprise 10 est migrée vers :
|
Type de lecture | Action Enterprise 11 | Action Automation 360 |
---|---|---|
Image | Clic gauche | Migré vers l'action Rechercher la fenêtre dans la fenêtre du package Reconnaissance des images avec le Clic gauche sélectionné dans la liste Action. |
Right Click | Migré vers l'action Rechercher la fenêtre dans la fenêtre du package Reconnaissance des images avec le Clic droit sélectionné dans la liste Action. | |
Double-clic | Migré vers l'action Rechercher la fenêtre dans la fenêtre du package Reconnaissance des images avec le Double-clic sélectionné dans la liste Action. | |
Clic du milieu | Migré vers l'action Rechercher la fenêtre dans la fenêtre du package Reconnaissance des images avec le Clic gauche sélectionné dans la liste Action. | |
Définir le texte | Migré vers :
|
|
Obtenir le texte | Migré vers l'action Capturer la zone du package ROC. | |
GetVisibility | Migré vers l'action SI avec la condition Reconnaissance des images :Rechercher une fenêtre dans une fenêtre. L'action GetVisibility renvoie une valeur Vrai ou Faux selon que l'objet dans une image est visible ou non. De même, la condition dans l'action SI est évaluée en fonction de la présence ou non de la fenêtre dans une autre fenêtre. Le résultat est stocké dans une variable temporaire. |
Type de lecture | Action Enterprise 11 | Action Automation 360 |
---|---|---|
Coordonnées | Cliquer | Migré vers l'action Cliquer du package Souris avec les options Bouton gauche et Cliquer sélectionnées. |
Clic gauche | Migré vers l'action Cliquer du package Souris avec les options Bouton gauche et Cliquer sélectionnées. | |
Right Click | Migré vers l'action Cliquer du package Souris avec les options Bouton droit et Cliquer sélectionnées. | |
Clic du milieu | Migré vers l'action Cliquer du package Souris avec les options Bouton du milieu et Cliquer sélectionnées. | |
Double-clic | Migré vers l'action Cliquer du package Souris avec les options Bouton gauche et Double-cliquer sélectionnées. | |
Définir le texte | Migré vers :
|
|
Obtenir le texte | Migré vers :
|
Type de lecture | Action Enterprise 11 | Action Automation 360 |
---|---|---|
Coordonnées | Cliquer | Migré vers l'action Cliquer du package Souris avec les options Bouton gauche et Cliquer sélectionnées. |
Clic gauche | Migré vers l'action Cliquer du package Souris avec les options Bouton gauche et Cliquer sélectionnées. | |
Clic du milieu | Migré vers l'action Cliquer du package Souris avec les options Bouton du milieu et Cliquer sélectionnées. | |
Double-clic | Migré vers l'action Cliquer du package Souris avec les options Bouton gauche et Double-cliquer sélectionnées. | |
Définir le texte | Migré vers :
|
|
Obtenir le texte | Migré vers :
|
Type de lecture | Action Enterprise 11 | Action Automation 360 |
---|---|---|
Texte | Cliquer | Migré vers l'Rechercher la fenêtre dans la fenêtre actiondu package Reconnaissance des images avec le Bouton gauche sélectionné dans la liste Action. |
Clic gauche | Migré vers l'Rechercher la fenêtre dans la fenêtre actiondu package Reconnaissance des images avec le Bouton gauche sélectionné dans la liste Action. | |
Double-clic | Migré vers l'Rechercher la fenêtre dans la fenêtre action du package Reconnaissance des images avec le Bouton de double-clic sélectionné dans la liste Action. | |
Définir le texte | Migré vers :
|
|
Obtenir le texte | Migré vers l'action Capturer la zone du package ROC. |
Migration de la logique
Chaque logique d’un MetaBot est convertie en Bot de tâche et chaque commande utilisée dans une logique est convertie en action équivalente dans Automation 360. La variable utilisée dans une logique est convertie en une variable équivalente dans Automation 360. Les variables d'informations d'identification utilisées dans la logique sont migrées vers Automation 360 et utilisées dans les actions équivalentes des robots migrés. Si le Type de paramètre d'une variable est entrée ou sortie, le même est maintenu après la migration de cette variable vers Automation 360. Par exemple, si le Type de paramètre de la variable ABC est défini comme Entrée, la variable ABC créée dans Automation 360 a l'option Utiliser comme entrée sélectionnée après sa migration. Le système conserve la structure de dossiers interne des logiques. Pour l’exemple ci-dessus, toutes les logiques migrées sont stockées comme indiqué dans le tableau suivant :
Structure des dossiers dans Automation 360 | Entrée |
---|---|
MetaTask | Fréquent |
MetaTask\Process1 | Se connecter |
MetaTask\Process1 | Déconnecter |
MetaTask\Process1\Operations | Numérique |
Type de lecture | Action Enterprise 11 | Action Automation 360 |
---|---|---|
Objet | Obtenir la propriété, Obtenir le total des éléments, Obtenir l’index sélectionné, Obtenir le texte sélectionné, Sélectionner l’élément par texte, Sélectionner l’élément par index, Cliquer, Clic gauche, Clic droit, Double-clic | Migration vers l'action Capture du package Enregistreur. |
Image | Clic gauche | Migré vers l'action Rechercher la fenêtre dans la fenêtre du package Reconnaissance des images avec le Clic gauche sélectionné dans la liste Action. |
Right Click | Migré vers l'action Rechercher la fenêtre dans la fenêtre du package Reconnaissance des images avec le Clic droit sélectionné dans la liste Action. | |
Double-clic | Migré vers l'action Rechercher la fenêtre dans la fenêtre du package Reconnaissance des images avec le Double-clic sélectionné dans la liste Action. | |
Clic du milieu | Migré vers l'action Rechercher la fenêtre dans la fenêtre du package Reconnaissance des images avec le Clic gauche sélectionné dans la liste Action. | |
Définir le texte | Migré vers :
|
|
Coordonnées | Cliquer | Migré vers l'action Cliquer du package Souris avec les options Bouton gauche et Cliquer sélectionnées. |
Clic gauche | Migré vers l'action Cliquer du package Souris avec les options Bouton gauche et Cliquer sélectionnées. | |
Clic du milieu | Migré vers l'action Cliquer du package Souris avec les options Bouton du milieu et Cliquer sélectionnées. | |
Double-clic | Migré vers l'action Cliquer du package Souris avec les options Bouton gauche et Double-cliquer sélectionnées. | |
Définir le texte | Migré vers :
|
Type de lecture | Action Enterprise 11 | Action Automation 360 |
---|---|---|
Objet | Obtenir la propriété, Obtenir le total des éléments, Obtenir l’index sélectionné, Obtenir le texte sélectionné, Sélectionner l’élément par texte, Sélectionner l’élément par index, Cliquer, Clic gauche, Clic droit, Double-clic | Migration vers l'action Capture du package Enregistreur. |
Image | Clic gauche | Migré vers l'action Rechercher la fenêtre dans la fenêtre du package Reconnaissance des images avec le Clic gauche sélectionné dans la liste Action. |
Right Click | Migré vers l'action Rechercher la fenêtre dans la fenêtre du package Reconnaissance des images avec le Clic droit sélectionné dans la liste Action. | |
Double-clic | Migré vers l'action Rechercher la fenêtre dans la fenêtre du package Reconnaissance des images avec le Double-clic sélectionné dans la liste Action. | |
Clic du milieu | Migré vers l'action Rechercher la fenêtre dans la fenêtre du package Reconnaissance des images avec le Clic gauche sélectionné dans la liste Action. | |
Obtenir le texte | Migré vers l'action Capturer la zone du package ROC. | |
Coordonnées | Cliquer | Migré vers l'action Cliquer du package Souris avec les options Bouton gauche et Cliquer sélectionnées. |
Clic gauche | Migré vers l'action Cliquer du package Souris avec les options Bouton gauche et Cliquer sélectionnées. | |
Clic du milieu | Migré vers l'action Cliquer du package Souris avec les options Bouton du milieu et Cliquer sélectionnées. | |
Double-clic | Migré vers l'action Cliquer du package Souris avec les options Bouton gauche et Double-cliquer sélectionnées. | |
Obtenir le texte | Migré vers :
|
Migration de la commande « Exécuter la logique »
La commande Exécuter la logique est utilisée dans un robot pour exécuter une logique spécifique à partir d'un MetaBot dans Enterprise 11. Lorsque vous migrez ce robot, la commande Exécuter la logique est convertie en action Exécuter du package Robot de tâches.
Les variables d’entrée sont converties en variables équivalentes dans Automation 360 et les variables de sortie sont migrées vers une variable de dictionnaire. Utilisez la clé dans la variable de dictionnaire pour utiliser la valeur associée. La variable de dictionnaire peut contenir d'autres types de variables, par exemple, liste, valeur, nombre entier et tableau. Vous pouvez mapper les variables disponibles dans la variable de dictionnaire avec d'autres types de variables. Par exemple, vous pouvez mapper la variable de type liste disponible dans la variable dictionnaire avec les variables de type liste, valeur et tableau.
Migration de la commande « Exécuter »
Les DLL dans les MetaBots utilisent la commande Exécuter pour exécuter une fonction à partir de cette DLL. Après la migration vers Automation 360, chaque commande Exécuter est convertie en actions Ouvrir, Exécuter la fonction et Fermer du package DLL. Les informations sur la fonction à exécuter à partir de DLL, les paramètres à utiliser et d'autres détails dans la commande Exécuter sont migrés vers l'action Exécuter.
Type de variable MetaBot | Type de retour de fonction DLL |
---|---|
Valeur | Tableau bidimensionnel, Liste, Octet dans tableau (Byte[]), nombres entiers non signés (UInt32, UInt64), nombres entiers signés, IDictionnaire, IList et nombres entiers non signés dans tableau (UInt16[], UInt32[], UInt64[]), Byte signé |
Tableau | Tableau bidimensionnel, Liste, nombres entiers non signés (UInt16[], UInt32, UInt64), nombres entiers signés, IList, octet signé et IDictionnaire |
Type de variable de MetaBot | Type de variable d’entrée accepté par DLL |
---|---|
Liste | Tableau bidimensionnel, liste, octet, nombres entiers non signés (UInt16, UInt32, UInt64), nombres entiers signés, octet signé, octet dans le tableau (Byte[]), et nombres entiers non signés dans le tableau (UInt16[], UInt32[], UInt64[]) |
Tableau | Tableau bidimensionnel, liste, octet, nombres entiers non signés (UInt16, UInt32, UInt64), nombres entiers signés, octet signé, octet dans le tableau (Byte[]), et nombres entiers non signés dans le tableau (UInt16[], UInt32[], UInt64[]) |
Valeur | Octet, nombres entiers non signés (UInt16, UInt32, UInt64), nombres entiers signés, Byte signés |
Dictionnaire | Octet, nombres entiers non signés (UInt16, UInt32, UInt64), nombres entiers signés, Byte signés |