Cómo se migran MetaBots

Cuando migra un MetaBot a Automation 360, se crean bots equivalentes para las diversas lógicas disponibles en MetaBot, excepto para las pantallas de la aplicación . Después de una migración exitosa, cada lógica de un archivo .mbot se convierte en un archivo TaskBot.

Un MetaBot contiene recursos y lógica. Los activos son las pantallas de la aplicación o DLL que se utilizan para automatizar una tarea en una aplicación. Lógica es un conjunto de comandos para realizar una operación e interactuar con otra lógica y bots.

El proceso de migración realiza las siguientes acciones:

Convierte la lógica del MetaBot a TaskBots correspondientes.
Mantiene la estructura de carpetas de los MetaBots después de migrar. Las nuevas carpetas creadas en Automation 360 contienen TaskBots para cada lógica migrada a Automation 360.
Actualiza los TaskBots que utilizan lógica de MetaBot para referirse a los nuevos TaskBots que se crearon para la lógica del MetaBot migrado .
No es necesario que actualice los TaskBots de forma manual.

Características como el uso de DLL, variables de entrada y salida, y el permiso Ejecutar que solo estaban disponibles para MetaBots ahora están disponibles para todos los TaskBots.

Utilizaremos el siguiente MetaBot para explicar cómo se migra a Automation 360:

Nombre del MetaBot: Metatarea
Recursos:
- Pantalla de inicio de sesión
- General.dll
- DLL\Binary.dll
Lógica:
- Common
- Process1\Connect
- Process1\Disconnect
- Process1\Operations\Numeric

Beneficios de TaskBots reutilizables en Automation 360

La siguiente tabla contiene las ventajas de utilizar TaskBots reutilizables en Automation 360 en comparación con MetaBots en Enterprise 11:


TaskBots reutilizables de Automation 360	v11 MetaBots
Puede navegar hasta un bot secundario con menos clics mediante el componente Finder, lo que ahorra tiempo. Vaya a Editor > Buscador para llegar al bot secundario.	Debe navegar por el TaskBot > Ejecutar para llegar al hijo bot.
Puede buscar los bots secundarios desde el espacio de trabajo privado y desde el espacio de trabajo público para utilizarlos en TaskBots.	Debe descargar los MetaBots en el repositorio local para utilizar un bot secundario en los TaskBots.
Solo se implementa una Logic específica cuando se utiliza en una tarea, lo que ahorra tiempo y ancho de banda.	Se implementa el MetaBot completo en la máquina Bot Runner aunque solo se utilice una Logic en la tarea.
Proporciona un mejor control de acceso basado en la funciones, lo que permite personalizar los permisos.	Los MetaBots obligan a que todas las Logic tengan los mismos permisos, incluso si varias Logic están repartidas en diferentes carpetas.

Proceso de migración de MetaBot

El sistema crea una carpeta con el mismo nombre que el MetaBot dentro de la carpeta Mis MetaBots disponible en la carpeta Bots y la misma estructura de carpeta en la que se conserva Enterprise 11. Por ejemplo, si la estructura de carpetas en Enterprise 11 es Accounts/Tax/MetaTask.mbot, el sistema conserva la estructura de carpetas como Accounts/Tax/MetaTask.mbot. Todos los componentes de un MetaBot se almacenan en la carpeta creada para ese MetaBot. En este ejemplo, el sistema crea la carpeta MetaTask en la carpeta Bots\Mis MetaBots y almacena todos los componentes de MetaBot en esa carpeta.

Los bots Enterprise 10 que llaman directamente a los DLL y a las pantallas en un MetaBot sin utilizar lógica de MetaBot se migran a los TaskBots y actions equivalentes en Automation 360. En Enterprise 10, si un DLL que devuelve parámetros de tipo lista o matriz y la salida de ese DLL se asigna con un parámetro de tipo valor, se agrega un espacio extra al principio del valor de salida. El espacio extra no se agrega al valor de salida después de que se migra el bot.

