Analisar o relatório do Bot Scanner para migração

É possível analisar o relatório gerado pelo Bot Scanner para obter informações sobre os bots (Task Bots e MetaBots) e processos que podem ser migrados. Use o Bot Scanner para decidir se você está pronto para iniciar a migração agora ou se prefere esperar até que mais comandos sejam compatíveis.

O relatório Bot Scanner fornece as seguintes informações:

  • Bots: No relatório Bot Scanner, um bot é um Task Bot (.atmx) ou MetaBot (.mbot) individual que é usado em outros bots.

    A guia Bots fornece informações detalhadas sobre bots, que podem ser migradas, aquelas que requerem ação ou revisão e aquelas que não podem ser migradas.

  • Processos: No relatório Bot Scanner, um processo é um bot que não é usado em nenhum outro bots e pode incluir um ou mais bots secundários.

    A guia Processos fornece informações detalhadas sobre os processos que podem ser migrados, aqueles que requerem ação ou revisão, e aqueles que não podem ser migrados.

O Bot Scanner oferece as seguintes informações importantes sobre os bots e os processos:
  • Número de bots e processos analisados
  • Um resumo de alto nível na forma de conselhos para indicar o status de migração de bots e processos
  • Número de bots e processos para os quais você pode e não pode migrar Automation 360
  • Comandos usados nos bots e a frequência de uso
  • Motivos pelos quais os bots e os processos não podem ser migrados e a frequência de tais ocorrências
  • Ações e revisões exigidas pelos usuários após a migração devido à alteração no comportamento dos comandos
  • Bots e processos que não podem ser migrados e as mensagens de erro correspondentes
  • Número de linhas em bots e o número total de linhas de cada bots associado a um processo
  • Número de linha para cada bots e processos que precisam de revisão ou ação
Importante: O Automation 360 é atualizado frequentemente para atingir 100% de equivalência funcional com as versões do Enterprise 10 ou Enterprise 11. O percentual de bots, comandos e variáveis que são compatíveis para migração no Automation 360 aumentará até atingir 100% nas próximas versões lançadas. Ou seja, para cada função que você cria no Enterprise 10 ou Enterprise 11, uma capacidade equivalente está no Automation 360.

A maioria dos recursos do Enterprise 10 ou Enterprise 11 estão disponíveis como estão; no entanto, alguns recursos são implementados de modo diferente para ser compatível com operações sem client (web). Para esses recursos, você precisa mudar a forma como os bots são escritos.

O Bot Scanner foi desenvolvido para varrer os bots (Task Bots e MetaBots) criados usando as versões Enterprise 10 e Enterprise 11 do Enterprise Client. A contagem total de arquivos inclui o número de arquivos ignorados e não digitalizados.

Os relatórios estão disponíveis no local de saída que você especificou no campo Selecionar pasta de destino na caixa de diálogo Automation Anywhere Bot Scanner O Bot Scanner gera um relatório resumido e um relatório resumido (summary.html) e separa o XML para cada bot que foi digitalizado. Ele cria um relatório separado para cada lógica disponível em um MetaBot.

Uma pasta raw-data é criada contendo os relatórios (no formato XML) para cada bot escaneado. Ela ajuda nossos engenheiros a analisar melhor o processo de migração e tomar medidas corretivas, se necessário. Nenhuma PII (Personally Identifiable Information, informação de identificação pessoal) está incluída no relatório resumido ou nos relatórios individuais dos bots digitalizados.

Se você optar por compartilhar os relatórios conosco para ajudar a melhorar o produto, compacte os arquivos na pasta raw-data e coordene com seu CSM (Customer Success Manager, gerente de sucesso do cliente) ou PEM (Partner Enablement Manager, gerente de capacitação de parceiro). Nenhum dado é compartilhado automaticamente com a Automation Anywhere.

Relatório resumido de todos os bots

O Bot Scanner oferece uma opção para procurar por bots ou processos, ou bots e processos. Dependendo do que você escolher, o relatório resumido conterá informações sobre o bots, processos ou bots e processos. A maioria das seções vistas nestes relatórios resumidos serão as mesmas, exceto que no bots e o processos do relatório resumido. Você também verá um relatório adicional Todos que lista todos os bots ou processos que são marcados e classificados como Ação necessária, Revisão necessária, Não é necessária revisãoe Não migrável.
Nota: Para gerar um relatório resumido de processos, o tamanho máximo de repositório suportado é de até 10 Gb.
O relatório resumido fornece informações sobre:
  • se você pode migrar para Automation 360
  • O número de bots digitalizados
  • bots somente relatório que fornece informações sobre o bots apoiado para migração para Automation 360 (em porcentagem)
  • processos que fornecem informações sobre os processos apoiados para a migração para Automation 360
  • bots e processos combinados relatório que fornece informações sobre o bots e processos apoiados para migração para Automation 360

