Analizar el informe de Bot Scanner para la migración

Descargar como PDF

Última actualización2022/12/27

Analizar el informe de Bot Scanner para la migración

Puede analizar el informe generado por el Bot Scanner para obtener información sobre los bots (Bots de tarea y MetaBots) y los procesos que se pueden migrar. Utilice el botón Bot Scanner para decidir si está listo para iniciar la migración ahora o prefiere esperar hasta que se admitan más comandos.

El informe de Bot Scanner proporciona la siguiente información:

Bots: En el informe de Bot Scanner, un bot es un Bot de tarea (.atmx) individual o MetaBot (.mbot) que se usa en otros bots.
La pestaña Bots proporciona información detallada sobre los bots que se pueden migrar, los que requieren una acción o revisión y los que no se pueden migrar.
Procesos: En el informe de Bot Scanner, un proceso es un bot que no se utiliza en ningún otro bots y puede incluir uno más bots secundarios.
La pestaña Procesos proporciona información detallada sobre los procesos que se pueden migrar, los que requieren acción o revisión y los que no se pueden migrar.

El Bot Scanner ofrece información clave sobre los bots y los procesos:

Número de bots y procesos analizados
Un resumen de alto nivel en forma de tablas para indicar el estado de migración de los bots y procesos
Número de bots y procesos que puede y no puede migrar a Automation 360
Comandos que se utilizan en los bots y la frecuencia de uso
Motivos por los que los bots y procesos no se pueden migrar actualmente y la frecuencia de dichas instancias
Acciones y revisiones requeridas por los usuarios después de la migración debido a un cambio en el comportamiento de los comandos
Bots y procesos que no se pueden migrar y sus mensajes de error correspondientes
Número de líneas en los bots y número total de líneas de cada bots asociadas a un proceso
Número de línea de cada bots individual y procesos que necesitan revisión o acción

Importante: Automation 360 se actualiza con frecuencia para lograr una equivalencia funcional del 100 % con Enterprise 10 o Enterprise 11. El porcentaje de bots, comandos y variables compatibles para la migración en Automation 360 aumentará hasta alcanzar el 100 % en las próximas versiones. Es decir, para cada función que realice en Enterprise 10 o Enterprise 11, una capacidad equivalente se encuentra en Automation 360.

La mayoría de las funciones en Enterprise 10 o Enterprise 11 están disponibles en el estado en que se encuentran, pero algunas funciones se implementan de manera diferente para permitir operaciones web (sin un cliente). Para estas funciones, debe cambiar la forma en que los bots están escritos.

El Bot Scanner está diseñado para escanear los bots (Bots de tarea y MetaBots) creados utilizando versiones Enterprise 10 y Enterprise 11 de Enterprise Client. El recuento total de archivos incluye la cantidad de archivos omitidos y no escaneados.

Los informes están disponibles en la ubicación de salida que especificó en el campo Seleccionar carpeta de destino en el cuadro de diálogo Bot Scanner de Automation Anywhere. Bot Scanner genera un informe resumido (summary.html) y un informe XML por separado para cada bot que ha escaneado. Crea un informe separado para cada lógica disponible en un MetaBot.

Se crea una carpeta datos sin procesar que contiene los informes (en formato XML) para cada bot escaneado. Ayuda a nuestros ingenieros a analizar más a fondo el proceso de migración y tomar medidas correctivas, de ser necesario. No se incluye información de identificación personal (Personally Identifiable Information, PII) en el informe de resumen ni en los informes individuales de los bots.

Si decide compartir los informes con nosotros para ayudar a mejorar el producto, comprima los archivos en la carpeta datos sin procesar y coordine con el Gerente de Éxito de Clientes o el Gerente de Habilitación de Socios. No se comparten datos automáticamente con Automation Anywhere.

Informe resumido para todos los bots

