Guia do usuário do Studio

Última atualização 20 de dez de 2023

Pesquisa de Reges

Sobre a pesquisa RegEx

Uma expressão regular, ou RegEx, é uma string de texto especial para descrever um padrão de pesquisa. Isso torna-as ideias para a pesquisa, o processamento de textos e a validação de dados. O uso de recursos de pesquisa RegEx em seletores permite que você identifique vários elementos de destino com uma única execução de pesquisa. Sem o RegEx, vários seletores teriam que ser criados para identificar cada elemento de destino.

Como funciona a pesquisa RegEx

Para usar os recursos de pesquisa RegEx, uma opção de correspondência precisa ser incluída na tag do elemento que você deseja identificar, da seguinte maneira:

Opção	Description
`matching:<tag_name>=’regex’`	Permite que você especifique a tag de pesquisa de destino, determinada pelo valor `<tag_name>`.
`<tag_name>='<regex_command>'`	Permite que você especifique o padrão de pesquisa por meio da expressão `<regex_command>` usada para identificar o `<tag_name>`.

No momento, a pesquisa RegEx é compatível com os seguintes tipos de seletor:

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

Exemplos de uso da pesquisa RegEx

Vamos considerar que queremos criar um processo de automação com o aplicativo Calculadora como destino. No entanto, para o propósito deste exemplo, o valor da tag <name> alterna entre 0 e 2. Sem a pesquisa RegEx, dois seletores teriam sido criados, um para cada valor da tag <name>, da seguinte maneira:

Seletor para a tag <name='Display is 0'>:

<wnd app='applicationframehost.exe' appid='Microsoft.WindowsCalculator_8wekyb3d8bbwe!App' title='Calculator' />  <uia cls='LandmarkTarget' />  <uia automationid='CalculatorResults' name='Display is 0' role='text' /><wnd app='applicationframehost.exe' appid='Microsoft.WindowsCalculator_8wekyb3d8bbwe!App' title='Calculator' />  <uia cls='LandmarkTarget' />  <uia automationid='CalculatorResults' name='Display is 0' role='text' />

Seletor para a tag <name='Display is 2'>:

<wnd app='applicationframehost.exe' appid='Microsoft.WindowsCalculator_8wekyb3d8bbwe!App' title='Calculator' />  <uia cls='LandmarkTarget' />  <uia automationid='CalculatorResults' name='Display is 2' role='text' /><wnd app='applicationframehost.exe' appid='Microsoft.WindowsCalculator_8wekyb3d8bbwe!App' title='Calculator' />  <uia cls='LandmarkTarget' />  <uia automationid='CalculatorResults' name='Display is 2' role='text' />

Introduzir a pesquisa RegEx dentro da segunda tag <uia> possibilita gerar apenas um seletor para corresponder ambos os casos. Um seletor válido, neste caso, é semelhante ao seguinte:

Seletor com a pesquisa RegEx

<wnd app='applicationframehost.exe' appid='Microsoft.WindowsCalculator_8wekyb3d8bbwe!App' title='Calculator' /> 
<uia cls='LandmarkTarget' /> 
<uia automationid='CalculatorResults' name='Display is \d' role='text' matching:name='regex' /><wnd app='applicationframehost.exe' appid='Microsoft.WindowsCalculator_8wekyb3d8bbwe!App' title='Calculator' /> 
<uia cls='LandmarkTarget' /> 
<uia automationid='CalculatorResults' name='Display is \d' role='text' matching:name='regex' />

O atributo matching:name='regex' instrui nosso seletor a usar o RegEx para identificar a tag <name>, ao mesmo tempo que o comando <name='Display is \d'> retorna todos os valores numéricos para a tag <name> que ele identifica.

Veja abaixo alguns exemplos sobre como funciona a pesquisa RegEx e quais valores ela retorna:

Expressão Regular	Description	Resultados retornados
`(.RPA.)\|(.Robotic Process Automation)`	Corresponde todas as strings que contêm as strings RPA ou Automação de processos robóticos.	(…) ferramenta de RPA líder (…) A UiPath é uma plataforma de automações de processos robóticos (…)
`^Index[0-5]`	Corresponde todas as strings começando com o valor `Index`, seguido por um número entre 0 e 5.	Index5 Índice03