Pacote Gravador

Configuração de extensão Automation 360

Se a execução do bot demorar mais quando você usar o Gravador para automatizar uma página estática em execução no navegador Google Chrome ou Microsoft Edge, siga essas etapas para habilitar a configuração na extensão Automation 360:

Clique no ícone de extensões no canto superior direito da janela do navegador.
Clique nas reticências verticais ao lado do plug-in Automation 360 e selecione Gerenciar extensão.
Ative a opção Permitir acesso a URLs de arquivo.
Reinicie o navegador e execute o bot.

Benefícios de utilizar opacote Gravador em vez do pacote SAP

Recomendamos que você utilize o Gravador para automatizar as aplicações SAP. Quando você usa o Gravador para automatizar aplicações SAP, você tem as seguintes vantagens:

Você pode automatizar objetos sem criar uma sessão. Ao utilizar o SAP pacote, é necessário criar uma sessão.
Você pode automatizar diretamente o objeto sem gerar os caminhos de campo ou ter qualquer conhecimento prévio dos caminhos de campo. Ao utilizar o pacote SAP, o pacote executará ações diretamente nos caminhos do campo de controle quando as propriedades nos critérios de pesquisa corresponderem ao objeto que o bot procura durante a execução.
Se a janela de tempo de execução Gravador se sobrepõe ao objeto que você deseja automatizar, o Gravador oculta a janela de tempo de execução antes de automatizar o objeto.
Gravador suporta ações nos pacotes Se, Loop e Aguardar que permitem verificar se um objeto existe no navegador ou janela específica.

Nota: Quando comparado ao pacote Gravador, o pacote SAP permite automatizar um aplicativo sem ativar a janela do aplicativo.

Captura usando o Gravador

Use a ação Capturar para capturar uma interação com um objeto de interface do usuário (IU). Esta ação habilita a adição de uma única interação quando você estiver construindo um bot.

Nota:

A ação Capturar substitui o comando Clonagem de objetos da Versão 11.3.
Se você lançar qualquer navegador ou aplicativo compatível com uma conta de usuário diferente daquela usada para fazer login no computador, o Gravador pode não capturar e reproduzir as ações de controle com precisão.
Para capturar objetos de forma confiável ao usar monitores duplos, certifique-se de que a resolução da tela em ambos os monitores seja a mesma.
Ao usar o pacote Gravador (versão 2.3.0-20210806-215200 ou anterior) com o Agente de bot (versão 21.250 ou posterior) lançado com o Automation 360 v.29, podem ocorrer problemas ao capturar um objeto. Recomendamos usar o pacote Gravador (versão 2.4.0-20211118-080716 ou posterior) com o Agente de bot (versão 21.250 ou posterior) para capturar objetos.
Quando o Agente de bot for instalado no nível do usuário, isto é, para o tipo de instalação específico do usuário, o Citrix, o Java e o SAP não serão configurados porque a sessão em que o Agente de bot está em execução pode não ter os privilégios exigidos. Apenas o plugin VMWare será configurado para o usuário atual.

Como usar a ação Coletar

Quando você está automatizando páginas web utilizando navegadores Google Chrome e Microsoft Edge, a ação Gravador > Capturar deixa de percorrer a página web se o objeto alvo estiver visível na tela. Isso melhora a experiência do usuário e a confiabilidade da automatização quando existe um painel superior fixo na página web e se algumas ações físicas, como cliques do mouse, não funcionarem como esperado.

Use a ação Gravador > Capturar para automatizar objetos quando as credenciais do dispositivo forem inseridas no formato UPN.

Configuração manual da tecnologia Silverlight

Com o pacote Gravador (versão 2.17.2 e posterior) e o novo Agente de bot (versão 22.1.22) lançado com Automation 360 v.31, não configuraremos mais a tecnologia Silverlight. Se quiser configurar a tecnologia Silverlight, execute as etapas a seguir para executar o arquivo check.exe de modo manual.

Nota: Adicione o arquivo check.exe à lista de permissões antes de executá-lo.

Navegue para C:\ProgramData\AutomationAnywhere\GlobalCache\embedded-resources
Procure ec0db824-25eb-4c57-ab44-f77ef67d2579.
Os resultados da pesquisa exibem uma lista dos pacotes Gravador.
Selecione o pacote Gravador que costuma usar.
Execute o arquivo check.exe como admin dessa pasta.

Como alternativa, execute as etapas a seguir para executar o arquivo check.exe de modo manual no Windows PowerShell.

Clique no menu Arquivo.
Navegue para Abrir Windows PowerShell > Abrir Windows PowerShell como administrador.
Digite .\Check.exe no script e clique em Enter.