La funcionalidad Bot Scanner proporciona una opción para escanear bots o procesos, o bots y procesos. Dependiendo de lo que elija, el informe resumido contendrá información sobre los bots, procesos, o bots y procesos. La mayoría de las secciones que se ven en estos informes resumidos serán los mismos excepto que en el informe resumido de bots y procesos también verá un campo adicional Todos que enumera todos los bots o procesos que están marcados y ordenados como Acción obligatoria, Revisión obligatoria, No se requiere revisión y No migrable.

Nota: Para generar el informe de resumen de los procesos, el tamaño máximo del repositorio que se admite es de hasta 10 Gb.

El informe resumido proporciona información sobre lo siguiente:

si puede migrar a Automation 360
el número total de bots escaneados
un informe único de bots que proporciona información sobre los bots compatibles para la migración a Automation 360 (expresado en porcentaje)
un informe único de procesos que proporciona información sobre los procesos compatibles para la migración a Automation 360
un informe combinado de bots y procesos que proporciona información sobre los bots y procesos compatibles para la migración a Automation 360

Por ejemplo, considere que el Bot Scanner ha escaneado 10 bots. De los 10 bots, si 8 bots están preparados para migrar a Automation 360, entonces el porcentaje de bots que pueden migrar es del 80 % y el porcentaje de bots que no puede ser migrado ahora es del 20 %.

Revisar el informe de Bot Scanner para los bots

Considere un contexto en el que ha escaneado un total de 1618 bots, de los cuales el 98 % (1614 bots) se puede migrar a Automation 360. Sin embargo, el 5 % de los bots requieren medidas después de la migración, y el 2 % (4 bots) no puede ser migrado actualmente debido a ciertas razones. En este caso, el informe de Bot Scanner le permite realizar las siguientes acciones:

Identifique las acciones y revisiones por realizar para el 5 % restante de bots para que pueda migrar con éxito la mayoría de sus bots y ejecutarlos en Automation 360 después de la migración.
Identifique los bots que se pueden migrar a Automation 360 sin ninguna intervención manual.
Identifique la razón por la que el 2 % de bots no puede migrarse actualmente y el tiempo estimado para cuando pueda migrarlos más adelante. La razón podría ser debido a los comandos y variables que aún no son compatibles con Automation 360.

Revisar el informe de Bot Scanner para los procesos

Realice estos pasos para revisar un mensaje de proceso:

Haga clic en la pestaña Procesos.
Haga clic en la pestaña de mensajes que quiera revisar.
En la columna Referencia a tarea maestra, haga clic en el icono de expansión () para ver el proceso.
Haga clic en el nombre de un proceso para ver el mensaje.

Considere un contexto en el que ha escaneado un total de 100 procesos, de los cuales 99 se pueden migrar a Automation 360. Sin embargo, 5 procesos requieren una acción después de la migración, 10 procesos requieren una revisión después de la migración y 1 proceso no puede ser migrado actualmente por determinados motivos. En este caso, el informe de Bot Scanner le permite realizar las siguientes acciones:

Identifique las acciones y revisiones por realizar para los 15 procesos restantes de manera tal que pueda migrar con éxito la mayoría de sus procesos y usarlos en Automation 360 después de la migración.
Identifique los procesos que se pueden migrar a Automation 360 sin ninguna intervención manual.
Identifique el motivo por el cual 1 proceso no puede migrarse actualmente y el tiempo estimado para cuando pueda migrarlos más adelante.
La razón podría ser debido a los comandos y variables que aún no son compatibles con Automation 360.

La siguiente imagen es un ejemplo de informe del Bot Scanner:

Informe Bot Scanner de ejemplo

La siguiente tabla describe los distintos campos del informe de muestra de Bot Scanner (numerados en la imagen anterior):


