Automation 360

Como usar a ação Coletar

Baixar como PDF

Contents (Conteúdo)

Como usar a ação Coletar

Baixar como PDF

Última atualização2023/03/30

Como usar a ação Coletar

Use Coletar ação para coletar 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 de combinação, 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:
- Instalar o Agente de bot e registrar dispositivo
- Definir dados do usuário do dispositivo
Configure a escala de exibição do dispositivo e da fonte para 100%.
Se estiver usando o pacote Gravador 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 você 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 Automation Workspace
Para automatizar aplicações Web sendo executadas no navegador Chromium Microsoft Edge no modo Internet Explorer usando o Gravador universal, 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:

Clique duas vezes ou arraste Gravador > Coletar.

Especifique a janela na qual é preciso capturar um objeto.

Escolha a guia Aplicação, Navegador ou Variável.

Opção	Descriçã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.

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, para corresponder a todos os nomes de títulos de janelas que começam com uma palavra seguida por - Notepad, você pode inserir o valor da String como * -Notepad ou usar o valor Padrão como ((\w)\s)*document-Notepad para apenas os títulos das janelas 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 ativaacima 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.
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.
Clique em Capturar objeto.
A janela selecionada será exibida.
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.
Clique no objeto.

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:

Important: A lista a seguir não inclui todas as propriedades e é restrita às propriedades mais comumente usadas e 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: Selecione o elemento para o qual você deseja extrair a XPath. Clique com o botão direito do mouse sobre o elemento e selecione Inspecionar. Clique com o botão direito do mouse sobre o elemento destacado em Elemento. 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
Tecnologia Java	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
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.

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

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 Gravador universal.
- 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 Gravador universal para automação baseada em objetos.
Opcional: Insira um valor no campo Continuar tentando por (segundos) para especificar o tempo em segundos que o bot deve esperar para que o controle do objeto apareça na janela do aplicativo.
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 que se utilize primeiro a condição Se > Janela existe, especificar um tempo de espera de zero segundo e garantir que a janela de aplicação 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.
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.
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:

Abra a Capturar ação.
Clique na guia Âncora.
Clique em Â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.
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.
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.
Clique em Salvar.