Por exemplo, considere que o Bot Scanner digitalizou 10 bots. Dos 10 bots, se 8 bots estão prontos para a migração para o Automation 360 e, em seguida, a porcentagem de bots que pode ser migrado é de 80% e a porcentagem de bots que não pode ser migrado agora é de 20%.

Análise do relatório Bot Scanner para bots
Considere um cenário onde você escaneou um total de 1618 bots, dos quais 98% (1614 bots) podem ser migrados para Automation 360. No entanto, 5% dos bots exigem ação após a migração, e 2% (4 bots) não pode ser migrado atualmente devido a certas razões. Em tal cenário, o Bot Scanner permite a realização das seguintes ações:
  • Identificar as ações e revisões a serem realizadas para os 5% restantes de bots para que você possa migrar com êxito a maioria de seus bots e os execute no Automation 360 após a migração.
  • Identificar os bots que podem ser migrados para Automation 360 sem qualquer intervenção manual.
  • Identificar o motivo pelo qual 2% dos bots não podem ser migrados atualmente e o tempo estimado para quando você poderá migrá-los mais tarde. O motivo pode ser devido a comandos e variáveis ainda não compatíveis no Automation 360.
Revendo o relatório de processos Bot Scanner
Para revisar uma mensagem de processo, execute estas etapas:
  1. Clique na guia Processos.
  2. Clique na guia de mensagens que você deseja analisar.
  3. Na coluna Referência de tarefa mestre, clique no ícone de expansão (ícone de expansão para processos) para visualizar o processo.
  4. Clique em um nome de processo para visualizar a mensagem.
Considere um cenário onde você escaneou um total de 100, dos quais 98% (1614 ) podem ser migrados para Automation 360. Entretanto, cinco processos requerem ação após a migração, 10 processos requerem revisão após a migração e 1 processo não pode ser migrado atualmente devido a certos motivos. Em tal cenário, o Bot Scanner permite a realização das seguintes ações:
  • Identificar as ações e as revisões a serem realizadas para os 15 processos restantes, para que você possa migrar com êxito a maioria dos seus processos e os execute no Automation 360 após a migração.
  • Identificar os processos que podem ser migrados para Automation 360 sem qualquer intervenção manual.
  • Identificar o motivo pelo qual 1 processo não pode ser migrado atualmente e o tempo estimado para quando você poderá migrá-lo mais tarde.

    O motivo pode ser devido a comandos e variáveis ainda não compatíveis no Automation 360.

A seguinte imagem é uma amostra do relatório do Bot Scanner:

Uma amostra Bot Scanner relatório

A tabela a seguir descreve os vários campos da amostra de relatório do Bot Scanner (conforme numerado na imagem anterior):

Opção/campo Descrição
1 Fornece um resumo e status da prontidão da migração do bots. Revise o status de migrado com base no seguinte:
  • Verde: Você pode prosseguir com a migração, desde que analise o relatório para qualquer ação ou revisão necessária para sua bots.
  • Âmbar: Você tem que esperar pela migração do bots como a porcentagem de bots que são qualificados para migração não atendem aos requisitos de migração.
2 Fornece um resumo das seguintes informações para bots:
  • Bots migráveis: Fornece um resumo do número total de bots que podem ser migrados.
  • Total de bots: Fornece um resumo do número total de bots que foram escaneados.
  • Ação necessária: Fornece um resumo do número total de bots que requerem ação após a migração para Automation 360.
  • Revisão necessária: Fornece um resumo do número total de bots que requerem revisão após a migração para Automation 360.
  • Nenhuma revisão necessária: Fornece um resumo do número total de bots que podem ser migrados para Automation 360 sem qualquer intervenção manual.
  • Não migrável: Fornece um resumo do número total de bots que não podem ser migrados atualmente para Automation 360.
