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

Se a execução do bot demorar mais quando você usar o Recorder 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 o Recorder package em vez do SAP package

Recomendamos que você utilize o Recorder para automatizar as aplicações SAP. Quando você usa o Recorder para automatizar aplicações SAP, você tem as seguintes vantagens:
  • 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.
Nota: Quando comparado ao Recorder package, o SAP package permite automatizar um aplicativo sem ativar a janela do aplicativo.

Captura usando o Recorder

Use a action Capturar para capturar uma interação com um objeto de interface do usuário (IU). Esta action habilita a adição de uma única interação quando você estiver construindo um bot. Consulte Como usar a action Coletar
Nota:
  • 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 Gravador > Capturar 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 Gravador > Capturar 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.

Quando você automatiza pelo navegador Safari:
  • 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

Com o Recorder package (versão 2.17.2 e posterior) e o novo Bot Agent (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.
  1. Navegue para C:\ProgramData\AutomationAnywhere\GlobalCache\embedded-resources
  2. Procure ec0db824-25eb-4c57-ab44-f77ef67d2579.

    Os resultados da pesquisa exibem uma lista dos Recorder packages.

  3. Selecione o Recorder package que costuma usar.
  4. 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.
  1. Clique no menu Arquivo.
  2. Navegue para Abrir Windows PowerShell > Abrir Windows PowerShell como administrador.

    Abra o Windows PowerShell

  3. 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.
  1. Abra o Prompt de comando e execute como administrador.
  2. Digite C:\ProgramData\AutomationAnywhere\GlobalCache\embedded-resources\ seguido pela versão do Recorder package que costuma usar.
  3. 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 Recorder package (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 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.
Você pode automatizar de maneira confiável os controles em um Adobe Acrobat PDF Reader, desde a adição de planos de fundo e assinaturas até a navegação fácil pelas opções da barra de ferramentas. Ao automatizar, o Recorder ativa automaticamente a acessibilidade do Adobe Acrobat antes de executar quaisquer ações no documento. As seguintes tecnologias são compatíveis com a automação de um Adobe Acrobat PDF Reader:
  • Microsoft Active Accessibility (MSAA)
  • Automação da Interface do Usuário Microsoft
Para automatizar documentos PDF usando a tecnologia de interface do usuário COM, primeiro automatize um elemento PDF usando a tecnologia de automação MSAA ou de interface do usuário para permitir a acessibilidade do Adobe Acrobat. Em seguida, você pode automatizar os elementos subsequentes do PDF usando a tecnologia de automação da interface do usuário COM.

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 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.
Você pode executar com sucesso os bots principal e o secundário que usam diferentes versões do Recorder package em um ambiente Citrix XenApp.
Nota: Para usar e executar múltiplas versões do pacote Recorder em um bot de forma eficaz, certifique-se de que os bots, principal e secundário, usem o Recorder package (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 de Capturar > Gravador action, 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.

Capturar 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 Recorder 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 Bot editor.

Antes de automatizar as aplicações em execução como usuário administrador, verifique o seguinte:
  • 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.
Ao escolher gravar vários aplicativos usando a opção Iniciar gravação no Bot editor 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 Recorder no modo elevado, o bot encontra um erro.

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

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 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.

Importante: Para automatizar aplicativos de desktop que utilizam a estrutura CEF, é necessário desenvolver e executar as automações em modo elevado. Consulte Automatizar aplicações em execução como um usuário administrador.

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.

Importante: Esse recurso está disponível no do Recorder versão 3.5.0-20241129-105732 e mais recente.
Capacidade de suporte
  • 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.
Comportamento conhecido
  • 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

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 Universal Recorder 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.

    Propriedades da tabela do tipo de controle

  • 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.

Propriedade do objeto Superior

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.

Exemplo de como a propriedade do objeto superior exibe dados

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.

Algoritmo de busca

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.

Nota: Esse recurso está disponível para os bots criados usando a versão 2.4.0-20211016-070100 do Recorder package a partir do Automation 360 v.23. Se você tiver criado bots utilizando uma versão anterior do Recorder package, 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 Universal Recorder.
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 actions 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 Bot editor 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 Generative Recorder 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 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.