Campo/opción	Descripción
1	Proporciona un resumen y el estado de preparación para la migración de sus bots. Revise el estado de las migraciones en función de lo siguiente: Verde: Puede proceder a la migración siempre que revise el informe para cualquier acción o revisión obligatoria para sus bots. Ámbar: Tiene que esperar para migrar sus bots ya que el porcentaje de bots que son aptos para la migración no cumplen los requisitos de migración.
2	Proporciona un resumen de la siguiente información para los bots: Bots migrables: Proporciona un resumen del número total de bots que se pueden migrar. Cantidad total de bots: Proporciona un resumen del número total de bots que fueron escaneados. Acción obligatoria: Proporciona un resumen del número total de bots que requieren una acción después de la migración a Automation 360. Revisión obligatoria: Proporciona un resumen del número total de bots que requieren revisión después de la migración a Automation 360. No se requiere revisión: Proporciona un resumen del número total de bots que se pueden migrar a Automation 360 sin ninguna intervención manual. No migrables: Proporciona un resumen del número total de bots que no se pueden migrar actualmente a Automation 360.
3	Proporciona recursos adicionales para facilitar el proceso de migración.
4	Proporciona un resumen de la siguiente información para los procesos: Procesos migrables: Proporciona un resumen del número total de procesos que se pueden migrar. Procesos totales: Proporciona un resumen del número total de procesos que fueron escaneados. Acción obligatoria: Proporciona un resumen del número total de procesos que requieren una acción después de la migración a Automation 360. Incluso si un bot secundario en un proceso requiere una acción, el proceso se marca como Acción obligatoria. Nota: Si un proceso contiene bots y algunos de ellos requieren revisión y otros requieren acción, el proceso se marca como Acción obligatoria. El estado Acción obligatoria tiene prioridad sobre el estado Revisión obligatoria. Revisión obligatoria: Proporciona un resumen del número total de procesos que requieren revisión después de la migración a Automation 360. Incluso si un bot secundario en un proceso requiere revisión, el proceso se marca como Revisión obligatoria. No se requiere revisión: Proporciona un resumen del número total de procesos que se pueden migrar a Automation 360 sin ninguna intervención manual. Todos los bots en el proceso se pueden migrar. No migrables: Proporciona un resumen del número total de procesos que no se pueden migrar actualmente a Automation 360. No se pueden migrar todos los bots en el proceso.
5	Bots > Todos > Bots o Procesos > Todos > Bots: Vaya a esta vista para obtener una lista de todos los bots o procesos marcados y ordenados como Acción obligatoria, Revisión obligatoria, No se requiere revisión y No migrable. Para ver el mensaje de un bot específico que requiere una acción o revisión, haga clic en el nombre del bot. Para ver el mensaje de un proceso específico que requiere una acción o revisión, haga clic en el ícono de expansión de procesos () y, a continuación, haga clic en el nombre de referencia de la tarea. Haga clic en el código de mensaje para ver la información sobre los cambios en el comportamiento de Automation 360 del comando en comparación con el comportamiento de Enterprise 11 o Enterprise 10. Nota: Cada mensaje incluye información que tiene que revisar después de la migración. Para obtener una lista de estos mensajes, consulte . Utilice el código del mensaje (por ejemplo, `R102`) para ver rápidamente el mensaje específico.
6	Bots > Acción obligatoria > Bots o Procesos > Acción obligatoria > Bots: Vaya a esta vista para ver la lista de bots o procesos que requieren una acción después de la migración a Automation 360. Para ver el mensaje de un bot específico que requiere acción, haga clic en el nombre del bot. Para ver el mensaje de un proceso específico que requiere acción, haga clic en ícono de expansión () y, a continuación, haga clic en el nombre de referencia de la tarea. Haga clic en el código de mensaje para ver la información sobre los cambios en el comportamiento de Automation 360 del comando en comparación con el comportamiento de Enterprise 11 o Enterprise 10. Nota: Cada mensaje incluye información que tiene que revisar después de la migración. Para obtener una lista de estos mensajes, consulte . Utilice el código del mensaje (por ejemplo, `R102`) para ver rápidamente el mensaje específico.
7	Bots > Revisión obligatoria > Bots o Procesos > Revisión obligatoria > Bots: Vaya a esta vista para ver una lista de los bots o procesos que requieren revisión después de la migración a Automation 360. Para ver el mensaje de revisión requerida de un bot, haga clic en el nombre del bot. Para ver el mensaje de revisión requerido de un proceso específico, haga clic en el ícono de expansión () y, a continuación, haga clic en el nombre de referencia de la tarea. Haga clic en el código de mensaje para ver la información sobre los cambios en el comportamiento de Automation 360 del comando en comparación con el comportamiento de Enterprise 11 o Enterprise 10. Nota: Cada mensaje incluye información que tiene que revisar después de la migración. Para obtener una lista de estos mensajes, consulte . Utilice el código del mensaje (por ejemplo, `R102`) para ver rápidamente el mensaje específico.
8	Bots > No se requiere revisión > Bots o Procesos > No se requiere revisión > Bots: Vaya a esta vista para ver una lista de los bots o procesos que se pueden migrar a Automation 360 sin intervención manual.
9	Bots > No migrables > Bots o Procesos > No migrables > Bots: Vaya a esta vista para ver una lista de bots o procesos que no pueden migrarse actualmente a Automation 360.
10	Bots > Comandos: Vaya a esta vista para ver una lista de los comandos que se pueden migrar y el número de veces que se utilizan los comandos en todos sus bots escaneados.
11	Nombre del Bot: En la pestaña Bots, haga clic en un nombre de bot para ver el mensaje de acción obligatoria de un bot específico, haga clic en el nombre del bot. Referencia de la tarea maestra: En la pestaña Procesos, para ver el mensaje de acción requerida de un proceso específico, haga clic en el icono de expansión () y, a continuación, haga clic en un nombre de referencia de tarea. Haga clic en el código del mensaje para ver los pasos manuales que debe realizar a fin de ejecutar el proceso migrado con éxito en Automation 360. También puede ver los comandos que contiene el bot y la frecuencia o la cantidad de veces que se utiliza el comando en el bot. Nota: Cada mensaje incluye la causa y la acción que debe realizar después de la migración. Para obtener una lista de estos mensajes, consulte . Utilice el código del mensaje (por ejemplo, `A101`) para ver rápidamente un mensaje específico.
12	Proporciona la ubicación del bot.
13	Proporciona el estado del bot o proceso.
14	En caso de bots, este campo muestra el número de líneas usadas en un bot. Esta información le ayudará a comprender la complejidad del bot. Para los procesos, este campo muestra la suma del número total de líneas usadas en los bots primario y secundario dentro de un proceso. Esta información le ayudará a comprender la complejidad del proceso.
15	Para los procesos, este campo muestra el número de bots en un proceso que requiere una acción después de la migración a Automation 360. Haga clic en el icono de expansión () y, a continuación, haga clic en un nombre de referencia de tarea marcado como Acción requerida. Haga clic en el código de mensaje para ver la información sobre los cambios en el comportamiento de Automation 360 del comando en comparación con el comportamiento de Enterprise 11 o Enterprise 10. Nota: Esta opción solo está disponible para procesos.
16	Para los procesos, este campo muestra el número de bots en un proceso que requiere revisión después de la migración a Automation 360. Haga clic en el icono de expansión () y, a continuación, haga clic en un nombre de referencia de tarea marcado como Revisión requerida. Haga clic en el código de mensaje para ver la información sobre los cambios en el comportamiento de Automation 360 del comando en comparación con el comportamiento de Enterprise 11 o Enterprise 10. Nota: Esta opción solo está disponible para procesos.
17	Descargue (como archivo CSV) la lista de bots, procesos o comandos que pueden o no pueden ser migrados para que pueda compartir el archivo con los demás.
18	En caso de bots, este campo muestra el número de veces que un bot se usa como bot secundario. Para los procesos, este campo muestra la suma del número total de dependencias usadas en los bots primario y secundario dentro de un proceso.

