Pacote Gravador
- Última atualização2024/07/23
Pacote Gravador
O pacote Gravador captura uma série de tarefas em um processo e depois as automatiza. Você pode automatizar seus aplicativos de negócios (por exemplo, aplicativos desktop, Web, SAP e Java) usando o Gravador para capturar ações executadas em objetos de aplicação, como caixa de texto, botão, tabela, botão de opção, caixa combo e exibição de lista.
Configuração de 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 o pacote Gravador em vez do pacote SAP
- Você pode automatizar objetos sem criar uma sessão. Ao utilizar o pacote SAP, é 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.
Captura usando o Gravador
- 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.
Quando você está automatizando páginas web utilizando navegadores Google Chrome e Microsoft Edge, a ação 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 para automatizar objetos quando as credenciais do dispositivo forem inseridas no formato UPN.
Configuração manual da tecnologia Silverlight
- 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.
- Clique no menu Arquivo.
- Navegue para .
- Digite .\Check.exe no script e clique em Enter.
- 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
- 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)
- 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
- 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.
Tipos de controle compatíveis
- Janelas pop-up
- Caixas de diálogo de alerta
- Caixas de diálogo de confirmação
- Caixas de diálogo de prompt
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.
- 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.
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.
- Agente de bot está instalado no perfil do sistema.
- Criadores de bot e Bot Runners têm direitos de administrador sobre o dispositivo para automatizar tais aplicativos.
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
- 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
- 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.
- 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.
- 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
- 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.
A propriedade do objeto Superior é usada quando você deseja usar as ações Clique, Clique com o botão direito do mouse, Clique duplo, Definir texto ou Obter propriedade.
Durante o tempo de design, a localização do elemento é determinada pelo cálculo dos pontos do documento a partir do topo (3) e da esquerda da área DOM (1). Por exemplo, ao capturar o elemento Sobrenome, o valor da propriedade Superior foi registrado como 131, calculado a partir do topo (3) do DOM. Entretanto, durante o tempo de execução, o valor da propriedade Superior para este elemento Sobrenome aparece como 216. Essa discrepância ocorre porque, em tempo de execução, a extensão calcula a localização do elemento a partir da barra de navegação (2) em vez da parte superior (3) do DOM.
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.
Ações realizadas em objetos coletados
Processamento em segundo plano
- Clique
- Definir Texto
- Obter texto
Gravação segura
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.
- 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 Definir 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.
Casos de uso em como usar o gravador
Utilize estas tarefas de exemplo para se familiarizar com o uso do gravador na construção de bots.