Pacote Recorder
- Última atualização2025/07/02
Pacote Recorder
O package 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 Recorder para capturar actions 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 Recorder package em vez do SAP package
- Você pode automatizar objetos sem criar uma sessão. Ao utilizar o SAP package, é 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 SAP package, o package executará actions 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 Recorder se sobrepõe ao objeto que você deseja automatizar, o Recorder oculta a janela de tempo de execução antes de automatizar o objeto.
- Recorder suporta ações nos If Loop, Wait e packages que permitem verificar se um objeto existe no navegador ou janela específica.
Captura usando o Recorder
- A action Capturar substitui o comando Object Cloning da Version 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 Recorder pode não capturar e reproduzir as actions 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 Recorder package (versão 2.3.0-20210806-215200 ou anterior) com o Bot Agent (versão 21.250 ou posterior) lançado com o Automation 360 v.29, podem ocorrer problemas ao capturar um objeto. Recomendamos usar o Recorder package (versão 2.4.0-20211118-080716 ou posterior) com o Bot Agent (versão 21.250 ou posterior) para capturar objetos.
- Quando o Bot Agent 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 Bot Agent 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 da web em execução nos navegadores Google Chrome e Microsoft Edge, o action deixa de percorrer a página da 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 o action para automatizar objetos com sucesso quando as credenciais do seu dispositivo forem inseridas no formato UPN.
Quando aplicativos da web passam por mudanças frequentes e são dinâmicas por natureza, use o Generative Recorder para automatizá-las. Consulte Generative Recorder
Automação na Web do navegador Safari na plataforma macOS
O Recorder oferece automação no navegador Safari, proporcionando automação baseada em objetos de aplicativos da Web nas plataformas macOS. Uma vez que o Safari é o navegador padrão dos usuários do macOS, esse recurso aumentará a adoção e a cobertura da automação, permitindo que os usuários do macOS automatizem aplicativos da Web. O Recorder permite a interação direta com os elementos da Web do Safari, como botões, formulários e links, sem a necessidade de plug-ins de terceiros.
- A propriedade Tipo de navegador em Propriedades do objeto mostra Apple Safari.
- O campo Aplicativo do navegador mostra Apple Safari.
- Durante a gravação, a janela do navegador Safari aparece na lista de janelas, agrupada com outros navegadores como Google Chrome e Microsoft Edge.
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 Recorder packages.
- Selecione o Recorder package 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 Recorder package 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 Recorder package (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 Recorder utiliza a tecnologia MSAA para capturar objetos.
- Ao automatizar um aplicativo Electron, o Recorder 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.
- Microsoft Active Accessibility (MSAA)
- Automação da Interface do Usuário Microsoft
Suporte Citrix XenApp
- Instale o Bot Agent no mesmo servidor Citrix XenApp de onde você inicia seus aplicativos corporativos.
- Quando você inicia a Control Room como um XenApp, o Automation Anywhere remote agent for 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 Recorder 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 Bot editor.
- Bot Agent está instalado no perfil do sistema.
- Bot Creators 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 Bot editor e executar o Recorder 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 Recorder package (versão 3.2.1-20240606-105427 e posteriores) e Bot Agent (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 Bot Agent 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 de desktop do Chromium Embedded Framework (CEF)
Os desenvolvedores usam um navegador chromium integrado ao aplicativo de desktop para adicionar recursos de navegadores da web browser ao aplicativo de desktop. O Recorder suporta automação baseada em objetos desses aplicativos de desktop, garantindo uma cobertura de automação maior.
O Recorder detecta esses aplicativos CEF de desktop como tecnologia HTML.
Para executar um snippet JavaScript ou chamar uma função JavaScript em aplicativos CEF de desktop, consulte action Executar JavaScript | action Chamar uma função JavaScript.
- Todos os controles HTML existentes e as actions correspondentes são compatíveis.
- Aplicativos CEF desenvolvidos usando a biblioteca cef sharp e winforms são compatíveis.
- IFrames entre domínios são compatíveis.
- Há suporte para identificar elementos usando o seletor CSS. Consulte Automatize aplicativos da web que usam o padrão Shadow DOM.
- No momento, o aplicativo CEF de 32 bits não é compatível.
- Aplicativos CEF desenvolvidos usando WPF e aplicativos baseados em .net core não são compatíveis no momento.
- Não há suporte para automatizar vários controles de navegador em um único aplicativo CEF.
- A automação de aplicativos baseados em CEF com Generative Recorder não é compatível.
- No momento, a opção de tempo limite avançado não é compatível para aplicativos CEF.
- Não há suporte para automatizar aplicativos da web que usam o padrão Shadow DOM.
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 Obter propriedade
action 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 action 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 actions 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, quando você capturou o elemento Sobrenome, o valor da propriedade Superior foi gravado 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 Recorder package 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 Bot editor ou atualizá-la.
- Esse recurso é compatível com o Recorder package (versão 3.2.1-20240606-105427 e posteriores) e Bot Agent (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 package serão roteadas por meio do servidor de proxy. Consulte Conectar o Bot Agent 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.