MetaBots 10.1 que utilizan funciones DLL que aceptan parámetros de entrada de tipo matriz y lista unidimensionales y se asignan con el parámetro de tipo matriz. En estos casos, el índice de fila y el índice de columna se requieren como entrada para especificar el valor que se devolverá. Después de la migración, el índice de fila se considera como número de columna.

Nota: Para bots que se actualizan de 10.1 a 10.3.5 y, luego, se migran a Automation 360, el Bot Migration Wizard no muestra la dependencia en la página Bot y bots dependientes. Para dichos bots, debe migrar los MetaBots antes de migrar los TaskBots que llaman a esos MetaBots.

Migración de DLL

El sistema no mantiene la estructura de carpetas para activos a fin de mantener las referencias entre los archivos DLL. Para el ejemplo anterior, General.dll y Binary.dll se almacenan en la carpeta MetaTask aunque Binaary.dll se almacena en la subcarpeta DLL.

Migración de pantallas

Cada pantalla en un MetaBot se convierte en una variable de Windows y las actions realizadas en la pantalla se migran a las actions equivalentes en Automation 360.

La siguiente tabla contiene las pantallas que se pueden migrar a Automation 360:


Navegador	Internet Explorer Google Chrome (solo para el tipo de reproducción de objeto)
Tipo de pantalla	Estándar
Tecnología	Java, HTML, MSAA, .Net, UI Automation (solo para el tipo de reproducción de objeto)
Tipo de reproducción	Objeto, imagen, coordenadas

También puede migrar MetaBots con pantallas que se capturan en el entorno Citrix desde aplicaciones que se basan en tecnologías Java, UI Automation y MSAA.

Los objetos vinculados en una pantalla de MetaBot que se capturan con el tipo de reproducción de objeto se migran a la action Captura del Recorder package. El objeto fuente se muestra en la pestaña Principal y el objeto vinculado se muestra en la pestaña Anclaje de la acción Captura.

La siguiente tabla proporciona información sobre las acciones que se realizan en un objeto de tipo de reproducción de objeto y en un objeto vinculado de tipo de reproducción de texto disponible en la pantalla que se migra a las acciones equivalentes en Automation 360:


Tipo de reproducción	Acción Enterprise 11	Acción Automation 360
Objeto	Obtener propiedad, Obtener artículos totales, Obtener índice seleccionado, Obtener texto seleccionado, Seleccionar elemento por texto, Seleccionar elemento por índice, Clic, Clic con botón izquierdo, Clic con botón derecho, Doble clic, Establecer texto, Anexar texto, Obtener propiedad, Activar, Desactivar, Alternar, Expandir, Seleccionar, Obtener estado.	Migrado a la action Captura del Recorder package. Los comandos GetAllChidrenName y GetAllChidrenValue en Enterprise 11/Enterprise 10 devuelven valores variables de tipo cadena. En Automation 360, devuelven valores de la lista. El proceso de migración se une a los valores de la lista y los almacena en una variable de cadena para mantener comportamientos bot congruentes en todas las versiones. El comando Clonación de objetos con la acción Exportar a CSV en Enterprise 11/Enterprise 10 se migra a: La action Captura del Recorder package. Esta action guarda la fecha capturada en una variable de tabla. La action Escribir en el archivo del Data Table package. Esta action guarda los datos de la variable de tabla en el archivo CSV.

La siguiente tabla proporciona información sobre las acciones que se realizan en un objeto de tipo de reproducción de imagen objeto vinculado de tipo de reproducción de imagen disponible en la pantalla que se migra a las acciones equivalentes en Automation 360:


