Como usar a ação Coletar

Use a ação Capturar para capturar uma única interação (clique, tecla ou movimento do mouse) com um controle de objeto, inclusive uma caixa de texto, botão, tabela, menu, botão de opção, caixa combo, caixa de seleção, visualização de lista, link, árvore ou guia de página.

Pré-requisitos

  • Para usar o Gravador, é preciso já ter feito o seguinte:
  • Configure a escala de exibição do dispositivo e da fonte para 100%.

    Se estiver usando o pacote Gravador na versão 2.0.6-20200626-193519 ou posterior, poderá registrar tarefas no Google Chrome, Internet Explorer, Java, Microsoft Active Accessibility e aplicativos de automação da interface do usuário da Microsoft em um computador que tenha escala de exibição configurada para 100%, 125% ou 150%.

  • Se você estiver automatizando uma tarefa usando um navegador, configure o nível de zoom para 100%.

    Se estiver usando o pacote Gravador versão 2.0.6-20200626-193519 ou posterior, poderá gravar tarefas em um navegador Google Chrome que não tenha uma configuração de nível de zoom de 100%.

  • Se você estiver automatizando uma tarefa, usando um navegador Google Chrome, certifique-se de que o plug-in do Automation Anywhere correspondente à versão build Automation 360 esteja habilitado.

    Requisitos de navegadores para o Automatize o espaço de trabalho

  • Para automatizar aplicações Web sendo executadas no navegador Chromium Microsoft Edge no modo Internet Explorer usando o Universal Recorder, assegure-se de que o modo de compatibilidade de Internet Explorer está habilitado. Os objetos nas aplicações Web são capturados usando a tecnologia HTML. Para utilizar esta utilidade, execute os seguintes passos:
    1. Sobre a página de navegador ChromiumMicrosoft Edge, clique Configurações.
    2. No painel do lado esquerdo, clique em Navegador padrão.
    3. Navegue até a opção Permitir que os sites sejam recarregados no modo Internet Explorer e selecione Permitir.
    4. Clique em Adicionar para adicionar o URL da página que você deseja carregar Internet Explorer modo.
      Nota: As páginas que você adiciona abrem no modo Internet Explorer por 30 dias a partir da data em que você adiciona a página.
Considerações ao gravar uma tarefa:
  • Use cliques quando possível, em vez de teclas de atalho.

    Ao clicar em um objeto usando o Gravador, são recuperadas as propriedades do objeto que permitem ao bot identificar o objeto no momento da execução. Os atalhos do teclado são menos confiáveis, por isso use-os quando não for possível automatizar a tarefa através de um clique em um objeto.

  • Se você estiver automatizando uma tarefa usando um navegador, não use o preenchimento automático para inserir valores nos campos.
  • Grave a tarefa em baixa velocidade.
  • Evite arrastar janelas durante o processo de gravação.
  • Evite clicar em aplicativos que não fazem parte do processo que você está gravando e automatizando.
  • Quando Internet Explorer é usado, a ação aguarda até que o navegador seja completamente renderizado e esteja em um estado pronto antes de executar a ação.

Procedimento