El informe es válido hasta que la siguiente versión de Bot Scanner esté disponible. Cuando la siguiente versión de Bot Scanner se encuentra disponible, se muestra un mensaje de vencimiento del informe. Debe descargar la versión más reciente del Bot Scanner y escanear los bots de nuevo.

Verificaciones y acciones necesarias tras la migración

Algunos comandos en los bots pueden ser marcados como Revisión requerida en el informe de Bot Scanner. Para estos elementos, es necesario realizar ciertas validaciones o actualizar los bots después de haberlos migrado.

Los siguientes mensajes de Bot Scanner requieren verificación o algunas acciones:

La ruta del bot secundario es completamente variable y se resuelve en tiempo de ejecución. El bot fallaría durante la ejecución si la ruta especificada en la variable no es válida. Revise el bot migrado.
Asegúrese de que el bot secundario esté disponible en la ubicación especificada en la ruta variabilizada. Si la ruta del bot primario no es correcta, actualice la ruta para que apunte al bot secundario correcto.
El valor devuelto por la variable del sistema "Descripción del error" puede ser diferente con respecto a las versiones heredadas w.r.t. Revise el bot migrado.
La descripción de algunos de los mensajes de error en Automation 360 puede ser diferente a la de Enterprise 11 o Enterprise 10 para el mismo error. Si un bot de Enterprise 11 o Enterprise 10 está configurado para tomar decisiones basadas en la descripción de los mensajes de error, es posible que tenga que actualizar el bot migrado basándose en la nueva descripción de los mensajes de error.
La migración del comando "Base de datos - Conectar" se ha completado, pero se requiere una configuración adicional para la "Autenticación de Windows". Consulte la documentación del paquete de base de datos para obtener más información.
Complete los pasos especificados para conectarse a un Microsoft SQL Server con la autenticación de Windows. Consulte Conectarse a un Microsoft SQL Server con autenticación de Windows.
Se ha completado la migración de "SI" con condición variable. Sin embargo, no se pudo determinar el formato de fecha de la variable de usuario, por lo que se migró con el formato de fecha por defecto mm/dd/aaaa HH:mm:ss. Revise y cambie el formato si es necesario.
Actualice el formato de fecha en el bot migrado al mismo formato utilizado en Enterprise 11 para ese bot.
No se ha podido determinar si una variable utilizada como posición es un índice o un nombre de columna. La posición del índice comienza en 0 en lugar de 1, por lo que hay que tomar las medidas necesarias según sea necesario.
Si ha utilizado las variables del sistema FileData Column[$variable$] o Excel Column[$variable$] en el bot Enterprise 10 u Enterprise 11, suponemos que se ha utilizado el nombre de la columna en la $variable$. En estos casos, el bot migrado contiene la expresión FileData Column{$variable$}. Si la $variable$ en el bot Enterprise 11 o Enterprise 10 contiene el número de la columna, debe actualizar la expresión en el bot migrado a FileDataColumn[$var.String:toNumber()$].
El comando Ejecutar Lógica que utiliza variables de credenciales como entrada para una lógica de un MetaBot
Bots que utilizan el comando Ejecutar lógica que pasa los atributos de la Credential Vault de un Bot de tarea a una lógica de MetaBot pueden migrarse a Automation 360. El nombre de la credencial y el nombre del atributo se muestran en los campos de la línea correspondiente del bot migrado.