3 Fornece recursos adicionais para facilitar o processo de migração.
4 Fornece um resumo das seguintes informações para os processos:
  • Processos de migração: Fornece um resumo do número total de processos que podem ser migrados.
  • Processos totais: Fornece um resumo do número total de processos que foram escaneados.
  • Ação necessária: Fornece um resumo do número total de processos que requerem ação após a migração para Automation 360. Mesmo que um bot secundário em um processo que requer ação, o processo é sinalizado como Ação necessária.
    Nota: Se um processo contiver bots, em que alguns deles requerem revisão e outros requerem ação, então o processo é sinalizado como Ação necessária. O status Ação necessária tem precedência sobre o status Revisão necessária.
  • Revisão necessária: Fornece um resumo do número total de processos que requerem revisão após a migração para Automation 360. Mesmo que um bot secundário em um processo que requer revisar, o processo é sinalizado como Revisão necessária.
  • Nenhuma revisão necessária: Fornece um resumo do número total de processos que podem ser migrados para Automation 360 sem qualquer intervenção manual. Todos os bots no processo podem ser migrados.
  • Não migrável: Fornece um resumo do número total de processos que não podem ser migrados atualmente para Automation 360. Todos os bots no processo não podem ser migrados.
5
  • Bots > Todos > Bots ou Processos > Todos > Bots: Acesse esta visualização para uma lista de todos os bots ou processos que são marcados e classificados como Ação necessária, Revisão necessária, Não é necessária revisãoe Não migrável.
  • Para ver a mensagem de um bot que requer ação ou revisão, clique no nome bot.
  • Para visualizar a mensagem de um processo específico que requer ação ou revisão, clique no ícone de expansão (ícone de expansão para processos) e clique no nome de referência da tarefa.
Clicar na mensagem traz informações sobre mudanças no comportamento do Automation 360 para o comando em comparação com o comportamento no Enterprise 11 ou Enterprise 10.
Nota: Cada mensagem inclui informações que você tem que revisar após a migração. Para obter uma lista dessas mensagens, consulte Mensagens migratórias. Use o código de mensagem (por exemplo, R102) para ver a mensagem específica rapidamente.
6 Bots > Ação necessária > Bots ou Processos > Ação necessária > Bots: Ir para esta exibição da lista de bots ou processos que requerem ação após a migração para o Automation 360.
  • Para visualizar a mensagem de um bot específico que precisa de ação, clique no nome do bot.
  • Para visualizar a mensagem de um processo específico que requer ação, clique no ícone de expansão (ícone de expansão para processos) e clique no nome de referência da tarefa.
Clicar na mensagem traz informações sobre mudanças no comportamento do Automation 360 para o comando em comparação com o comportamento no Enterprise 11 ou Enterprise 10.
Nota: Cada mensagem inclui informações que você tem que revisar após a migração. Para obter uma lista dessas mensagens, consulte Mensagens migratórias. Use o código de mensagem (por exemplo, R102) para ver a mensagem específica rapidamente.
7
  • Bots > Revisão necessária > Bots ou Processos > Revisão necessária > Bots: Acesse esta exibição para uma lista do bots ou processos que requerem revisão após a migração para Automation 360.
  • Para ver a mensagem de revisão necessária para um bot específico, clique no nome do bot.
  • Para visualizar a mensagem de revisão necessária para um processo específico, clique no ícone de expansão (ícone de expansão para processos) e clique no nome de referência da tarefa.

Clicar na mensagem traz informações sobre mudanças no comportamento do Automation 360 para o comando em comparação com o comportamento no Enterprise 11 ou Enterprise 10.

Nota: Cada mensagem inclui informações que você tem que revisar após a migração. Para obter uma lista dessas mensagens, consulte Mensagens migratórias. Use o código de mensagem (por exemplo, R102) para ver a mensagem específica rapidamente.
8 Bots > Não é necessária revisão > Bots ou Processos > Não é necessária revisão > Bots: Vá para esta exibição para uma lista de bots que podem ser migrados para o Automation 360 sem qualquer intervenção manual.
9 Bots > Não Migrável > Bots ou Processos > Não Migrável > Bots: Vá para esta exibição para uma lista de bots ou processos que não podem ser migrados atualmente para o Automation 360.
10 Bots > Comandos : Vá para esta exibição para uma lista dos comandos que podem ser migrados e o número de vezes que os comandos são usados em todos os seus escaneados bots.
11
  • Nome do Bot: Na guia Bots, clique em um nome bot para ver a ação exigida de uma mensagem específica bot, clique no nome bot.
  • Referência da tarefa principal: Na guia Processos, para visualizar a mensagem de ação necessária de um processo específico, clique no ícone de expansão (ícone de expansão para processos) e clique em um nome de referência de tarefa.

