Cómo se migran MetaBots
- Última actualización2022/12/04
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 Bot de tarea.
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.
- Antes de migrar .atmx o .mbot con el Asistente de migración de bots, asegúrese de que todos los archivos Logics, dlls, .mbots, .atmx y otras dependencias relacionadas con el MetaBots o Bots de tarea que se migraron anteriormente no se encuentren en el estado Checked-out . De lo contrario, se produce el siguiente error durante la remigración:Los detalles de la migración fallida se muestran en la pestaña .
Bot no listo para la migración.
- Si el bot que va a migrar ha sido retirado o ha sido migrado anteriormente, asegúrese de que el bot que se va a migrar se encuentra en el estado Checked-in . Además, para reutilizar el bot migrado, en el Asistente de migración de bots, seleccione la opción Sobrescribir si existe un bot con el mismo nombre. Para utilizar un bot actualizado, desactive la opción Sobrescribir si existe un bot con el mismo nombre.
- Convierte la lógica del MetaBot a Bots de tarea correspondientes.
- Mantiene la estructura de carpetas de los MetaBots después de migrar. Las nuevas carpetas creadas en Automation 360 contienen Bots de tarea para cada lógica migrada a Automation 360.
- Actualiza los Bots de tarea que utilizan lógica de MetaBot para referirse a los nuevos Bots de tarea que se crearon para la lógica del MetaBot migrado .
No es necesario que actualice los Bots de tarea 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 Bots de tarea.
- 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 Bots de tarea reutilizables en Automation 360
| Bots de tarea 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 para llegar al bot secundario. | Debe navegar por la acción para llegar al bot secundario. |
| Puede buscar los bots secundarios desde el espacio de trabajo privado y desde el espacio de trabajo público para utilizarlos en Bots de tarea. | Debe descargar los MetaBots en el repositorio local para utilizar un bot secundario en los Bots de tarea. |
| Solo se implementa una Lógica 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 Lógica 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 Lógica tengan los mismos permisos, incluso si varias Lógica 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 Bots de tarea y acciones 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.
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.
Consulte el siguiente video para obtener información sobre la migración de MetaBots con DLL a Automation 360:
Resumen del proceso de migración de MetaBot
- Concepto de sesión de DLL en el bot migrado
-
Se observan los siguientes cambios de DLL en el bot migrado:
- Cuando se migra un Bot de tarea con varios MetaBots que contienen DLL con el mismo nombre, se crea un nombre de sesión que utiliza el nombre del primer DLL. Cuando se migra la DLL posterior con el mismo nombre de otro MetaBot, se utiliza el ID de la carpeta en la que reside la DLL como nombre de sesión.
Por ejemplo:
M_DLL_Session-<MetabotFolderId>_<DLLName>. - Cuando el comando Ejecutar DLL en Enterprise 11 se migra a Automation 360, el comando se convierte en las acciones Abrir y Ejecutar función y la condición Sesión de DLL no existe.
- El nombre de la sesión de DLL se crea al agregar el nombre de la DLL al token "M-DLL-Session-". Por ejemplo, si el nombre de la DLL es Sample.dll, después de la migración, el nombre de la sesión de DLL será M-DLL-Session-Sample.
- La sesión de DLL representa la DLL que utiliza para ejecutar las funciones DLL.
- Para ejecutar varias funciones desde la misma DLL, se debe proporcionar el mismo nombre de sesión de DLL en el campo Nombre de la sesión.
- Cuando se migra un Bot de tarea con varios MetaBots que contienen DLL con el mismo nombre, se crea un nombre de sesión que utiliza el nombre del primer DLL. Cuando se migra la DLL posterior con el mismo nombre de otro MetaBot, se utiliza el ID de la carpeta en la que reside la DLL como nombre de sesión.
- Condición para comprobar la existencia de una sesión de DLL en un bot migrado
-
Tras la migración, cuando se utiliza la misma DLL en varias lógicas del mismo MetaBot, se añade una condición para comprobar si la sesión de la DLL ya está abierta para cada DLL para garantizar que la sesión de DLL se abra solo una vez. Algunas DLL que se utilizan en MetaBot comparten sesiones o variables globales a través de múltiples funciones DLL. Si a dichas funciones de DLL se las llama desde diferentes lógicas, compartir dichas sesiones y variables solo es posible si la sesión de DLL se abre una sola vez y se agrega una condición para comprobar si una sesión de DLL ya está disponible. Si falta una sesión de DLL, Automation 360 crea una sesión de DLL del tipo Global.
- ¿Qué ocurre con una Bot de tarea migrada que tiene referencia a dos funciones de DLL de la misma o diferente lógica de un MetaBot?
-
En Enterprise 11, si un Bot de tarea hacía referencia a una lógica que llamaba a dos funciones mediante el comando Ejecutar lógica, en Automation 360, se creará una sesión de DLL en la Bot de tarea (las lógicas se migran como Bots de tarea) y se utilizará en la acción Ejecutar función. Además, cuando una Bot de tarea hace referencia a varias lógicas que llaman a varias funciones, la Bots de tarea utilizará el mismo nombre de sesión de DLL para ejecutar las funciones. La comprobación de la condición de sesión de DLL garantizará que solo se cree una sesión a través de dichas lógicas.
Por ejemplo, si una Bot de tarea utiliza MetaBot1 Logic y MetaBot2 Logic donde MetaBot1 Logic y MetaBot2 Logic llaman a múltiples funciones, cuando se ejecuta Taskbot, se crea un nombre de sesión de DLL para ejecutar MetaBot1 Logic. El nombre de la sesión de DLL que se creó para ejecutar MetaBot1 Logic se utilizará también para ejecutar MetaBot2 Logic.
Migración de pantallas
Cada pantalla en un MetaBot se convierte en una variable de Windows y las acciones realizadas en la pantalla se migran a las acciones equivalentes en 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 acción Captura del Grabadora paquete. 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.
| 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 acción Captura del Grabadora paquete. 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:
|
| Tipo de reproducción | Acción Enterprise 11 | Acción Automation 360 |
|---|---|---|
| Imagen | Clic con botón izquierdo | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con el Clic con botón izquierdo seleccionado de la lista Acción. |
| Clic con botón derecho | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con el Clic con botón derecho seleccionado de la lista Acción. | |
| Doble clic | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con el Doble clic seleccionado de la lista Acción. | |
| Clic central | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con el Clic con botón izquierdo seleccionado de la lista Acción. | |
| Establecer texto | Migrado a:
|
|
| Obtener texto | Migrado a la acción Capturar área del OCR paquete. | |
| Obtener visibilidad | Migrado a la acción SI con la condición Reconocimiento de imágenes: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. |
| Tipo de reproducción | Acción Enterprise 11 | Acción Automation 360 |
|---|---|---|
| Coordenada | Clic | Migrado a la acción Clic del Mouse paquete con las opciones Botón izquierdo y Clic seleccionadas. |
| Clic con botón izquierdo | Migrado a la acción Clic del Mouse paquete con las opciones Botón izquierdo y Clic seleccionadas. | |
| Clic con botón derecho | Migrado a la acción Clic del Mouse paquete con las opciones Botón derecho y Clic seleccionadas. | |
| Clic central | Migrado a la acción Clic del Mouse paquete con las opciones Botón central y Clic seleccionadas. | |
| Doble clic | Migrado a la acción Clic del Mouse paquete con las opciones Botón izquierdo y Doble clic seleccionadas. | |
| Establecer texto | Migrado a:
|
|
| Obtener texto | Migrado a:
|
| Tipo de reproducción | Acción Enterprise 11 | Acción Automation 360 |
|---|---|---|
| Coordenada | Clic | Migrado a la acción Clic del Mouse paquete con las opciones Botón izquierdo y Clic seleccionadas. |
| Clic con botón izquierdo | Migrado a la acción Clic del Mouse paquete con las opciones Botón izquierdo y Clic seleccionadas. | |
| Clic central | Migrado a la acción Clic del Mouse paquete con las opciones Botón central y Clic seleccionadas. | |
| Doble clic | Migrado a la acción Clic del Mouse paquete con las opciones Botón izquierdo y Doble clic seleccionadas. | |
| Establecer texto | Se migra a lo siguiente:
|
|
| Obtener texto | Se migra a lo siguiente:
|
| Tipo de reproducción | Acción Enterprise 11 | Acción Automation 360 |
|---|---|---|
| Texto | Clic | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con Clic con botón izquierdo seleccionado de la lista Acción. |
| Clic con botón izquierdo | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con Clic con botón izquierdo seleccionado de la lista Acción. | |
| Doble clic | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con Doble clic seleccionado de la lista Acción. | |
| Establecer texto | Se migra a lo siguiente:
|
|
| Obtener texto | Migrado a la acción Capturar área del OCR paquete. |
Migración de lógica
Cada lógica en un MetaBot se convierte en un Bot de tarea 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 |
| 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 acción Captura del Grabadora paquete. |
| Imagen | Clic con botón izquierdo | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con el Clic con botón izquierdo seleccionado de la lista Acción. |
| Clic con botón derecho | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con el Clic con botón derecho seleccionado de la lista Acción. | |
| Doble clic | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con el Doble clic seleccionado de la lista Acción. | |
| Clic central | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con el Clic con botón izquierdo seleccionado de la lista Acción. | |
| Establecer texto | Migrado a:
|
|
| Coordenada | Clic | Migrado a la acción Clic del Mouse paquete con las opciones Botón izquierdo y Clic seleccionadas. |
| Clic con botón izquierdo | Migrado a la acción Clic del Mouse paquete con las opciones Botón izquierdo y Clic seleccionadas. | |
| Clic central | Migrado a la acción Clic del Mouse paquete con las opciones Botón central y Clic seleccionadas. | |
| Doble clic | Migrado a la acción Clic del Mouse paquete con las opciones Botón izquierdo y Doble clic seleccionadas. | |
| Establecer texto | Migrado a:
|
| 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 acción Captura del Grabadora paquete. |
| Imagen | Clic con botón izquierdo | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con el Clic con botón izquierdo seleccionado de la lista Acción. |
| Clic con botón derecho | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con el Clic con botón derecho seleccionado de la lista Acción. | |
| Doble clic | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con el Doble clic seleccionado de la lista Acción. | |
| Clic central | Migrado a la acción Ventana de búsqueda en ventana del Reconocimiento de imágenes paquete con el Clic con botón izquierdo seleccionado de la lista Acción. | |
| Obtener texto | Migrado a la acción Capturar área del OCR paquete. | |
| Coordenada | Clic | Migrado a la acción Clic del Mouse paquete con las opciones Botón izquierdo y Clic seleccionadas. |
| Clic con botón izquierdo | Migrado a la acción Clic del Mouse paquete con las opciones Botón izquierdo y Clic seleccionadas. | |
| Clic central | Migrado a la acción Clic del Mouse paquete con las opciones Botón central y Clic seleccionadas. | |
| Doble clic | Migrado a la acción Clic del Mouse paquete con las opciones Botón izquierdo y Doble clic seleccionadas. | |
| Obtener texto | Migrado a:
|
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 Bot de tarea paquete.
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.
| 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 |
| 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 |