Si ha migrado utilizando la base de datos restaurada de Enterprise 11, se crea una casillero equivalente en Automation 360 para las variables de credencial utilizadas en el bot de Enterprise 11.
Elija una de las siguientes opciones para ejecutar los bots migrados con éxito:
- Opción 1: Pase las variables de tipo de credencial.
  1. Crear una variable de tipo credencial en los bots secundarios como variables de entrada.
  2. En la acción Ejecutar del paquete de Bot de tarea del bot primario, actualice los campos de valor de entrada para utilizar los atributos de la Credential Vault para la variable de tipo de credencial creada para el bot secundario (corresponde a la lógica del MetaBot).
- Opción 2: Pase los valores de las credenciales como un valor global.
  1. Cree el valor global en Automation 360 para el uso de credenciales en el comando Ejecutar lógica en Enterprise 11.
  2. En la acción Ejecutar del paquete de Bot de tarea del bot primario, actualice los campos de valor de entrada para utilizar los valores globales para la variable de tipo de credencial creada para el bot secundario (corresponde a la lógica del MetaBot).
Si no ha utilizado la base de datos de Enterprise 11 restaurada durante la instalación de Automation 360, debe crear primero el casillero requerido para las variables de credencial utilizadas en el bot de Enterprise 11 antes de realizar los pasos anteriores.
Nota: Automation 360 proporciona una mayor seguridad, ya que permite asignar atributos de la Credential Vault solo a las variables de tipo credencial. Esto restringe cualquier manejo no seguro de los atributos de la Credential Vault cuando puedan haber sido asignados a variables de tipo no credencial.

