Como usar a ação Localizar janela na janela

Use a ação Localizar janela na janela para pesquisar um elemento de UI em uma janela de aplicativo usando uma captura de tela de uma janela. Essa ação permite capturar uma imagem de um elemento de UI em um aplicativo e usar a imagem capturada para pesquisar aquele elemento de UI em outra janela.

Procedimento

Para usar uma imagem disponível em uma janela do aplicativo para encontrar uma imagem em outra janela do aplicativo, siga estas etapas:

  1. Clique duas vezes ou arraste a ação Localizar imagem na janela no pacote Reconhecimento de imagem na paleta Ações.
  2. Especifique a imagem-alvo (needle) que deseja encontrar na janela do aplicativo.
    OpçãoDescrição
    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.
    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.
    Você pode usar uma expressão regular (regex) para identificar um título da janela. Selecione a expressão regular como uma String ou como Padrão para cada condição de expressão regular e insira o valor. Por padrão, o campo Título da janela diferencia maiúsculas e minúsculas. Você pode habilitar um sinalizador regex que diferencia maiúsculas e minúsculas para identificar um título da janela que não 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.
  3. Clique em Capturar imagem para capturar a imagem-alvo.
  4. Arraste o ponteiro do mouse sobre uma área da janela do aplicativo.
    A área capturada aparece na seção Pré-Visualização.
  5. Especifique a janela na qual deseja localizar a imagem de origem (haystack):
    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 Google Chrome, que estão atualmente abertas no dispositivo Bot Creator.
    Nota: Atualmente, esta opção é compatível apenas com guias do Google Chrome. 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.

    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 bot primeiro 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 expressão regular como uma String ou como Padrão para cada condição de expressão regular e insira o valor. Por padrão, o campo Título da janela diferencia maiúsculas e minúsculas. Você pode habilitar um sinalizador regex que diferencia maiúsculas e minúsculas para identificar um título da janela que não diferencia maiúsculas e minúsculas. Você pode ativar a opção Diferenciar maiúsculas de minúsculas para identificar uma janela estática ou um título de navegador e um título com um caractere curinga que diferencia maiúsculas e minúsculas e desativar a opção para identificar um título de janela que não diferencia maiúsculas e minúsculas.

    Por exemplo, você pode inserir o valor da String como ((\w*)-Notepad para todos os nomes de títulos de janela que começam com ((\w*)-Notepad, ou usa Padrão como ((\w)\s)*document-Notepad somente para os títulos de janela que correspondem a esse padrão.

  6. 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.
  7. Clique em Região de captura.
    A janela selecionada será exibida.
  8. Arraste o mouse para selecionar a área e clique com o botão direito quando terminar.
    A área capturada aparece na seção Pré-visualizar com as coordenadas da imagem abaixo.
  9. No campo Esperar em ms antes de capturar a janela, especifique o período (em milissegundos) antes de pesquisar a imagem.
  10. Marque a caixa de seleção Repetir se a imagem não for encontrada se quiser que o sistema tente localizar novamente a imagem-alvo se ela não for encontrada.
    1. No campo Vezes, especifique o número de vezes que o sistema precisa repetir o processo para encontrar a imagem-alvo.
    2. No campo Esperar entre repetições (ms), especifique o período que o sistema precisa esperar antes de repetir o processo para encontrar a imagem-alvo.
  11. No campo Percentual de correspondência, especifique a porcentagem aceitável de pixels correspondentes entre as duas imagens.
    Por exemplo, se você especificar 20 no campo como porcentagem de correspondência, o sistema vai considerar as imagens como correspondentes mesmo se houver até 80% de incompatibilidade de pixels entre as duas imagens.
  12. No campo Número correspondente selecionado, insira um valor para especificar a ocorrência da imagem-alvo na qual você deseja executar essa ação.
    Você pode usar uma variável quando não souber o número de vezes que a imagem pode aparecer na tela. Assegure-se de atribuir variáveis que suportam valores numéricos.
  13. Use a opção Pré-visualizar se você quiser selecionar uma imagem que seja relativa (offset) à imagem-alvo existente que você está procurando na tela da aplicação, ou se você quiser selecionar uma ocorrência específica se houver múltiplas ocorrências da imagem-alvo.
  14. Clique em Visualizar.
    Se uma imagem-alvo ocorrer várias vezes na janela Pré-visualizar, cada ocorrência é destacada em uma caixa retangular e exibe um número contra cada ocorrência.
  15. Selecione a ocorrência específica destacada, e você pode posicionar seu local de clique em relação a uma imagem existente.
    Nota: Se houver múltiplas imagens em uma tela de aplicação que você está automatizando e quando a imagem-alvo não for facilmente pesquisável; nesse caso, você pode selecionar uma imagem facilmente identificável na região capturada e posicionar seu clique em relação a ela.
  16. Se a imagem-alvo for encontrada várias vezes na região capturada. Nesse caso, você pode selecionar a ocorrência de uma determinada imagem-alvo ou selecionar o número da ocorrência no menu suspenso no campo Número da correspondência (opcional) no painel direito.
    Os campos Número da correspondência (opcional) e Deslocamento do alvo do painel à direita mostram a ocorrência da imagem selecionada e suas coordenadas de deslocamento da imagem-alvo.
  17. Clique em Enviar.
  18. No campo Seleções de coordenadas-alvo, as opções de coordenadas Centro de correspondência ou Deslocamento da correspondência serão selecionadas automaticamente com base na ação que você realizou na janela Pré-visualizar.
    • Centro da correspondência: A imagem é selecionada com base nas coordenadas no centro da imagem correspondente.
    • Deslocamento da correspondência: A imagem é selecionada com base nas coordenadas relativas à da imagem correspondente.
    Nota: As coordenadas de deslocamento medem o número de pixels do canto superior esquerdo da imagem.
  19. Selecione uma opção na lista Ação a ser tomada nas coordenadas-alvo para especificar a ação que deseja executar na imagem correspondente na janela do aplicativo.
  20. Clique em Salvar.