Tipo de reproducción	Acción Enterprise 11	Acción Automation 360
Imagen	Clic con botón izquierdo	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con el Clic con botón izquierdo seleccionado de la lista Acción.
	Clic con botón derecho	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con el Clic con botón derecho seleccionado de la lista Acción.
	Doble clic	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con el Doble clic seleccionado de la lista Acción.
	Clic central	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con el Clic con botón izquierdo seleccionado de la lista Acción.
	Establecer texto	Migrado a: La action Ventana de búsqueda en ventana del Image Recognition package con el Clic con botón izquierdo seleccionado de la lista Acción. La action Retraso del Delay package con el retraso Común establecido en 500 milisegundos. La action Simular pulsaciones de teclas del Simulate keystrokes package.
	Obtener texto	Migrado a la action Capturar área del OCR package.
	Obtener visibilidad	Migrado a la acción SI con la condición Image Recognition:Buscar ventana en ventana. La acción Obtener Visibilidad devuelve un valor Verdadero o Falso en función de si el objeto de una imagen es visible o no. Del mismo modo, la condición dentro de la acción IF se evalúa en función de si la ventana se encuentra en otra ventana. El resultado se almacena en una variable temporal.

La siguiente tabla proporciona información sobre las acciones que se realizan en un objeto de tipo de reproducción de coordenada objeto vinculado de tipo de reproducción de coordenada disponible en la pantalla que se migra a las acciones equivalentes en Automation 360:


Tipo de reproducción	Acción Enterprise 11	Acción Automation 360
Coordenada	Clic	Migrado a la action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas.
	Clic con botón izquierdo	Migrado a la action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas.
	Clic con botón derecho	Migrado a la action Clic del Mouse package con las opciones Botón derecho y Clic seleccionadas.
	Clic central	Migrado a la action Clic del Mouse package con las opciones Botón central y Clic seleccionadas.
	Doble clic	Migrado a la action Clic del Mouse package con las opciones Botón izquierdo y Doble clic seleccionadas.
	Establecer texto	Migrado a: La action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas. La action Retraso del Delay package con el retraso Común establecido en 500 milisegundos. La action Simular pulsaciones de teclas del Simulate keystrokes package.
	Obtener texto	Migrado a: La action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas. La action Borrar del Clipboard package. La action Retraso del Delay package con el retraso Común establecido en 500 milisegundos. La action Simular pulsaciones de teclas del Simulate keystrokes package. La action Retraso del Delay package con el retraso Común establecido en 500 milisegundos. La action Copiar a del Clipboard package.

La siguiente tabla proporciona información sobre las acciones que se realizan en un objeto personalizado de tipo de reproducción de coordenada disponible en la pantalla que se migra a acciones equivalentes en Automation 360:


Tipo de reproducción	Acción Enterprise 11	Acción Automation 360
Coordenada	Clic	Migrado a la action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas.
	Clic con botón izquierdo	Migrado a la action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas.
	Clic central	Migrado a la action Clic del Mouse package con las opciones Botón central y Clic seleccionadas.
	Doble clic	Migrado a la action Clic del Mouse package con las opciones Botón izquierdo y Doble clic seleccionadas.
	Establecer texto	Se migra a lo siguiente: La action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas. La action Retraso del Delay package con el retraso Común establecido en 500 milisegundos. La action Simular pulsaciones de teclas del Simulate keystrokes package.
	Obtener texto	Se migra a lo siguiente: La action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas. La action Borrar del Clipboard package. La action Retraso del Delay package con retraso Común establecido en 500 milisegundos. La action Simular pulsaciones de teclas del Simulate keystrokes package. La action Retraso del Delay package con retraso Común establecido en 500 milisegundos. La action Copiar a del Clipboard package.

La siguiente tabla proporciona información sobre las acciones que se realizan en un objeto personalizado de tipo de reproducción de texto disponible en la pantalla que se migra a acciones equivalentes en Automation 360:


Tipo de reproducción	Acción Enterprise 11	Acción Automation 360
Texto	Clic	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con Clic con botón izquierdo seleccionado de la lista Acción.
	Clic con botón izquierdo	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con Clic con botón izquierdo seleccionado de la lista Acción.
	Doble clic	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con Doble clic seleccionado de la lista Acción.
	Establecer texto	Se migra a lo siguiente: La action Ventana de búsqueda en ventana del Image Recognition package con Clic con botón izquierdo seleccionado de la lista Acción. La action Retraso del Delay package con retraso Común establecido en 500 milisegundos. La action Simular pulsaciones de teclas del Simulate keystrokes package.
	Obtener texto	Migrado a la action Capturar área del OCR package.