Para gravar uma única interação com um controle de objeto, siga estas etapas:

  1. Clique duas vezes ou arraste Gravador > Capturar.
  2. Especifique a janela na qual é preciso capturar um objeto.
    Escolha a guia Aplicação, Navegador ou Variável.
    OpçãoDescrição
    Aplicativo Selecione a partir de uma lista de janelas atualmente ativas. Essa opção mostra uma lista de todas as janelas de aplicativo e do navegador que estão abertas no dispositivo Bot Creator.
    Navegador Selecione a partir de uma lista de guias do navegador compatíveis.
    Nota: Esta opção é compatível com os navegadores Google Chrome, Microsoft Edge e Internet Explorer baseado em Chromium. Para todos os outros navegadores, use a opção Aplicação.
    Variável Selecione uma variável de janela existente para especificar o título do título da janela do aplicativo.
  3. Opcional: Insira um caractere curinga (*) no campo Título da janela para procurar títulos de janelas que podem mudar. Você pode especificar um ou mais curingas (*) no início, meio ou fim do valor.
    Por exemplo, para realizar uma operação em qualquer janela que tenha Microsoft no título, use um curinga para indicar qualquer string adicionando-o antes ou depois do valor: *Microsoft*. O primeiro bot procura o título exato da janela (Microsoft) e, se não encontrar uma correspondência, procura janelas com o termo Microsoft em qualquer parte do título.

    Você pode usar uma expressão regular (regex) para identificar um título da janela. Selecione a condição de expressão regular como String ou Padrão e, em seguida, insira o valor. Por padrão, o campo Título da janela diferencia maiúsculas e minúsculas.

    Para identificar um título do navegador, ative a opção Maiúsculas e minúsculas para corresponder às letras maiúscula e minúscula ou desativar a opção para identificar uma janela em que Maiúsculas e minúsculas não correspondam.
    Nota: Garanta que a versão do Agente de bot instalado em seu sistema é a versão lançada com o Automation 360 v.26. Se você tiver uma versão de Agente de bot lançada com Automation 360 v.25 ou anterior por padrão, então o título da janela ainda será identificado apenas com letras maiúsculas correspondentes (sensível a maiúsculas e minúsculas) por padrão.
    Por exemplo, você pode inserir o valor da String como ((\w*)-Notepad para todos os nomes de títulos de janela começando com ((\w*)-Notepad, ou usar o valor Padrão como ((\w)\s)*document-Notepad apenas para os títulos de janela que correspondem a esse padrão.
    Nota:
    • Quando você usa uma expressão regular do tipo String com -title como o valor de entrada para um título de janela em qualquer ação, o bot pode encontrar um erro de tempo de execução. Para evitar o erro de tempo de execução, assegure-se de que quando você adicionar a entrada de string como *-title, o aplicativo com o título específico está aberto. O asterisco (*) é apenas um caractere e não um caractere curinga.
    • Quando você usa uma expressão regular do tipo Padrão com -title como o valor de entrada para um título de janela em qualquer ação, o bot pode encontrar um erro de tempo de execução, uma vez que o valor de entrada *-title está incorreto.

      Assegure-se de utilizar padrões regex válidos.

    Nota: Durante o tempo de execução, verifique se o Task Bot identifica a janela correta. Caso contrário, faça o seguinte:
    1. Abra a janela do aplicativo ou navegador.
    2. Arraste uma ação Janela > Obter o título da janela ativa acima da ação Gravador > Capturar.
    3. Insira uma variável de string no campo Atribuir o título da janela à variável.
    4. Arraste uma ação Janela > Definir título abaixo da ação Janela > Obter o título da janela ativa.
    5. No campo Janela, insira a variável da janela gerada pela ação Gravador > Capturar.
    6. No campo Novo título da janela, insira a variável de string da ação Obter o título da janela ativa.
    7. Clique em Salvar.
  4. Opcional: Selecione a opção Redimensionar janela para especificar as dimensões da janela.
    Essa opção proporciona um bot confiável. Redimensiona a janela para as dimensões nas quais a tarefa foi registrada, o que aumenta a capacidade do bot de identificar o objeto alvo.
    • Se a janela for maximizada quando você registrar a tarefa, esta opção não será selecionada.
    • Se a janela não estiver no tamanho máximo quando a tarefa for registrada, esta opção é selecionada por padrão e os campos de largura e altura são preenchidos automaticamente com as dimensões da janela.
    Nota: Essa opção só está disponível para janelas que podem ser redimensionadas. Não está disponível para as opções Desktop ou Barra de tarefas.
  5. Clique em Capturar objeto.
    A janela selecionada será exibida.
  6. Mova o mouse sobre o objeto que você deseja automatizar, por exemplo, um botão, um campo de formulário ou uma tabela.
    Um realce vermelho aparece ao redor do objeto.
    Nota: Se a caixa não aparecer e você estiver coletando no navegador Google Chrome, Microsoft Edge ou Mozilla Firefox, verifique se você ativou a extensão Automation Anywhere para esses navegadores. Ver Requisitos de extensão do navegador Google Chrome para o navegador Google Chrome.
  7. Clique no objeto.
  8. Reveja a tabela Propriedades do objeto.
    Segue a lista de propriedades do objeto que são selecionadas por padrão, com base no tipo de tecnologia:
    Nota: Não há a opção de selecionar de modo explícito a tecnologia Java ou HTML. Ao capturar um aplicativo no modo de detecção automática, o Gravador detecta a tecnologia de modo automático com base no aplicativo que está sendo capturado. Quando o Gravador detecta a tecnologia específica, o tipo de tecnologia é exibido dentro das Propriedades do objeto.
    Important: A lista a seguir não inclui todas as propriedades e é restrita às propriedades usadas com mais frequência e mais importantes, com base no tipo de tecnologia.
    Tipo de tecnologia Propriedades do objeto Descrição
    Tecnologia HTML Tipo de controle Esta é uma propriedade somente de leitura que mostra o tipo de objeto capturado, por exemplo, caixa de texto ou botão.
    DOMXPath É o caminho usado para localizar o controle ou objeto que é capturado. DOMXPath pode ser de dois tipos: XPath Relativo e XPath Absoluto.
    • Xpath Absoluto: Contém o caminho completo desde o elemento raiz até o elemento desejado. Por exemplo, um Xpath absoluto para este tópico seria /html/body/div/div[1]/main/​div[2]/div/div/​div[2]/div/div/div[1]/​div/article/main/​article/div/p[1]
    • Xpath Relativo: É um caminho mais curto, que se refere a um elemento que você deseja identificar. Um caminho relativo começa com um símbolo //. Por exemplo, o XPath relativo para este tópico seria //*[@id="cloud-using-recorder-action"]/div/p[1]
    Por exemplo, se quiser encontrar o DOMXPath de um elemento específico sobre o navegador Google Chrome, execute estas etapas:
    1. Selecione o elemento para o qual você deseja extrair a XPath.
    2. Clique com o botão direito do mouse sobre o elemento e selecione Inspecionar.
    3. Clique com o botão direito do mouse sobre o elemento destacado em Elemento.
    4. Acesse Copiar > Copiar Xpath para copiar o caminho relativo e selecione Copiar > Copiar Xpath completo para copiar o caminho absoluto.
    Caminho É uma representação numérica da posição de um determinado controle em uma aplicação. Para aplicações Web, a melhor prática é usar DOMXPath dos critérios de busca, quando se converteu em Caminho.
    Nome HTML e ID Estes atributos são usados para identificar um objeto HTML
    Texto interno de HTML A propriedade DOM innerText é usada para definir ou retornar o conteúdo do texto de um nó especificado e seus descendentes
    HTML tag HTML tags são como palavras-chave que definem a forma como o navegador da web se formata e exibe o conteúdo. Por exemplo, se o texto capturado tiver um código HTML: <h3 class="search_results-title">Search results for ״string package״</h3> e, em seguida, insira h3 no campo HTML tag.
    Microsoft Active Accessibility Tipo de controle Essa propriedade é usada apenas como referência para assegurar que o objeto correto seja capturado
    Caminho É uma representação numérica da posição de um determinado controle em uma aplicação
    Nome Especifica um nome de um elemento e funciona como identificador
    ID Especifica a identificação de um elemento e funciona como identificador
    Tecnologia Java Tipo de controle Essa propriedade é usada apenas como referência para assegurar que o objeto correto seja capturado
    Caminho É uma representação numérica da posição de um determinado controle em uma aplicação
    Automação da Interface do Usuário Microsoft Tipo de controle Essa propriedade é usada apenas como referência para assegurar que o objeto correto seja capturado
    Caminho É uma representação numérica da posição de um determinado controle em uma aplicação
    Nome Especifica um nome de um elemento e funciona como identificador
    ID Especifica a identificação de um elemento e funciona como identificador
    IsFirst Essa propriedade permite que o bot detecte o primeiro objeto com base nos critérios de pesquisa, em vez de percorrer a árvore inteira. Você pode usar essa propriedade quando um objeto não tiver um ID de automação exclusivo e a hierarquia do objeto for alterada no aplicativo.
    Automação da Interface do Usuário Microsoft (COM) Tipo de controle Essa propriedade é usada apenas como referência para assegurar que o objeto correto seja capturado.
    Caminho É uma representação numérica da posição de um determinado controle em uma aplicação.
    Nome Especifica um nome de um elemento e funciona como identificador.
    ID Especifica a identificação de um elemento e funciona como identificador.
    O bot usará as propriedades selecionadas para identificar o controle do objeto durante o tempo de execução.
    1. Verifique se o Tipo de controle corresponde 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.
      Se o Tipo de controle não corresponder ao objeto pretendido, recupere o controle do objeto.
    2. Selecione e atribua valores às propriedades do objeto que deseja incluir na busca do objeto.
      Para um bot mais confiável, recomendamos que você selecione apenas as propriedades com valores estáticos (como Nome, Classe, Tipo, ID HTML, e DOMXPATH) e desmarque as propriedades com valores dinâmicos (como HTML Href, Caminho ou Valor), que estão sujeitas a alterações e causam erros de bot.
      É uma melhor prática usar o caractere curinga (*) ou variável nos valores de propriedade do objeto para procurar objetos cujas propriedades são dinâmicas e mudam com frequência.
      Nota: No momento, a correspondência de caracteres curinga não é suportada pela tecnologia SAP. Quando você executa um bot com um caractere curinga, ele corresponde aos valores da propriedade exatamente conforme especificado nos critérios de pesquisa.
  9. Selecione a Ação na lista suspensa.
    Para uma lista completa de possíveis ações de objeto, consulte Ações realizadas em objetos capturados com Universal Recorder.
    • Se registrar um clique e teclas em uma caixa de texto com um Tipo de controle do Password text, o Gravador não capta os toques de tecla inseridos no campo. Em vez disso, a ação seleciona o Texto definido e oferece opções para inserir a senha com segurança. Recomendamos que você armazene a senha no Credential Vault e insira na ação como uma credencial.

      Consulte Credenciais e variáveis credenciais no Editor de bot.

      Ao navegar para a caixa de texto usando a tecla TAB em vez de um clique em um aplicativo MSAA ou SAP, o Gravador será capaz de identificar campos com um Tipo de controle de Password text.

    • Se a Ação selecionada for compatível com processamento de fundo, aparecerá uma opção Executar em segundo plano.

      Consulte Universal Recorder para automação baseada em objetos.

  10. No campo Definir tempo limite do sistema, selecione Básico ou Avançado.
    • básico: No campo Aguardar resposta do sistema (em segundos), especifique quantos segundos o bot deve esperar para que o controle do objeto apareça na janela do aplicativo. Esse tempo de espera inclui o tempo de espera para carregamento da página e pesquisa de objeto.

      Recomendamos definir um tempo de espera ao usar a ação Definir texto para inserir toques de tecla em um campo de texto.

      Nota: O tempo limite especificado para o bot esperar que o controle apareça na janela do aplicativo se aplica somente se a janela na qual o controle está presente existir. O Gravador primeiro procura a janela do aplicativo e só depois procura o objeto dentro dessa janela. O tempo padrão para pesquisar a janela é de 30 segundos. Portanto, mesmo se você especificar o tempo de espera como 5 segundos, ele ainda aguardará 30 segundos por padrão se a janela não existir.

      Recomendamos utilizar primeiro a condição If > A janela existe, especificar um tempo de espera de zero segundo e garantir que a janela do aplicativo existe. Se a janela existir, então usar o Gravador, especificar um tempo de espera de 5 segundos e executar o bot para detectar o objecto.

    • Avançado: Use esta opção para automatizar sites que carregam e atualizam constantemente com os dados mais recentes, como um site do mercado de ações. Tecnicamente, esses sites nunca são carregados de forma completa na tela. Nesses casos, o bot não precisa esperar que a página da web seja totalmente carregada e pode passar direto para a automatização dessa página após um determinado tempo.

      No campo Aguardar resposta do navegador (em segundos), especifique quantos segundos o bot deve esperar o navegador carregar. Selecione uma das opções abaixo:

      • Pare o bot e exiba uma mensagem de erro: Se a página da web não tiver carregado completamente dentro do tempo limite especificado, selecione esta opção para interromper o bot e exibir uma mensagem de erro.
      • Pule e vá para o objeto: Selecione esta opção para ir direto para o objeto e capturá-lo mesmo que a página da web não tenha carregado completamente.

      No campo Aguardar resposta do objeto (em segundos), especifique quantos segundos o bot deve esperar para que o controle do objeto apareça na janela do aplicativo.

  11. Opcional: Atribuir a saída a uma variável.
    A Control Room sugere um nome de variável padrão descritivo, com base na ação selecionada no passo 8. Por exemplo, se você selecionou Obter propriedade, a variável de saída sugerida é PropertyValue. Se você criar várias variáveis de saída, os nomes das variáveis subsequentes são anexados com um -1, para evitar a duplicação.
  12. Clique em Salvar.
    As imagens capturadas não são adicionadas como dependências e não serão exibidas na lista de dependências quando você fizer check in do bot.
Ligar um objeto a uma âncora de apoio
Nota: Você pode usar ancoragem de objetos em aplicativos Microsoft Active Accessibility, UI Microsoft Automation, ou Java.
Em tempo de execução, se o bot não puder identificar com segurança um objeto, ligue-o a um objeto próximo (como um link ou botão) que seja mais fácil para o bot encontrar:
  1. Abra a ação Capturar.
  2. Clique na guia Anchor (Âncora).
  3. Clique em Capture anchor (Âncora de captura).

    O navegador ou janela de aplicação é ativado com o objeto principal destacado (o objeto que você capturou anteriormente). Aparece uma caixa de diálogo, verificando se a ação identificou corretamente o objeto principal.

  4. Se o objeto correto estiver destacado, clique em Sim, selecionar âncora.

    Caso contrário, clique em Não, preciso corrigir para selecionar o objeto correto.

  5. Selecione um objeto próximo ao objeto-alvo que seja mais fácil para o bot encontrar.

    O objeto é destacado com um ícone de âncora à direita do objeto.

  6. Clique em Salvar.