Clicar na mensagem informa as etapas manuais que você deve realizar para executar o processo migrado com êxito no Automation 360.

Você também pode ver os comandos que o bot contém e a freqüência ou o número de vezes que o comando é usado no bot.

Nota: Cada mensagem inclui a causa e a ação que você tem que realizar após a migração. Para obter uma lista dessas mensagens, consulte Mensagens migratórias. Use o código de mensagem (por exemplo, A101) para ver uma mensagem específica rapidamente.
12 Fornece a localização do bot.
13 Fornece o status do bot ou processo.
14
  • Para bots, este campo exibe o número de linhas utilizadas em um bot. Estas informações ajudarão você compreender a complexidade do bot.
  • Para processos, este campo exibe a soma do número total de linhas utilizadas no bots principal e secundário dentro de um processo. Estas informações ajudarão a compreender a complexidade do processo.
15 Para processos, este campo exibe o número de bots em um processo que requer ação após a migração para Automation 360. Clique no ícone de expansão (ícone de expansão para processos) e, em seguida, clique em um nome de referência de tarefa marcado como Ação necessária.

Clicar na mensagem traz informações sobre mudanças no comportamento do Automation 360 para o comando em comparação com o comportamento no Enterprise 11 ou Enterprise 10.

Nota: Este campo está disponível apenas para processos.
16 Para processos, este campo exibe o número de bots em um processo que requer revisão após a migração para Automation 360. Clique no ícone de expansão (ícone de expansão para processos) e, em seguida, clique em um nome de referência de tarefa marcado como Revisão necessária.

Clicar na mensagem traz informações sobre mudanças no comportamento do Automation 360 para o comando em comparação com o comportamento no Enterprise 11 ou Enterprise 10.

Nota: Este campo está disponível apenas para processos.
17 Baixe (como um arquivo CSV) a lista de bots ou processos, comandos que podem ou não ser migrados para compartilhar o arquivo com outros.
18
  • Para bots, este campo exibe o número de vezes que o bot é usado como um bot secundário.
  • Para processos, este campo exibe a soma do número total de dependências utilizadas no bots principal e secundário dentro de um processo.

O relatório é válido enquanto a próxima versão do Bot Scanner não estiver disponível. Quando a próxima versão do Bot Scanner estiver disponível, uma mensagem de expiração do relatório será exibida. Você deve baixar a versão mais recente do Bot Scanner e verificar os bots novamente.

Verificações e ações necessárias após a migração

Alguns comandos nos bots pode ser marcados como revisão necessária no relatório do Bot Scanner. Para estes itens, você precisa executar certas validações ou atualizar os bots após serem migrados.