Migración de lógica

Cada lógica en un MetaBot se convierte en un TaskBot y cada comando utilizado en una lógica se convierte en la acción equivalente en Automation 360. La variable utilizada en una lógica se convierte en una variable equivalente en Automation 360. Las variables de credenciales utilizadas en la lógica se migran a Automation 360 y se utilizan en las acciones equivalentes en los bots migrados. Si el Tipo de parámetro de una variable es entrada o salida, se mantiene lo mismo después de que esa variable migre a Automation 360. Por ejemplo, si el Tipo de parámetro de la variable ABC se establece como Entrada, la variable ABC creada en Automation 360 tiene la opción Usar como entrada seleccionada después de migrar. El sistema conserva la estructura de carpetas internas de las lógicas. Para el ejemplo anterior, todas las lógicas migradas se almacenan como se indica en la siguiente tabla:


Estructura de carpetas en Automation 360	Entrada
MetaTask	Común
MetaTask\Process1	Conectar
MetaTask\Process1	Desconectar
MetaTask\Process1\Operations	Numérico

La siguiente tabla proporciona información acerca de cómo el comando Import DataSet utilizado en la lógica de MetaBot se migra a las acciones equivalentes en Automation 360:


Tipo de reproducción	Acción Enterprise 11	Acción Automation 360
Objeto	Get Property, Get Total Items, Get Selected Index, Get Selected Text, Select Item by Text, Select Item by Index, Click, Left Click, Right Click, Double Click	Migrado a la action Captura del Recorder package.
Imagen	Clic con botón izquierdo	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con el Clic con botón izquierdo seleccionado de la lista Acción.
	Clic con botón derecho	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con el Clic con botón derecho seleccionado de la lista Acción.
	Doble clic	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con el Doble clic seleccionado de la lista Acción.
	Clic central	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con el Clic con botón izquierdo seleccionado de la lista Acción.
	Establecer texto	Migrado a: La action Ventana de búsqueda en ventana del Image Recognition package con el Clic con botón izquierdo seleccionado de la lista Acción. La action Retraso del Delay package con el retraso Común establecido en 500 milisegundos. La action Simular pulsaciones de teclas del Simulate keystrokes package.
Coordenada	Clic	Migrado a la action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas.
	Clic con botón izquierdo	Migrado a la action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas.
	Clic central	Migrado a la action Clic del Mouse package con las opciones Botón central y Clic seleccionadas.
	Doble clic	Migrado a la action Clic del Mouse package con las opciones Botón izquierdo y Doble clic seleccionadas.
	Establecer texto	Migrado a: La action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas. La action Retraso del Delay package con el retraso Común establecido en 500 milisegundos. La action Simular pulsaciones de teclas del Simulate keystrokes package.

La siguiente tabla proporciona información acerca de cómo el comando Export Dataset utilizado en la lógica de MetaBot se migra a las acciones equivalentes en Automation 360:


Tipo de reproducción	Acción Enterprise 11	Acción Automation 360
Objeto	Get Property, Get Total Items, Get Selected Index, Get Selected Text, Select Item by Text, Select Item by Index, Click, Left Click, Right Click, Double Click	Migrado a la action Captura del Recorder package.
Imagen	Clic con botón izquierdo	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con el Clic con botón izquierdo seleccionado de la lista Acción.
	Clic con botón derecho	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con el Clic con botón derecho seleccionado de la lista Acción.
	Doble clic	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con el Doble clic seleccionado de la lista Acción.
	Clic central	Migrado a la action Ventana de búsqueda en ventana del Image Recognition package con el Clic con botón izquierdo seleccionado de la lista Acción.
	Obtener texto	Migrado a la action Capturar área del OCR package.