Informe para un bot individual

El informe para cada bot proporciona información sobre sus dependencias, variables y comandos utilizados.

El informe sobre el bot individual parece similar al siguiente código:

<analysis version="1.3.0"> <stat> <dependencies ucount="0" count="0"/> <errors ucount="6" count="12"> <error count="1">System variable $AAApplicationPath
lt;/error> <error count="1">Command [If FolderNotExist] is not supported</error> <error count="3">System variable $CurrentDirectory
lt;/error> <error count="3">System variable $Extension
lt;/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 $AAApplicationPath
lt;/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 $CurrentDirectory
lt;/msg> <msg type="error" review="true" category="variable">System variable $Extension
lt;/msg> <msg type="error" review="true" category="variable">System variable $FileName
lt;/msg> </command> </commands> <variables> <variable name="$CSV-TXT-Default-DATA
quot; type="TABLE" value-type=""/> </varaibles> </analysis>

La siguiente tabla describe los diversos atributos disponibles en el informe XML que se muestran en la imagen anterior:


Nodo	Atributo	Descripción
Estad	--	Proporciona información sobre la cantidad de dependencias, errores y advertencias.
--	dependencias	Especifica la cantidad de dependencias para bot. `ucount` indica el número de dependencias únicas y `count` indica el número total de dependencias.
--	error	Especifica la cantidad de errores para bot. `ucount` indica el número de errores únicos y `count` indica el número total de errores.
Comando	--	Proporciona información sobre los diversos comandos y acciones utilizados en el bot.
--	comando target-action	Especifica la acción que se realiza para el comando.
--	nombre	Especifica el nombre del comando.
--	línea	Especifica el número de línea en el que el comando está disponible en el bot.
--	grp	Especifica el grupo de comandos al que pertenece el comando.
--	api	Especifica el nombre de la API que utiliza el comando.
--	tipo mje	Proporciona información sobre el tipo de mensaje. El tipo de `error` indica que el comando no se puede migrar a Automation 360, y un tipo de `info` indica que el comando se puede migrar, pero algunos de sus atributos se modificarán durante la migración.
--	revisar	Proporciona información sobre si se debe revisar el comando. Este atributo siempre es válido para mensajes de tipo de `error`, que indican que la migración de ese comando a Automation 360 todavía no es compatible. Para mensajes de tipo de `info`, si el atributo es verdadero, debe revisar el valor en el atributo `category` Puede decidir si desea realizar alguna acción sobre el bot que ha migrado según el valor disponible en el atributo `category`.
--	categoría	Proporciona información sobre el comando o variable para el cual se muestra el mensaje.
Variables		Proporciona información sobre las variables de sistema utilizadas por el bot.
--	nombre de variable	Especifica el nombre de la variable.
--	tipo	Especifica el tipo de variable.
--	tipo de valor	Especifica el tipo de valor proporcionado para esa variable.