As seguintes mensagens do Bot Scanner exigem verificação ou algumas ações:

  • O caminho do bot secundário é completamente variável e é resolvido em tempo de execução. O bot falharia na execução se o caminho especificado na variável não fosse válido. Revise o bot a ser migrado.

    Assegure-se de que o bot secundário está disponível no local especificado no caminho variável. Se o caminho no bot principal não é correto, atualize o caminho para apontar para o bot secundário correto.

  • O valor retornado pela variável do sistema "Descrição do erro" pode ser diferente das versões de legado w.r.t. Revise o bot migrado.

    A descrição de algumas das mensagens de erro no Automation 360 podem ser diferente do Enterprise 11 ou Enterprise 10 para o mesmo erro. Se um botEnterprise 11 ou Enterprise 10 está configurado para tomar decisões com base na descrição das mensagens de erro, você pode ter que atualizar os bot migrados com base na nova descrição das mensagens de erro.

  • A migração do comando "Banco de dados- Conectar" está concluída, mas é necessária uma configuração adicional para a "Autenticação do Windows". Consulte a documentação do pacote do banco de dados para mais detalhes.

    Complete as etapas especificadas para se conectar a um Microsoft SQL Server com autenticação do Windows. Consulte Conectar-se a um Microsoft SQL Server com autenticação do Windows.

  • A migração do "IF" com condição variável está concluída. Entretanto, não foi possível determinar o formato da data da variável do usuário, portanto migrou com o formato de data padrão mm/dd/yyyy HH:mm:ss. Revise e altere o formato, se necessário.

    Atualizar o formato da data no bot migrado para o mesmo formato utilizado no Enterprise 11 para este bot.

  • Não foi possível determinar se uma variável utilizada como posição é um índice ou nome de coluna. A posição do índice começa de 0 ao invés de 1, portanto, tome as ações necessárias se necessário.

    Se você usou as variáveis de sistema FileData Column[$variable$] ou Excel Column[$variable$] no bot Enterprise 11 ou Enterprise 10, presume-se que você tenha usado o nome de coluna em $variable$. Nesses casos, o bot migrado contém a expressão FileData Column{$variable$}. Se $variable$ no bot Enterprise 11 ou Enterprise 10 contiver o número da coluna, atualize a expressão no bot migrado para FileDataColumn[$var.String:toNumber()$].

  • O comando Executar lógica que usa variáveis credenciais como entrada para uma lógica de um MetaBot

    Os Bots que utilizam o comando Executar lógica que passa atributos de Credential Vault de um Task Bot para a lógica de um MetaBot podem ser migrados para o Automation 360. O nome da credencial e o nome do atributo são exibidos nos campos da linha correspondente do bot migrado.

    Se você tiver migrado usando o banco de dados Enterprise 11 restaurado, um cofre equivalente será criado no Automation 360 para as credenciais variáveis utilizadas na Enterprise 11 do bot.

    Escolha uma das seguintes opções para executar os bots migrados com êxito:
    • Opção 1: Passar as variáveis do tipo credencial.
      1. Crie uma variável do tipo credencial nos bots secundários como variáveis de entrada.
      2. Na ação Executar do pacote Task Bot do bot principal, atualize os campos de valor de entrada para usar os atributos de Credential Vault para a variável tipo credencial criada para o bot secundário (correspondente a lógica do MetaBot).
    • Opção 2: Passar os valores das credenciais como um valor global.
      1. Crie o valor global no Automation 360 para o uso das credenciais no comando Executar lógica na Enterprise 11.
      2. Na ação Executar do pacote Task Bot do bot principal, atualize os campos de valor de entrada para usar os valores globais para a variável do tipo credencial criada para o bot secundário (correspondente à lógica do MetaBot).
    Se você não tiver usado o banco de dados da Enterprise 11 restaurado ao instalar o Automation 360, será necessário primeiro criar o cofre necessário para as variáveis de credenciais utilizadas na Enterprise 11 do bot, antes de executar as etapas anteriores.
    Nota: O Automation 360 oferece maior segurança ao permitir que você designe atributos de Credential Vault somente às variáveis do tipo credencial. Isso restringe qualquer manuseio inseguro de atributos de Credential Vault onde eles poderiam ter sido atribuídos a variáveis do tipo não-credenciais.

Relatório para um bot individual

O relatório para cada bot traz informações sobre suas dependências, variáveis e comandos usados.

O relatório de bot individual é semelhante ao código a seguir:

<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>
A tabela a seguir descreve os vários atributos disponíveis no relatório XML mostrado na imagem anterior:
Atributo Descrição
Estatística -- Oferece informações sobre o número de dependências, erros e avisos.
-- dependências Especifica o número de dependências para o bot. O ucount indica o número de dependências exclusivas e o count indica o número total de dependências.
-- erro Especifica o número de erros para o bot. O ucount indica o número de erros exclusivos e o count indica o número total de erros.
Comando -- Oferece informações sobre os vários comandos e ações usados no bot.
-- comando ação-alvo Especifica a ação que está sendo executada para o comando.
-- nome Especifica o nome do comando.
-- linha Especifica o número de linha onde o comando está disponível no bot.
-- grp Especifica o grupo de comando ao qual o comando pertence.
-- api Especifica o nome da API que o comando usa.
-- tipo de msg Oferece informações sobre o tipo de mensagem. O tipo error indica que o comando não pode ser migrado para o Automation 360 e um tipo de info indica que o comando pode ser migrado, mas alguns de seus atributos serão alterados durante a migração.
-- revisar Oferece informações sobre se o comando deve ser revisado.

Esse atributo é sempre verdadeiro para mensagens tipo error, que indicam que a migração desse comando para o Automation 360 ainda não é compatível. Para as mensagens do tipo info, se o atributo for verdadeiro, você deve revisar o valor no atributo category. Você pode decidir se deseja realizar qualquer ação no bot migrado com base no valor disponível no atributo category.

-- categoria Oferece informações sobre o comando ou variável para a qual a mensagem é exibida.
Variáveis Oferece informações sobre as variáveis do sistema usadas pelo bot.
-- nome da variável Especifica o nome da variável.
-- tipo Especifica o tipo de variável.
-- tipo de valor Especifica o tipo de valor informado para essa variável.

Veja o seguinte vídeo sobre como analisar o relatório do scanner