Coordenada	Clic	Migrado a la action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas.
	Clic con botón izquierdo	Migrado a la action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas.
	Clic central	Migrado a la action Clic del Mouse package con las opciones Botón central y Clic seleccionadas.
	Doble clic	Migrado a la action Clic del Mouse package con las opciones Botón izquierdo y Doble clic seleccionadas.
	Obtener texto	Migrado a: La action Clic del Mouse package con las opciones Botón izquierdo y Clic seleccionadas. La action Borrar del Clipboard package. La action Retraso del Delay package con el retraso Común establecido en 500 milisegundos. La action Simular pulsaciones de teclas del Simulate keystrokes package. La action Retraso del Delay package con el retraso Común establecido en 500 milisegundos. La action Copiar a del Clipboard package.

Comando Ejecutar migración de la lógica

El comando Ejecutar lógica se utiliza en un bot para ejecutar una lógica específica desde un MetaBot en Enterprise 11. Cuando se migra ese bot, el comando Ejecutar lógica se convierte en la acción Ejecutar del Task Bot package.

Las variables de entrada se convierten en variables equivalentes en Automation 360 y las variables de salida se migran a una variable de diccionario. La tecla en la variable del diccionario se utiliza para utilizar el valor asociado. La variable de diccionario puede contener otros tipos de variables, por ejemplo, lista, valor, entero y matriz. Puede asignar las variables disponibles en la variable de diccionario con otros tipos de variables. Por ejemplo, puede asignar la variable de tipo lista disponible en la variable de diccionario con las variables de tipo lista, valor y matriz.

Migración de Ejecutar comando

Los DLL en los MetaBots utilizan el comando Ejecutar para ejecutar una función desde ese DLL. Después de la migración a Automation 360, cada comando Ejecutar se convierte en las acciones Abrir, Ejecutar función y Cerrar del paquete DLL. La información sobre qué función ejecutar desde el DLL, qué parámetros utilizar y otros detalles en el comando Ejecutar se migra a la acción Ejecutar.

A partir de Enterprise A2019.16 (6448), puede migrar MetaBots que contengan DLL cuyos tipos de retorno sean diferentes de los del MetaBot. La siguiente tabla proporciona información sobre el tipo de variable de la salida del MetaBot y el tipo de retorno de un archivo DLL.


Tipo de variable MetaBot	Tipo de retorno de función DLL
Valor	Matriz bidimensional, Lista, Byte en matriz (Byte[]), enteros sin signo (UInt32, UInt64), enteros con signo, IDictionary, IList y enteros sin signo en matriz (UInt16[], UInt32[], UInt64[]), Byte con signo
Matriz	Matriz bidimensional, Lista, enteros sin signo (UInt16[], UInt32, UInt64), enteros con signo, IList, Byte con signo e IDictionary

Nota: La migración de bots que utiliza la variable IDictionay es compatible, sin embargo, es posible que los bots migrados no devuelvan el valor correcto. Este comportamiento es el mismo que en Enterprise 11 o Enterprise 10.

La siguiente tabla proporciona información sobre el tipo de variable que pasa desde MetaBot y el tipo de entrada que acepta un archivo DLL.


Tipo de variable de MetaBot	Tipo de variable de entrada que acepta el DLL
Lista	Matriz bidimensional, lista, byte, enteros sin signo (UInt16, UInt32, UInt64), enteros con signo, Byte con signo, byte en matriz (Byte[]) y enteros sin signo en matriz (UInt16[], UInt32[], UInt64[])
Matriz	Matriz bidimensional, lista, byte, enteros sin signo (UInt16, UInt32, UInt64), enteros con signo, Byte con signo, byte en matriz (Byte[]) y enteros sin signo en matriz (UInt16[], UInt32[], UInt64[])
Valor	Byte, enteros sin signo (UInt16, UInt32, UInt64), enteros con signo, Byte con signo
Diccionario	Byte, enteros sin signo (UInt16, UInt32, UInt64), enteros con signo, Byte con signo