Analyser le rapport du Bot Scanner pour la migration
- Dernière mise à jour2022/12/27
Analyser le rapport du Bot Scanner pour la migration
Vous pouvez analyser le rapport produit par le Bot Scanner pour obtenir des informations sur les robots (Robots de tâches et MetaBots) et les processus pouvant être migrés. Utilisez le Bot Scanner pour déterminer si vous êtes prêt à démarrer la migration maintenant ou si vous préférez attendre que davantage de commandes soient prises en charge.
Le rapport Bot Scanner fournit les informations suivantes :
-
Robots : dans le rapport Bot Scanner, un robot est un Bot de tâche (.atmx) ou un MetaBot (.mbot) unique qui est utilisé dans d'autres robots.
L'onglet Robots fournit des informations détaillées sur les robots qui peuvent être migrés, ceux qui nécessitent une action ou une vérification, et ceux qui ne peuvent pas être migrés.
- Processus : dans le rapport Bot Scanner, un processus est un robot qui n'est pas utilisé dans d'autres robots et peut comprendre un ou plusieurs robots enfants.
L'onglet Processus fournit des informations détaillées sur les processus qui peuvent être migrés, ceux qui nécessitent une action ou une vérification, et ceux qui ne peuvent pas être migrés.
- Nombre de robots et de processus analysés
- Un résumé de haut niveau sous forme de tableaux pour indiquer le statut de la migration des robots et des processus
- Nombre de robots et de processus que vous pouvez et ne pouvez pas migrer vers Automation 360
- Commandes utilisées dans les robots et fréquence d'utilisation
- Raisons pour lesquelles les robots et les processus ne peut pas être migrés actuellement et fréquence de ces occurrences
- Actions et vérifications requises par les utilisateurs après la migration en raison d'un changement de comportement des commandes
- Robots et processus qui ne peuvent pas être migrés et leurs messages d'erreur correspondants
- Nombre de lignes dans les robots et nombre total de lignes de chacun des robots associés à un processus
- Numéro de ligne pour chacun des robots et processus qui nécessitent une vérification ou une action
La plupart des fonctionnalités Enterprise 10 ou Enterprise 11 sont disponibles en tant que telles ; cependant, certaines fonctionnalités sont mises en œuvre différemment pour prendre en charge les opérations Web (sans client). Pour ces fonctionnalités, vous devez modifier la manière dont les robots sont écrits.
Le Bot Scanner est conçu pour analyser robots (Robots de tâches et MetaBots) créés à l’aide des versions Enterprise 10 et Enterprise 11 de Client Enterprise. Le nombre total de fichiers inclut le nombre de fichiers ignorés et non analysés.
Les rapports sont disponibles à l'emplacement de sortie que vous avez spécifié dans le champ Sélectionner le dossier de destination de la boîte de dialogue Automation Anywhere Bot Scanner. Le Bot Scanner génère un rapport de synthèse (summary.html) et un fichier XML distinct pour chaque robot analysé. Il crée un rapport distinct pour chaque logique disponible dans un MetaBot.
Un dossier raw-data contenant les rapports (au format XML) de chaque robot analysé est créé. Il aide nos ingénieurs à analyser davantage le processus de migration et à prendre des mesures correctives, si nécessaire. Aucune information personnellement identifiable (PII) n’est incluse dans le rapport récapitulatif ou les rapports individuels des robots analysés.
Si vous choisissez de partager les rapports avec nous afin d'améliorer le produit, compressez les fichiers dans le dossier raw-data et coordonnez-vous avec votre Customer Success Manager (CSM) ou Partner Enablement Manager (PEM). Aucune donnée n’est automatiquement partagée avec Automation Anywhere.
Rapport récapitulatif pour tous les robots
- Si vous pouvez migrer vers Automation 360
- Nombre total des robots analysés
- Rapport des robots uniquement qui fournit des informations sur les robots pris en charge pour la migration vers Automation 360 (en pourcentage)
- Rapport des processus uniquement qui fournit des informations sur les processus pris en charge pour la migration vers Automation 360
- robots et processus combinés qui fournit des informations sur les robots et les processus pris en charge pour la migration vers Automation 360
Par exemple, considérons que le Bot Scanner a scanné 10 robots. Sur les 10 robots, si 8 robots sont prêts pour la migration vers Automation 360, 80 % des robots peuvent être migrés et 20 % des robots ne peuvent pas encore l'être.
- Identifiez les actions et les vérifications à effectuer pour les 5 % de robots restants afin que vous puissiez migrer avec succès une majorité de vos robots et que vous les exécutiez dans Automation 360 après la migration.
- identifier les robots qui peuvent être migrés vers Automation 360 sans intervention manuelle ;
- identifier la raison pour laquelle 2 % des robots ne peuvent pas être migrés actuellement et le temps estimé pour une migration ultérieure. Cela peut être lié à des commandes et des variables non encore prises en charge dans Automation 360.
- Cliquez sur l'onglet Processus.
- Cliquez sur l'onglet Messages que vous voulez examiner.
- Dans la colonne Référence de la tâche principale, cliquez sur l'icône Développer (
) pour afficher le processus. - Cliquez sur le nom d'un processus pour afficher le message.
- identifier les actions et les vérifications à effectuer pour les 15 processus restants afin que vous puissiez migrer avec succès une majorité de vos processus et les utiliser dans Automation 360 après la migration ;
- identifier les processus qui peuvent être migrés vers Automation 360 sans intervention manuelle ;
- identifier la raison pour laquelle 1 processus ne peut pas être migré actuellement et le temps estimé pour une migration ultérieure.
Cela peut être lié à des commandes et des variables non encore prises en charge dans Automation 360.
L'image suivante est un exemple de rapport du Bot Scanner :
Le tableau suivant décrit les différents champs de l'exemple du rapport Bot Scanner (tel que numéroté dans l'image précédente) :
| Champ/option | Description |
|---|---|
| 1 | Fournit un résumé et le statut de préparation à la migration de vos robots. Examinez le statut de la migration en fonction des éléments suivants :
|
| 2 | Fournit un résumé des informations suivantes pour les robots :
|
| 3 | Fournit des ressources supplémentaires pour faciliter le processus de migration. |
| 4 | Fournit un résumé des informations suivantes pour les processus :
|
| 5 |
Remarque : chaque message contient des informations que vous devez passer en revue après la migration. Pour obtenir une liste de ces messages, voir . Utilisez le code du message (par exemple
R102) pour afficher rapidement le message spécifique. |
| 6 |
ou : Accédez à cette vue pour obtenir la liste des robots ou des processus qui nécessitent une action après la migration vers Automation 360.
Remarque : chaque message contient des informations que vous devez passer en revue après la migration. Pour obtenir une liste de ces messages, voir . Utilisez le code du message (par exemple
R102) pour afficher rapidement le message spécifique. |
| 7 |
Cliquez sur le code du message pour afficher les informations sur les changements de comportement d'Automation 360 pour la commande par rapport au comportement d'Enterprise 11 ou d'Enterprise 10. Remarque : chaque message contient des informations que vous devez passer en revue après la migration. Pour obtenir une liste de ces messages, voir . Utilisez le code du message (par exemple
R102) pour afficher rapidement le message spécifique. |
| 8 | ou : accédez à cette vue pour obtenir la liste des robots ou des processus qui peuvent être migrés vers Automation 360 sans intervention manuelle. |
| 9 | ou : accédez à cette vue pour obtenir la liste des robots ou des processus qui ne peuvent pas être migrés actuellement vers Automation 360. |
| 10 | : accédez à cette vue pour obtenir la liste des commandes pouvant être migrées et le nombre de fois où les commandes sont utilisées sur l'ensemble de vos robots analysés. |
| 11 |
Cliquez sur le code du message pour afficher les étapes manuelles que vous devez effectuer pour exécuter le processus migré avec succès dans Automation 360. Vous pouvez également afficher les commandes que le robot contient et la fréquence ou le nombre de fois que la commande est utilisée dans le robot. Remarque : Chaque message comprend la cause et l'action que vous devez effectuer après la migration. Pour obtenir une liste de ces messages, voir . Utilisez le code du message (par exemple
A101) pour afficher rapidement un message spécifique. |
| 12 | Fournit l'emplacement du robot. |
| 13 | Fournit le statut du robot ou du processus. |
| 14 |
|
| 15 | Pour les processus, ce champ affiche le nombre de robots dans un processus qui nécessite une action après la migration vers Automation 360. Cliquez sur l'icône Développer (), puis cliquez sur le nom d'une référence de tâche marquée comme Action requise. Cliquez sur le code du message pour afficher les informations sur les changements de comportement d'Automation 360 pour la commande par rapport au comportement d'Enterprise 11 ou d'Enterprise 10. Remarque : Ce champ n'est disponible que pour les processus.
|
| 16 | Pour les processus, ce champ affiche le nombre de robots dans un processus qui nécessite une vérification après la migration vers Automation 360. Cliquez sur l'icône Développer (), puis cliquez sur le nom d'une référence de tâche marquée comme Vérification requise. Cliquez sur le code du message pour afficher les informations sur les changements de comportement d'Automation 360 pour la commande par rapport au comportement d'Enterprise 11 ou d'Enterprise 10. Remarque : Ce champ n'est disponible que pour les processus.
|
| 17 | Téléchargez (en tant que fichier CSV) la liste des robots, des processus ou des commandes qui peuvent ou ne peuvent pas être migrés afin de pouvoir partager le fichier avec d'autres personnes. |
| 18 |
|
Le rapport est valide jusqu'à ce que la version suivante de Bot Scanner soit disponible. Lorsque la version suivante de Bot Scanner est disponible, un message d’expiration du rapport s’affiche. Vous devez télécharger la dernière version de Bot Scanner et analyser à nouveau le robots.
Vérifications et actions requises après la migration
Certaines commandes des robots peuvent être marquées comme étant nécessaires dans le rapport de Bot Scanner. Pour ces éléments, vous devez effectuer une certaine validation ou mettre à jour les robots après leur migration.
Les messages de Bot Scanner suivants nécessitent une vérification ou certaines actions :
-
Le chemin du robot enfant est entièrement variable et est résolu au moment de l'exécution. Le robot échoue lors de l'exécution si le chemin spécifié dans la variable n'est pas valide. Vérifiez le robot de migration.
Assurez-vous que le robot enfant est disponible à l'emplacement spécifié dans le chemin variable. Si le chemin du robot parent n'est pas correct, mettez-le à jour pour pointer vers le robot enfant correct.
-
La valeur renvoyée par la variable système « Description de l'erreur » peut être différente par rapport aux versions héritées. Vérifiez le robot migré.
La description de certains messages d'erreur dans Automation 360 peut être différente de Enterprise 11 ou Enterprise 10 pour la même erreur. Si un robot Enterprise 11 ou Enterprise 10 est configuré pour prendre des décisions basées sur la description des messages d'erreur, vous devrez peut-être mettre à jour le robot migré en fonction de la nouvelle description des messages d'erreur.
-
La migration de la commande « Base de données - Connecter » est terminée mais une configuration supplémentaire est requise pour l'authentification Windows. Consultez la documentation du package de base de données pour plus de détails.
Suivez les étapes indiquées pour vous connecter à un Microsoft SQL Server avec l'authentification Windows. Reportez-vous à la rubrique Se connecter à un Microsoft SQL Server avec l'authentification Windows.
-
La migration de « SI » avec condition variable est terminée. Toutefois, il est impossible de déterminer le format de date de la variable utilisateur, d'où la migration avec le format de date par défaut mm/jj/aaaa HH:mm:ss. Vérifiez et modifiez le format si nécessaire.
Mettez à jour le format de date dans le robot migré au même format que celui utilisé dans Enterprise 11 pour ce robot.
-
Impossible de déterminer si une variable utilisée comme position est un nom d'index ou de colonne. La position de l'index commence à 0 au lieu de 1 et prend donc les mesures nécessaires si besoin.
Si vous avez utilisé les variables système FileData Column[$variable$] ou Excel Column[$variable$] dans le robot Enterprise 11 ou Enterprise 10, on suppose que vous avez utilisé le nom de colonne dans la $variable$. Dans de tels cas, le robot migré contient l'expression FileData Column{$variable$}. Si la variable $variable$ du robot Enterprise 11 ou Enterprise 10 contient le numéro de colonne, vous devez mettre à jour l'expression dans le robot migré vers FileDataColumn[$var.String:toNumber()$].
- La commande Exécuter la logique qui utilise les variables d'informations d'identification comme entrée pour une logique de MetaBot
Les Robots qui utilisent la commande Exécuter logique qui transmet des attributs Credential Vault d'une logique de Bot de tâche vers MetaBot, peuvent être migrés vers Automation 360. Le nom de l'information d'identification et le nom de l'attribut sont affichés dans les champs de la ligne correspondante du robot migré.
Si vous avez migré à l'aide de la base de données Enterprise 11 restaurée, un consigne équivalent est créé dans Automation 360 pour les variables d'informations d'identification utilisées dans le robot Enterprise 11.
Choisissez l'une des options suivantes pour exécuter la migration de robots avec succès :-
Option 1 : Transmettez les variables de type d'informations d'identification.
- Créez une variable de type d'informations d'identification dans les robots enfants en tant que variable d'entrée.
- Dans l'action Exécuter du package Robot de tâches du robot parent, mettez à jour les champs de valeur d'entrée pour utiliser les attributs Credential Vault de la variable de type d'informations d'identification créée pour le robot enfant (correspondant à la logique de MetaBot).
-
Option 2 : Transmettez les valeurs d'informations d'identification en tant que valeurs globales.
- Créez la valeur globale dans Automation 360 pour utiliser les informations d'identification dans la commande Exécuter la logique dans Enterprise 11.
- Dans l'action Exécuter du package Robot de tâches du robot parent, mettez à jour les champs de valeur d'entrée pour utiliser les valeurs globales de la variable de type d'informations d'identification créée pour le robot enfant (correspondant à la logique MetaBot).
Si vous n'avez pas utilisé la base de données Enterprise 11 restaurée lors de l'installation de Automation 360, vous devez d'abord créer le verrou requis pour les variables d'informations d'identification utilisées dans le robot Enterprise 11, avant d'exécuter les étapes précédentes.Remarque : Automation 360 offre une sécurité améliorée en vous permettant d'affecter des attributs Credential Vault uniquement aux variables de type d'informations d'identification. Cela restreint toute gestion non sécurisée des attributs Credential Vault lorsqu'ils ont pu être affectés à des variables de type autre qu'informations d'identification. -
Option 1 : Transmettez les variables de type d'informations d'identification.
Rapport pour un robot individuel
Le rapport de chaque robot fournit des informations sur ses dépendances, ses variables et les commandes utilisées.
Le rapport individuel d’un robot ressemble au code suivant :
<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>| Nœud | Attribut | Description |
|---|---|---|
| Stat | -- | Fournit des informations sur le nombre de dépendances, d’erreurs et d’avertissements. |
| -- | dépendances | Indique le nombre de dépendances du robot. Le ucount indique le nombre de dépendances uniques et le count indique le nombre total de dépendances. |
| -- | erreur | Spécifie le nombre d’erreurs pour le robot. Le ucount indique le nombre d'erreurs uniques et le count indique le nombre total d'erreurs. |
| Commande | -- | Fournit des informations sur les diverses commandes et actions utilisées dans le robot. |
| -- | command target-action | Indique l’action effectuée suite à la commande. |
| -- | nom | Indique le nom de la commande. |
| -- | line | Indique le numéro de ligne où la commande est disponible dans le robot. |
| -- | grp | Indique le groupe de commande auquel la commande appartient. |
| -- | api | Indique le nom de l’API utilisée par la commande. |
| -- | msg type | Fournit des informations sur le type de message. Le type error indique que la commande ne peut pas être migrée vers Automation 360 tandis que le type info indique que la commande peut être migrée, mais que certains de ses attributs seront modifiés pendant la migration. |
| -- | passer en revue | Fournit des informations sur la nécessité de vérifier la commande. Cet attribut est toujours vrai pour les messages de type |
| -- | catégorie | Fournit des informations relatives à la commande ou à la variable pour laquelle le message s’affiche. |
| Variables | Fournit des informations sur les variables système utilisées par le robot. | |
| -- | variable name | Indique le nom de la variable. |
| -- | type | Indique le type de la variable. |
| -- | value type | Indique le type de valeur fourni pour cette variable. |
Regardez la vidéo suivante pour savoir comment analyser le rapport du scanner.