Guia do usuário do Studio

Última atualização 17 de dez de 2024

Pesquisa difusa

Sobre a pesquisa Fuzuê

Um seletor contém uma tag de nível superior que faz referência à janela de destino ou aba do navegador. Ele tem atributos como título, nome do processo, URL, nome da janela, e outros, que podem ajudar a identificar corretamente os elementos que você deseja usar em seus projetos de automação.

Muitas vezes, os valores da tag de nível superior estão sujeitos a alterações dinâmicas, porque o aplicativo de destino os reescreve com base em suas ações. Por exemplo, um título de página web pode mudar durante o processo de automação, o que torna inválido o seletor correspondente.

Nesse sentido, as capacidades de busca fuzuê do seletor permitem que você localize strings com base em um padrão, em vez de uma correspondência exata à sua entrada. Isso resulta em um método mais flexível de identificar elementos e valida os seletores de acordo com vários atributos, mesmo que alguns possam mudar durante o processo de automação.

Como a pesquisa Fuzuê funciona

Para usar os recursos de pesquisa difusa, algumas opções de correspondência precisam ser incluídas na tag de nível superior do seletor de destino, da seguinte forma:

Opção	Description
`matching:<tag_name>=fuzzy`	Permite que você especifique a tag de pesquisa de destino, determinada pelo valor `<tag_name>`.
`fuzzyLevel:<tag_name>=<numerical_value>`	Determina o limite de correspondência para o destino `<tag_name>`. Compatível com um valor numérico de 0 a 1, da seguinte maneira: Mais próximo de 0 - retorna resultados com menor similaridade ao `<tag_name>` Mais próximo de 1 - retorna resultados com maior similaridade ao `<tag_name>`

Observação: se mais elementos forem encontrados, a ação de destino será executada no primeiro.

Tipos de seletor compatíveis

Atualmente, a pesquisa fuzzy é compatível com os seguintes tipos de seletor:

Tipo de seletor	Suporte
`<wnd>`
`<html>`
`<webctrl>`
`<java>`
`<ctrl>`
`<uia>`
`<sap>`
`<rdp>`
`<silverlight>`
Tags que identificam um nome de processo. Exemplo: `<html app="firefox.exe">`.

Observação:

Adicionar check:text="example" em um seletor fuzzy verifica se o elemento de destino contém o texto especificado.

Por exemplo, adicionar check:text="Options" a um seletor fuzuê verifica se o elemento de destino contém o texto Options.

Exemplos de uso da pesquisa fuzzy

A Pesquisa Fuzuê pode ser usada para identificar quase todos os tipos de atributos nas tags de nível superior dos seletores. Nos seguintes exemplos, buscamos criar seletores válidos com atributos escritos incorretamente:

A. Usando um Nível Alto de Aproximação

Vamos supor que queremos criar um seletor para identificar o atributo W3Schools Online Web Tutorials <title>. Para o propósito do nosso exemplo, o atributo é escrito incorretamente, tornando o seletor inválido.

<html app='firefox.exe' title='WEScho0ls Online Web Tutorials' /><html app='firefox.exe' title='WEScho0ls Online Web Tutorials' />

Para corrigir isso, precisamos colocar uma Pesquisa Fuzzy dentro da tag <html>. Como o atributo de interesse é <title>, o <tag_name> da nossa expressão de Pesquisa Fuzuê precisa ter a forma matching:title=fuzzy. O erro no nosso atributo <title> é pequeno para que possamos usar um nível de aproximação mais perto de 1. O seletor a seguir é gerado, que retorna o atributo <title> correto que, neste caso, é W3Schools Online Web Tutorials:

<html app='firefox.exe' title='WEScho0ls Online Web Tutorials'
      matching:title='fuzzy' fuzzylevel:title='0.8' /><html app='firefox.exe' title='WEScho0ls Online Web Tutorials'
      matching:title='fuzzy' fuzzylevel:title='0.8' />

B. Usando um Nível Baixo de Aproximação

Neste segundo exemplo, precisamos criar seletores para um atributo <aaname>. O atributo de destino é Colorpicker, mas, em nosso exemplo, está escrito incorretamente Clorker. É evidente que, com um atributo escrito incorretamente, nosso seletor é inválido e tem esta aparência:

<html title='W3Schools Online Web Tutorials' /> 
<webctrl aaname='Clorker' parentid='main' tag='IMG' /><html title='W3Schools Online Web Tutorials' /> 
<webctrl aaname='Clorker' parentid='main' tag='IMG' />

A pesquisa difusa precisa ser incluída na tag <webctrl>. Nesse caso, nosso destino é <aaname>. Como há mais erros na escrita do nosso destino, reduziremos o nível de aproximação para mais perto de 0, para que haja mais chances de detecção precisa. O seletor a seguir é gerado, que retorna o atributo <aaname> correto que, neste caso, é Colorpicker:

<html title='W3Schools Online Web Tutorials' /> 
<webctrl aaname='Colorker' parentid='main' tag='IMG' matching:aaname='fuzzy' fuzzylevel:aaname='0.4' /><html title='W3Schools Online Web Tutorials' /> 
<webctrl aaname='Colorker' parentid='main' tag='IMG' matching:aaname='fuzzy' fuzzylevel:aaname='0.4' />