Execute as etapas a seguir para executar o arquivo check.exe de modo manual no Prompt de comando.

Abra o Prompt de comando e execute como administrador.
Digite C:\ProgramData\AutomationAnywhere\GlobalCache\embedded-resources\ seguido pela versão do pacote Gravador que costuma usar.
Digite Check.exe no script e clique em Enter.

Aplicativos compatíveis

Você pode automatizar as seguintes aplicações em execução Microsoft Edge Chromium com modo IE:

Aplicativos web em Java
Aplicativos que são acessados através do aplicativo Espaço de trabalho Citrix.
Citrix Virtual Apps
Nota: O Citrix Virtual Apps and Desktop versão 2303 é certificado com o pacote Gravador (versão 2.16.0-20231101-165457 e posterior)

Nota:

Para capturar ou automatizar com precisão objetos em aplicativos SAP, recomendamos que você habilite o script. Se o script não estiver habilitado, a seguinte mensagem de solicitação é exibida abaixo da janela do tempo de execução do bot:
Script SAP desativado: Habilitar a escrita para capturas mais confiáveis

Se você não ativar o script, em vez de usar a tecnologia SAP, o Gravador utiliza a tecnologia MSAA para capturar objetos.
Ao automatizar um aplicativo Electron, o Gravador captura controles específicos no aplicativo usando a tecnologia Microsoft UI Automation (COM) por padrão. Isso permite que você automatize os aplicativos Electron facilmente, sem a necessidade de recapturar o objeto com uma tecnologia específica.

Suporte Citrix XenApp

Agora você pode iniciar a janela do navegador do Google Chrome ou Microsoft Edge por meio de um aplicativo Citrix XenApp, acessar a Control Room pelo navegador específico e automatizar outros aplicativos virtuais que são executados como XenApps. Isso permite uma automação confiável baseada em objetos ao implantar e iniciar a Control Room e os aplicativos de negócios como aplicativos virtuais do mesmo sistema.

Nota:

Instale o Agente de bot no mesmo servidor Citrix XenApp de onde você inicia seus aplicativos corporativos.
Quando você inicia a Control Room como um XenApp, o Agente remoto da Automation Anywhere para Citrix não é necessário.

Você pode executar com sucesso os bots principal e o secundário que usam diferentes versões do pacote Gravador em um ambiente Citrix XenApp.

Nota: Para usar e executar múltiplas versões do pacote Gravador em um bot de forma eficaz, certifique-se de que os bots, principal e secundário, usem o pacote Gravador (versão 2.16.0-20231101-165457 e posterior). O uso de versões anteriores pode não ser compatível com esse recurso e causar inconsistências ou erros durante a execução do bot em ambientes Citrix.

Tipos de controle compatíveis

Você pode automatizar os seguintes tipos de controle ao automatizar uma página da web nos navegadores Google Chrome, Microsoft Edge Chromium, ou Mozilla Firefox:

Janelas pop-up
Caixas de diálogo de alerta
Caixas de diálogo de confirmação
Caixas de diálogo de prompt

Nota: Quando você deseja automatizar uma caixa de diálogo de alerta em uma página web, recomendamos que você acrescente um atraso antes da ação Capturar > Gravador porque às vezes a caixa de diálogo de alerta aparece após um atraso na janela do aplicativo.

Compatibilidade entre domínios

Agora você pode capturar e automatizar objetos dentro de um IFrame de domínio cruzado com vários IFrames contendo a mesma fonte de quadros e IFrames carregados de forma dinâmica durante o tempo de execução nos navegadores Google Chrome e Microsoft Edge Chromium. Após capturar um objeto dentro de um IFrame de domínio cruzado, o caminho para o quadro fica armazenado na propriedade FrameDOMXPath por padrão.

Captura usando a propriedade FrameDOMXPath

A nova propriedade FrameDOMXPath identifica o quadro no qual o objeto está localizado. É preciso selecionar essa propriedade para executar com sucesso o bot e automatizar objetos em um IFrame de domínio cruzado.

Nota:

Ao selecionar a propriedade FrameDOMXPath nos critérios de pesquisa, não altere o valor dessa propriedade.
Se você limpar a propriedade FrameDOMXPath dos critérios de busca, o Gravador não conseguirá identificar o quadro.

Importante: No navegador Google Chrome, você pode capturar e automatizar objetos dentro de um domínio cruzado e usar vários quadros com a mesma fonte de quadros.

Automatizar aplicações em execução como um usuário administrador

Você pode capturar objetos em aplicativos executados como administrador selecionando a opção Capturar e executar com privilégios de administrador no Editor de bot.

<span>Capture objetos usando a opção Capturar e execute com privilégios de administrador</span>

Antes de automatizar as aplicações em execução como usuário administrador, verifique o seguinte:

Agente de bot está instalado no perfil do sistema.
Bot Creators e Bot Runners têm direitos de administrador sobre o dispositivo para automatizar tais aplicativos.

Ao escolher gravar vários aplicativos usando a opção Iniciar gravação no Editor de bot e alternar aplicativos em execução no modo elevado e não elevado, o bot pode não ser capaz de identificar a alteração entre os modos. Nesses casos, para todas as capturas em aplicativos em modo elevado, selecione a opção Capturar e executar com privilégios de administrador e capture novamente o objeto.

Nota: O modo Elevado oferece permissão para executar aplicativos como administrador.

Importante: Ao tentar automatizar qualquer aplicativo JAVA ou SAP que não é elevado usando o Gravador no modo elevado, o bot encontra um erro.

Para evitar erros, marque a opção Capturar e executar com privilégios de administrador no Editor de bot e executar o Gravador no modo não elevado quando desejar capturar aplicativos JAVA ou SAP.

Automatize aplicativos que exigem acesso a vários usuários

Você pode automatizar com êxito aplicativos de navegador que estão em execução na mesma sessão de usuário, mas que exigem acesso variável em nível de aplicativo no mesmo fluxo de trabalho de automação. Por exemplo, usuários não administradores podem criar e validar registros, e os usuários administradores agora podem fazer aprovações na mesma automação do processo.

Nota:

Esse recurso é compatível com a automação de aplicativos da web executados em Google Chrome, Microsoft Edge e Microsoft Edge com navegadores no modo IE.
Esse recurso é compatível com o pacote Gravador (versão 3.2.1-20240606-105427 e posteriores) e Agente de bot (versão 22.60.23 e posteriores).
Capture e execute a automação em modo elevado ao automatizar aplicativos de navegador abertos com outros privilégios de usuário.
Quando o Agente de bot for atualizado, você deverá reiniciar o aplicativo do navegador.
A opção de tempo limite avançado não é compatível no momento.

Automatizar aplicativos Java

Ao automatizar controles com propriedades semelhantes em aplicativos Java, por exemplo, o Oracle EBS, a propriedade path muda de modo significativo e, portanto, não é confiável. Para automatizar controles de modo confiável no cenário, use a propriedade do objeto Ocorrência

Ao utilizar a propriedade Ocorrência, os controles com propriedades semelhantes são detectados e organizados de cima para baixo e da esquerda para a direita e o controle específico baseado no valor da ocorrência é detectado.

Nota:

A propriedade Ocorrência não faz parte dos critérios de pesquisa padrão.
A propriedade Ocorrência é coletada apenas durante o tempo de execução e não no momento da captura.
O valor máximo da propriedade Ocorrência dependerá da quantidade de controles semelhantes visíveis na tela. Por exemplo, se 15 controles do tipo Descrição estiverem visíveis na tela, então o valor máximo de ocorrência será 15. O valor máximo da ocorrência se manterá em 15 mesmo na navegação nos controles na tela.
O valor da ocorrência varia de 1 a 999.

É possível usar a propriedade Nome do quadro para automatizar os controles localizando o quadro específico no qual o objeto reside. Isso melhora o desempenho e aumenta a confiabilidade das automações.

Nota:

Se o nome do quadro para um controle específico dentro de um quadro interno estiver em branco, a propriedade Nome do quadro do objeto capturado aparecerá em branco e não será adicionada como um critério de pesquisa padrão.
Se o objeto não estiver dentro de um quadro interno, a propriedade não aparecerá na lista.
A propriedade Nome do quadro é compatível com caracteres curinga e variáveis.
Recomendamos usar o caractere curinga (*) para identificar os objetos do quadro interno, pois o Nome do quadro pode mudar em algumas janelas.

Nota:

Para as automações existentes, certifique-se de recapturar os controles se quiser usar as novas propriedades.
Observe que a capacidade não tem impacto nos bots, que continuam a executar inalterados.

Propriedades do objeto

Ao selecionar um objeto para capturar, o Gravador universal coleta dados nas propriedades do objeto para identificá-lo durante o tempo de execução. Você pode fazer o seguinte com as propriedades do objeto:

verifique se as propriedades do objeto capturado correspondem ao objeto pretendido.
Por exemplo, ao capturar uma tabela de um site, verifique se os valores Tipo de controle e Tag HTML são TABELA.
Recupere um valor de propriedade. Use a ação Obter propriedade e insira o nome da propriedade no campo Nome da propriedade ou selecione uma propriedade de objeto na lista de propriedades disponíveis. A lista inclui valores de propriedade sugeridos com base nos critérios na tabela Propriedades do objeto. Para selecionar uma propriedade de objeto da lista de propriedades, mova o mouse para a direita do campo Nome da propriedade e clique na seta.
Por exemplo, para recuperar o texto de um link, use a ação Obter propriedade e insira HTML InnerText no campo Nome da propriedade ou selecione HTML InnerText na lista de propriedades.
Você pode selecionar uma combinação de propriedades para o bot pesquisar o objeto na sua janela do aplicativo de negócios de forma única.

