Como MetaBots são migrados
- Última atualização2022/12/04
Como MetaBots são migrados
Quando você migra um MetaBot para Automation 360, são criados bots equivalentes para a lógica disponível no MetaBot, exceto para telas de aplicativos. Após a migração bem-sucedida, cada lógica em um arquivo .mbot é convertida em um arquivo Task Bot.
Um MetaBot contém ativos e lógica. Os ativos são as telas ou DLLs do aplicativo que são usadas para automatizar uma tarefa em um aplicativo. Lógica é um conjunto de comandos para executar uma operação e interagir com outra lógica e bots.
- Antes de migrar .atmx ou .mbot usando o Assistente de migração de bot, verifique se todas as Lógicas, arquivos dlls, .mbots, .atmx e outras dependências relacionadas com os MetaBots ou Task Bots que foram anteriormente migradas não estão no estado Check-out . Caso contrário, o seguinte erro ocorrerá durante a remigração:Os detalhes da migração malsucedida são exibidos na guia .
O bot não está pronto para migração.
- Se o bot que você estiver migrando tiver passado por check-out ou tiver sido migrado anteriormente, verifique se o bot a ser migrado está no estado Check-in . Também, para reutilizar o bot migrado, no Assistente de migração de bot, selecione a opção Sobrescrever se existir um bot com o mesmo nome. Para usar um bot atualizado, desative a opção Sobrescrever se existir um bot com o mesmo nome.
- Converte a lógica do MetaBot para o Task Bots correspondente.
- Mantém a estrutura de pastas dos MetaBots depois da migração. As novas pastas criadas em Automation 360 contêm os Task Bots para cada lógica migrada para o Automation 360.
- Atualiza os Task Bots que usam a lógica do MetaBot para fazer referência aos novos Task Bots que são criado para a lógica migrada do MetaBot.
Você não precisa atualizar os Task Bots manualmente.
Recursos como o uso de DLLs, variáveis de entrada e saída e permissão Executar que estavam disponíveis apenas para os MetaBots agora estão disponíveis para todos os Task Bots.
- Nome do MetaBot: MetaTask
- Ativos:
- Tela de login
- Geral.dll
- DLL\Binary.dll
- Lógica:
- Common
- Process1\Connect
- Process1\Disconnect
- Process1\Operations\Numeric
Benefícios dos Task Bots reutilizáveis em Automation 360
| Task Bots reutilizáveis em Automation 360 | MetaBots v11 |
|---|---|
| Você pode navegar para um bot secundário com menos cliques usando o componente Finder, economizando tempo. Navegue para para acessar o bot secundário. | Você deve navegar através da ação para acessar o bot secundário. |
| Você pode pesquisar os bots secundários no espaço de trabalho privado, bem como no espaço de trabalho público, para utilizá-los em Task Bots. | Você deve baixar os MetaBots para o repositório local para usar um bot secundário nos Task Bots. |
| Apenas um Lógica específico é implantado quando utilizado em uma tarefa, o que economiza tempo e largura de banda. | Um MetaBot completo é implantado na máquina Executor de bots, mesmo que apenas uma Lógica seja usada na Tarefa. |
| Proporciona melhor RBAC, o que permite a você personalizar as permissões. | Os MetaBots forçam todas as Lógica a ter as mesmas permissões, mesmo que várias Lógica estejam espalhadas por diferentes pastas. |
Processo de migração do MetaBot
O sistema cria uma pasta com o mesmo nome que o MetaBot dentro da pasta My MetaBots disponível na pasta Bots e a mesma estrutura de pastas em que Enterprise 11 fica. Por exemplo, se a estrutura de pastas no Enterprise 11 for Accounts/Tax/MetaTask.mbot, o sistema reterá a estrutura de pastas como Accounts/Tax/MetaTask.mbot. Todos os componentes de um MetaBot são armazenados na pasta criada para esse MetaBot. Neste exemplo, o sistema cria a pasta MetaTask na pasta Bots\My MetaBots e armazena todos os componentes do MetaBot nessa pasta.
Os bots de Enterprise 10 que chamam diretamente de DLLs e telas em um MetaBot sem usar lógica de MetaBot foram migrados para os Task Bots e ações equivalentes no Automation 360. Na Enterprise 10, se uma DLL que retorna uma lista ou parâmetros tipo array, bem como a saída dessa DLL, for mapeada com um parâmetro tipo valor, um espaço extra será adicionado no início do valor de saída. O espaço extra não é adicionado ao valor de saída após o bot ser migrado.
Migração de DLLs
O sistema não mantém a estrutura de pastas para ativos a fim de manter as referências entre as DLLs. No exemplo acima, General.dll e Binary.dll são armazenados na pasta MetaTask, embora o Binaary.dll seja armazenado na subpasta DLL.
Veja o vídeo a seguir para informações sobre a migração MetaBots com DLLs para o Automation 360:
Visão geral do processo de migração MetaBot
- Conceito de sessão DLL nas migrações bot
-
As seguintes mudanças DLL são observadas nas migrações bot:
- Ao migrar uma Task Bot com múltiplos MetaBots que contêm DLLs com o mesmo nome, é criado um nome de sessão usando o nome da primeira DLL. Quando a DLL subsequente com o mesmo nome de outro MetaBot é migrada, o ID da pasta em que a DLL reside é utilizado como um nome de sessão.
Por exemplo:
M_DLL_Session-<MetabotFolderId>_<DLLName>. - Quando o comando Executar DLL no Enterprise 11 é migrado para Automation 360, o comando é convertido para as ações Abrir e Função Executar e a Sessão Dll não existe condição Se.
- O nome da sessão DLL é criado anexando o nome da DLL ao símbolo "M-DLL-Session-". Por exemplo, se o nome DLL for Amostra.dll, após a migração, o nome da sessão DLL será M-DLL-Session-Sample.
- A sessão DLL representa a DLL que ela está usando para executar as funções DLL.
- Para executar múltiplas funções da mesma DLL, o mesmo nome de sessão DLL deve ser fornecido no Nome da sessão campo.
- Ao migrar uma Task Bot com múltiplos MetaBots que contêm DLLs com o mesmo nome, é criado um nome de sessão usando o nome da primeira DLL. Quando a DLL subsequente com o mesmo nome de outro MetaBot é migrada, o ID da pasta em que a DLL reside é utilizado como um nome de sessão.
- Condição para verificar a existência de uma sessão DLL em um bot migrado
-
Após a migração, quando a mesma DLL é utilizada em várias lógicas da mesma MetaBot, a condição para verificar se uma sessão DLL já está aberta é adicionada para cada DLL para garantir que a sessão DLL seja aberta apenas uma vez. Algumas DLLs que são utilizadas em MetaBot compartilham sessões ou variáveis globais através de múltiplas funções DLL. Se tais funções DLL forem chamadas de diferentes lógicas, o compartilhamento de tais sessões e variáveis só é possível se a sessão DLL for aberta apenas uma vez e uma condição for adicionada para verificar se uma sessão DLL já está disponível. Se uma sessão DLL estiver faltando, o Automation 360 cria uma sessão DLL do tipo Global.
- O que acontece a um Task Bot migrado que tem referência a duas funções DLL de uma mesma lógica ou de lógicas diferentes de um MetaBot?
-
Em Enterprise 11, se um Task Bot estava se referindo a uma lógica que chamava duas funções usando o comando Lógica de execução, no Automation 360 uma sessão de DLL será criada no Task Bot (as lógicas são migradas como Task Bots) e será utilizado na ação Função Run. Além disso, quando um Task Bot refere-se a múltiplas lógicas que chamam múltiplas funções, o Task Bots utilizará o mesmo nome de sessão DLL para executar as funções. A verificação da condição da sessão DLL garantirá que apenas uma sessão seja criada através de tais lógicas.
Por exemplo, se um Task Bot está usando MetaBot1 Logic e MetaBot2 Logic onde MetaBot1 Logic e MetaBot2 Logic estão chamando múltiplas funções, quando você executa o Taskbot, um nome de sessão DLL é criado para executar MetaBot1 Logic. O nome da sessão DLL que foi criada para executar MetaBot1 Logic também será usado para executar MetaBot2 Logic.
Migração de telas
Cada tela em um MetaBot é convertida em uma variável do Windows e as ações executadas na tela são migradas para as ações equivalentes no Automation 360.
| Navegador | Internet Explorer Google Chrome (apenas para tipo de reprodução de objetos) |
| Tipo de tela | Padrão |
| Tecnologia | Java, HTML, MSAA, .Net, Automação de UI (apenas para tipo de reprodução de objetos) |
| Tipo de reprodução | Objeto, imagem, coordenada |
Você também pode migrar MetaBots com telas que são capturadas no ambiente Citrix por aplicativos com base em Java, automação de UI e tecnologias MSAA.
Os objetos vinculados em uma tela do MetaBot que são capturados usando o tipo de reprodução de objetos são migrados para a ação de Captura do Gravadorpacote. O objeto de origem é exibido em Principal, e o objeto associado é exibido na guia Âncora da ação de Captura.
| Tipo de reprodução | Ação Enterprise 11 | Ação Automation 360 |
|---|---|---|
| Objeto | Obter propriedade, Obter total de itens, Obter índice selecionado, Obter texto selecionado, Selecionar item por texto, Selecionar item por índice, Clique, Clique com o botão esquerdo do mouse, Clique com o botão direito do mouse, Clique duplo, Definir texto, Anexar texto, Obter propriedade, Verificar, Desmarcar, Alternar, Expandir, Selecionar, Obter status | Migrado para a ação Captura do Gravadorpacote. Os comandos GetAllChidrenName e GetAllChidrenValue em Enterprise 11/Enterprise 10 retornam valores da variável do tipo String. No Automation 360, elas retornam valores de lista. O processo de migração une os valores de lista e os armazena em uma variável string para manter comportamentos consistentes de bot em todas as versões. O comando Clonagem de objetos com a ação Exportar para CSV em Enterprise 11/Enterprise 10 é migrado para:
|
| Tipo de reprodução | Ação Enterprise 11 | Ação Automation 360 |
|---|---|---|
| Imagem | Clique com o botão esquerdo do mouse | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique com o botão esquerdo do mouse selecionado na lista de Ação. |
| Clique com o botão direito do mouse | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique com o botão direito do mouse selecionado na lista de Ação. | |
| Clique duplo | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique duplo selecionado na lista de Ação. | |
| Clique no meio | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique com o botão esquerdo do mouse selecionado na lista de Ação. | |
| Definir Texto | Migrado para:
|
|
| Obter texto | Migrado para a ação Capturar área da pacote do OCR. | |
| GetVisibility | Migrado para ação IF com condição Reconhecimento de imagem: Encontrar janela na janela. A ação GetVisibility retorna um valor Verdadeiro ou Falso com base no fato de o objeto em uma imagem ser visível ou não. Da mesma forma, a condição dentro da ação IF é avaliada com base em na possibilidade de a janela ser encontrada em outra janela. O resultado é armazenado em uma variável temporária. |
| Tipo de reprodução | Ação Enterprise 11 | Ação Automation 360 |
|---|---|---|
| Coordenada | Clique | Migrado para a ação Clique da pacote do Mouse com as opções Botão esquerdo e Clique selecionadas. |
| Clique com o botão esquerdo do mouse | Migrado para a ação Clique da pacote do Mouse com as opções Botão esquerdo e Clique selecionadas. | |
| Clique com o botão direito do mouse | Migrado para a ação Clicar da pacote do Mouse com as opções Botão direito e Clique selecionadas. | |
| Clique no meio | Migrado para a ação Clique da pacote do Mouse com as opções Botão do meio e Clique selecionadas. | |
| Clique duplo | Migrado para a ação Clique da pacote do Mouse com as opções Botão esquerdo e Clique duplo selecionadas. | |
| Definir texto | Migrado para:
|
|
| Obter texto | Migrado para:
|
| Tipo de reprodução | Enterprise 11 ação | Automation 360 ação |
|---|---|---|
| Coordenada | Clique | Migrado para a ação Clique da pacote do Mouse com as opções Botão esquerdo e Clique selecionadas. |
| Clique com o botão esquerdo do mouse | Migrado para a ação Clique da pacote do Mouse com as opções Botão esquerdo e Clique selecionadas. | |
| Clique no meio | Migrado para a ação Clique da pacote do Mouse com as opções Botão do meio e Clique selecionadas. | |
| Clique duplo | Migrado para a ação Clique da pacote do Mouse com as opções Botão esquerdo e Clique duplo selecionadas. | |
| Definir texto | Migrado para o seguinte:
|
|
| Obter texto | Migrado para o seguinte:
|
| Tipo de reprodução | Enterprise 11 ação | Automation 360 ação |
|---|---|---|
| Texto | Clique | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique com o botão esquerdo do mouse selecionado na lista de Ação. |
| Clique com o botão esquerdo do mouse | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique com o botão esquerdo do mouse selecionado na lista de Ação. | |
| Clique duplo | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique duplo selecionado na lista de Ação. | |
| Definir texto | Migrado para o seguinte:
|
|
| Obter texto | Migrado para a ação Capturar área da pacote do OCR. |
Migração da lógica
Cada lógica em um MetaBot é convertida em um Task Bot e cada comando usado em uma lógica é convertido na ação equivalente em Automation 360. A variável usada em uma lógica é convertida em uma variável equivalente no Automation 360. As variáveis de credenciais utilizadas na lógica são migradas para Automation 360 e utilizadas nas ações equivalentes nos bots migrados. Se o Tipo de parâmetro de uma variável for entrada ou saída, o mesmo será mantido após essa variável ser migrada para o Automation 360. Por exemplo, se o Tipo de parâmetro da variável ABC for definido como Entrada, a variável ABC criada em Automation 360 terá a opção Usar como entrada selecionada depois de ser migrada. O sistema retém a estrutura de pastas internas das lógicas. No exemplo acima, todas as lógicas migradas são armazenadas conforme listado na tabela a seguir:
| Estrutura da pasta em Automation 360 | Entrada |
|---|---|
| MetaTask | Comum |
| MetaTask\Process1 | Conectar |
| MetaTask\Process1 | Desconectar |
| MetaTask\Process1\Operations | Numérico |
| Tipo de reprodução | Ação Enterprise 11 | Ação Automation 360 |
|---|---|---|
| Objeto | Obter propriedade, Obter total de itens, Obter índice selecionado, Obter texto selecionado, Selecionar item por texto, Selecionar item por índice, Clicar, Clicar com o botão esquerdo do mouse, Clicar com o botão direito do mouse, Clicar duas vezes | Migrado para a ação Captura do Gravadorpacote. |
| Imagem | Clique com o botão esquerdo do mouse | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique com o botão esquerdo do mouse selecionado na lista de Ação. |
| Clique com o botão direito do mouse | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique com o botão direito do mouse selecionado na lista de Ação. | |
| Clique duplo | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique duplo selecionado na lista de Ação. | |
| Clique no meio | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique com o botão esquerdo do mouse selecionado na lista de Ação. | |
| Definir Texto | Migrado para:
|
|
| Coordenada | Clique | Migrado para a ação Clique da pacote do Mouse com as opções Botão esquerdo e Clique selecionadas. |
| Clique com o botão esquerdo do mouse | Migrado para a ação Clique da pacote do Mouse com as opções Botão esquerdo e Clique selecionadas. | |
| Clique no meio | Migrado para a ação Clique da pacote do Mouse com as opções Botão do meio e Clique selecionadas. | |
| Clique duplo | Migrado para a ação Clique da pacote do Mouse com as opções Botão esquerdo e Clique duplo selecionadas. | |
| Definir texto | Migrado para:
|
| Tipo de reprodução | Ação Enterprise 11 | Ação Automation 360 |
|---|---|---|
| Objeto | Obter propriedade, Obter total de itens, Obter índice selecionado, Obter texto selecionado, Selecionar item por texto, Selecionar item por índice, Clicar, Clicar com o botão esquerdo do mouse, Clicar com o botão direito do mouse, Clicar duas vezes | Migrado para a ação Captura do Gravadorpacote. |
| Imagem | Clique com o botão esquerdo do mouse | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique com o botão esquerdo do mouse selecionado na lista de Ação. |
| Clique com o botão direito do mouse | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique com o botão direito do mouse selecionado na lista de Ação. | |
| Clique duplo | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique duplo selecionado na lista de Ação. | |
| Clique no meio | Migrado para a ação Encontrar janela na janela da pacote do Reconhecimento de imagem com Clique com o botão esquerdo do mouse selecionado na lista de Ação. | |
| Obter texto | Migrado para a ação Capturar área da pacote do OCR. | |
| Coordenada | Clique | Migrado para a ação Clique da pacote do Mouse com as opções Botão esquerdo e Clique selecionadas. |
| Clique com o botão esquerdo do mouse | Migrado para a ação Clique da pacote do Mouse com as opções Botão esquerdo e Clique selecionadas. | |
| Clique no meio | Migrado para a ação Clique da pacote do Mouse com as opções Botão do meio e Clique selecionadas. | |
| Clique duplo | Migrado para a ação Clique da pacote do Mouse com as opções Botão esquerdo e Clique duplo selecionadas. | |
| Obter texto | Migrado para:
|
Comando Migração de Lógica de Execução
O comando Executar lógica é usado em um bot para executar uma lógica específica de um MetaBot no Enterprise 11. Quando você migrar este bot, o comando Lógica de execução é convertido para a ação Executar da pacote do Task Bot.
As variáveis de entrada são convertidas em variáveis equivalentes no Automation 360 e as variáveis de saída são migradas para uma variável de dicionário. Você usa a chave na variável de dicionário para usar o valor associado. A variável do dicionário pode conter outros tipos de variáveis, por exemplo, lista, valor, inteiro e array. Você pode mapear as variáveis disponíveis na variável do dicionário com outros tipos de variáveis. Por exemplo, você pode mapear a variável tipo lista disponível na variável do dicionário com a lista, o valor e as variáveis do tipo array.
Migração do comando Executar
As DLLs no MetaBots usam o comando Executar para executar uma função a partir dessa DLL. Após a migração para o Automation 360, cada comando Executar é convertido nas ações Abrir, Executar função e Fechar do pacote DLL. As informações sobre qual função executar pela DLL, quais parâmetros usar e outros detalhes no comando Executar são migradas para a ação Executar.
| Tipo de variável MetaBot | Tipo de retorno da função DLL |
|---|---|
| Valor | Matriz bidimensional, Lista, Byte in array (Byte[]), inteiros não assinados (UInt32, UInt64), inteiros assinados, IDictionary, IList e inteiros não assinados em array (UInt16[], UInt32[], UInt64[]), Byte assinado |
| Matriz | Matriz bidimensional, Lista, inteiros não assinados (UInt16[], UInt32, UInt64), inteiros assinados, IList, Byte assinado e IDictionary |
| Tipo de variável de MetaBot | Tipo de variável de entrada aceita pela DLL |
|---|---|
| Lista | Matriz bidimensional, lista, byte, inteiros não assinados (UInt16, UInt32, UInt64), inteiros assinados, Byte, byte em array (Byte[]) e inteiros não assinados em array (UInt16[], UInt32[], UInt64[]) |
| Matriz | Matriz bidimensional, lista, byte, inteiros não assinados (UInt16, UInt32, UInt64), inteiros assinados, Byte, byte em array (Byte[]) e inteiros não assinados em array (UInt16[], UInt32[], UInt64[]) |
| Valor | Byte, inteiros não assinados (UInt16, UInt32, UInt64), inteiros assinados, byte assinado |
| Dicionário | Byte, inteiros não assinados (UInt16, UInt32, UInt64), inteiros assinados, byte assinado |