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 bots (Task Bots 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 :
- Bots : dans le rapport Bot Scanner, un bot est un Task Bot (.atmx) ou un MetaBot (.mbot) unique qui est utilisé dans d'autres bots.
L'onglet Robots fournit des informations détaillées sur les bots 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 bot qui n'est pas utilisé dans d'autres bots et peut comprendre un ou plusieurs bots 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 bots et de processus analysés
- Un résumé de haut niveau sous forme de tableaux pour indiquer le statut de la migration des bots et des processus
- Nombre de bots et de processus que vous pouvez et ne pouvez pas migrer vers Automation 360
- Commandes utilisées dans les bots et fréquence d'utilisation
- Raisons pour lesquelles les bots 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
- Bots et processus qui ne peuvent pas être migrés et leurs messages d'erreur correspondants
- Nombre de lignes dans les bots et nombre total de lignes de chacun des bots associés à un processus
- Numéro de ligne pour chacun des bots 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 bots sont écrits.
Le Bot Scanner est conçu pour analyser bots (Task Bots et MetaBots) créés à l’aide des versions Enterprise 10 et Enterprise 11 de Enterprise Client. 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 bot 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 bot 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 bots 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 bots
- Si vous pouvez migrer vers Automation 360
- Nombre total des bots analysés
- Rapport des bots uniquement qui fournit des informations sur les bots 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
- bots et processus combinés qui fournit des informations sur les bots et les processus pris en charge pour la migration vers Automation 360
Par exemple, considérons que le Bot Scanner a scanné 10 bots. Sur les 10 bots, si 8 bots sont prêts pour la migration vers Automation 360, 80 % des bots peuvent être migrés et 20 % des bots ne peuvent pas encore l'être.
- Identifiez les actions et les vérifications à effectuer pour les 5 % de bots restants afin que vous puissiez migrer avec succès une majorité de vos bots et que vous les exécutiez dans Automation 360 après la migration.
- identifier les bots qui peuvent être migrés vers Automation 360 sans intervention manuelle ;
- identifier la raison pour laquelle 2 % des bots 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 bots. Examinez le statut de la migration en fonction des éléments suivants :
|
| 2 | Fournit un résumé des informations suivantes pour les bots :
|
| 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 Messages de migration. 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 bots 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 Messages de migration. 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 Messages de migration. 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 bots 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 bots 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 bots 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 bot contient et la fréquence ou le nombre de fois que la commande est utilisée dans le bot. 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 Messages de migration. Utilisez le code du message (par exemple
A101) pour afficher rapidement un message spécifique. |
| 12 | Fournit l'emplacement du bot. |
| 13 | Fournit le statut du bot ou du processus. |
| 14 |
|
| 15 | Pour les processus, ce champ affiche le nombre de bots 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 bots 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 bots, 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 bots.
Vérifications et actions requises après la migration
Certaines commandes des bots 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 bots 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 bot enfant est disponible à l'emplacement spécifié dans le chemin variable. Si le chemin du bot parent n'est pas correct, mettez-le à jour pour pointer vers le bot 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 bot 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 bot 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 bot migré au même format que celui utilisé dans Enterprise 11 pour ce bot.
- 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 bot Enterprise 11 ou Enterprise 10, on suppose que vous avez utilisé le nom de colonne dans la $variable$. Dans de tels cas, le bot migré contient l'expression FileData Column{$variable$}. Si la variable $variable$ du bot Enterprise 11 ou Enterprise 10 contient le numéro de colonne, vous devez mettre à jour l'expression dans le bot 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 Bots qui utilisent la commande Exécuter logique qui transmet des attributs Credential Vault d'une logique de Task Bot 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 bot migré.
Si vous avez migré à l'aide de la base de données Enterprise 11 restaurée, un locker équivalent est créé dans Automation 360 pour les variables d'informations d'identification utilisées dans le bot Enterprise 11.
Choisissez l'une des options suivantes pour exécuter la migration de bots 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 bots enfants en tant que variable d'entrée.
- Dans l'action Exécuter du package Task Bot du bot 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 bot 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 Task Bot du bot 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 bot 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 bot 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 bot individuel
Le rapport de chaque bot fournit des informations sur ses dépendances, ses variables et les commandes utilisées.
Le rapport individuel d’un bot 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 bot. 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 bot. 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 bot. |
| -- | 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 bot. |
| -- | 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 bot. | |
| -- | 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.