O algoritmo de busca do pacote Gravador garante que quando você executar um bot, um objeto será coletado apenas se suas propriedades corresponderem exatamente ao critério de busca selecionado na tabela Propriedades do objeto. Se as propriedades do objeto não corresponderem exatamente ao critério de busca, ocorrerá uma falha no bot e uma mensagem de erro será exibida. Entretanto, se o critério de busca incluir um curinga, o bot captará o primeiro objeto que corresponder ao critério.

Por exemplo, para capturar uma caixa de texto de um aplicativo que tenha três caixas de texto nomeadas primeiro nome1, primeiro nome2 e primeiro nome3, caso selecione Nome HTML como critério de busca, digite o valor firstname no campo Nome HTML e execute o bot; o bot falhará e exibirá uma mensagem de erro porque uma caixa de texto com o Nome HTML firstname não existe. No entanto, no campo Nome HTML, caso digite firstname* e execute o bot, o bot captará a primeira caixa de texto que corresponda ao critério.

Nota: Esse recurso está disponível para os bots criados usando a versão 2.4.0-20211016-070100 do pacote Gravador a partir do Automation 360 v.23. Se você tiver criado bots utilizando uma versão anterior do pacote Gravador, será necessário coletar novamente os objetos para usar esta funcionalidade.

Ações realizadas em objetos coletados

Após coletar o objeto, especifique a ação que o bot irá executar no objeto durante o tempo de execução. Por exemplo, ao capturar um hiperlink, você pode selecionar clicar no link ou recuperar o texto do link. Para ver a tabela de todos os objetos e ações possíveis, consulte Ações realizadas em objetos capturados com Gravador universal.

Nota: Se você encontrar um erro ao executar um bot que coleta um objeto do Internet Explorer e a mensagem de erro fizer referência ao Google Chrome, consulte Your Chrome Plug-in is either not installed or disabled (A-People login required).

Processamento em segundo plano

O processamento em segundo plano permite uma automação que envolve a interação com uma aplicação em primeiro plano (como cliques de mouse) a ser executada em segundo plano. Recomendamos o uso da opção de execução em segundo plano, para aumentar a visibilidade do objeto-alvo e melhorar a precisão do bot. As ações seguintes são compatíveis com processamento em segundo plano:

Clique
Definir Texto
Obter texto

Gravação segura

Quando o modo de gravação segura está ativado, os bots não exibem as imagens do objeto alvo após a coleta. Isso garante que os dados sensíveis não sejam exibidos.

Nota: Embora os bots não exibam as imagens alvo após a captura, as imagens continuam armazenadas na Control Room, porque elas são necessárias para a execução dos bots.

Quando você grava uma tarefa no modo de gravação segura, a janela Visualizar mostra temporariamente uma imagem da área capturada. Esta imagem ficará oculta depois que você navegar para fora da janela do Editor de bot ou atualizá-la.

Para novas automações, ao capturar objetos no modo de gravação segura, você pode optar por excluir de maneira automática os valores das propriedades do objeto não usado ativando a opção Excluir automaticamente as propriedades do objeto não usado ao salvar. Ao habilitar essa opção, os valores das propriedades do objeto que não fazem parte dos critérios de pesquisa serão descartados quando você salvar a automação e atualizá-la. Isso garante que as informações de identificação pessoal (PII) não sejam armazenadas por acidente na automação. Para ver mais informações sobre como ativar as configurações de gravação segura, consulte Gravação segura.

Nota: Se você estiver usando o Gravador generativo para automatizar as tarefas e tiver ativado a opção Excluir automaticamente propriedades do objeto não usados ao salvar, o fallback da IA generativa não será compatível.

Nota:

Esse recurso é compatível com o pacote Gravador (versão 3.2.1-20240606-105427 e posteriores) e Agente de bot (versão 22.60.23 e posteriores).
Se quiser usar essa opção na automação em andamento, você deverá recapturar os controles.
O valor das propriedades Esquerda, Direita, Altura e Largura não será descartado.

Um usuário com privilégios de administrador deve habilitar esta configuração. Consulte Configurações.

Suporte a proxy

Se o dispositivo estiver configurado com um proxy, todas as solicitações de saída desse pacote serão roteadas por meio do servidor de proxy. Consulte Conectar o Agente de bot a um dispositivo com um proxy.