studio
2024.10
true
Guia do usuário do Studio
Last updated 4 de nov de 2024

Sobre seletores

Para automatizar ações específicas na interface do usuário, é necessário interagir com diversas janelas, botões, listas suspensas, entre outros. Uma das maneiras em que os elementos de interface gráfica podem ser identificados é usar sua posição na tela, mas isso pode não ser confiável.

Para superar esse problema, o Studio usa o que chamamos de seletores. Eles armazenam os atributos de um elemento da interface gráfica e seus pais, na forma de um fragmento XML.

Na maioria das vezes, os seletores são gerados automaticamente pelo Studio e não requerem mais nenhuma entrada sua, especialmente se os aplicativos que você estiver tentando automatizar tiverem uma interface de usuário estática.

No entanto, alguns softwares possuem layouts que se modificam e atribuem nós com valores voláteis, como alguns aplicativos web. O Studio não pode prever essas alterações e, portanto, você pode ter que gerar manualmente alguns seletores.

Um seletor tem a seguinte estrutura:

<node_1/><node_2/>...<node_N/><node_1/><node_2/>...<node_N/>

O último nó representa o elemento GUI que interessa a você e todos os anteriores representam os pais desse elemento. <node_1> geralmente é referido como um nó raiz, e representa a janela superior do aplicativo.

Cada nó contém um ou mais atributos que ajudam a identificar um nível específico do aplicativo selecionado.

Cada nó tem o seguinte formato: 

<ui_system attr_name_1='attr_value_1' ... attr_name_N='attr_value_N'/><ui_system attr_name_1='attr_value_1' ... attr_name_N='attr_value_N'/>

Cada atributo tem um valor atribuído. É importante escolher atributos com um valor constante. Se o valor de um atributo mudar a cada vez que o aplicativo for iniciado, o seletor não conseguirá identificar corretamente o elemento.

Os seletores são exibidos no painel Propriedades de atividades, em Entrada > Destino > Seletor. Todas as atividades relacionadas aos elementos gráficos têm essa propriedade.



A janela Opções de seleção permite selecionar e editar um destino. Para acessar essa janela, no painel Designer de Fluxo de Trabalho, clique no botão Opções no corpo de uma atividade e selecione Indicar destino na tela ou Editar destino.



A janela Editor de Seletor permite que você veja o seletor gerado automaticamente, edite-o e seus atributos. Para acessar essa janela, use o botão Reticências próximo ao campo Seletor, no painel Propriedades.



Opção

Description

Validar

O botão mostra o status do seletor, verificando a validade da definição do seletor e a visibilidade do elemento de destino na tela.

O botão Validar possui três estados:

  • docs image O seletor está sendo validado
  • docs image Seletor válido
  • docs image Seletor inválido
  • docs image Seletor alterado, revalidar

O botão está correlacionado aos estados de validação do UI Explore.

Indicar Elemento

Indica um novo elemento da interface gráfica para substituir o anterior.

Reparar

Permite que você indique novamente o mesmo elemento de interface gráfica de destino e repare o seletor. Essa operação não substitui completamente o seletor anterior. O botão fica disponível apenas quando o seletor for inválido.

Highlight

Traz o elemento de destino para o primeiro plano. O destaque continua até que a opção seja desabilitada com um clique. O botão será habilitado apenas se o seletor for válido.

Editar Atributos

Contém todos os componentes da aplicação necessários para identificar a aplicação de destino (uma janela, botão, etc.). Esta seção é editável.

Editar Seletor

Contém o seletor real. Esta seção é editável.

Abrir no Explorador de Interface Gráfica

Inicia o UI Explorer. A opção fica habilitada apenas para seletores válidos.

Observação: em algumas situações, quando o Studio e o aplicativo de destino são abertos com diferentes privilégios elevados, o seletor pode não funcionar. Recomendamos sempre abrir os dois aplicativos com os mesmos privilégios.

Tags e atributos compatíveis

As seguintes tabelas apresentam a compatibilidade entre tags e atributos utilizados para criar seletores e a capacidade dos seletores:

Observação: os seletores gerados para aplicativos Java que contêm várias tags WND não podem ser usados com monitoramento de eventos.

WND

Atributo

Fuzzy

RegEx

Diferenciação de maiúsculas e minúsculas

app

available

available

available

cls

available

available

available

title

available

available

available

aaname

available

available

available

ctrlname (WinForms)

available

available

available

ctrlid (WinForms)

available

available

available

idx

Não disponível

Não disponível

Não disponível

tid

Não disponível

Não disponível

Não disponível

pid

Não disponível

Não disponível

Não disponível

isremoteapp

Não disponível

Não disponível

Não disponível

aastate

available

available

available

sapClient (SAP)

available

available

available

sapLanguage (SAP)

available

available

available

sapProgram (SAP)

available

available

available

sapScreen (SAP)

Não disponível

Não disponível

Não disponível

sapSession (SAP)

Não disponível

Não disponível

Não disponível

sapSysName (SAP)

available

available

available

sapSysNumber (SAP)

Não disponível

Não disponível

Não disponível

sapSysSessionId (SAP)

available

available

available

sapTransaction (SAP)

available

available

available

sapUser (SAP)

available

available

available

HTML

Atributo

Fuzzy

RegEx

Diferenciação de maiúsculas e minúsculas

url

available

available

available

htmlwindowname

available

available

available

title

available

available

available

class

available

available

available

app

Não disponível

Não disponível

Não disponível

idx

Não disponível

Não disponível

Não disponível

pid

Não disponível

Não disponível

Não disponível

tid

Não disponível

Não disponível

Não disponível

excludehwnd

Não disponível

Não disponível

Não disponível

bsid (Browser Session ID)

Não disponível

Não disponível

Não disponível

isremoteapp

Não disponível

Não disponível

Não disponível

WEBCTRL

Os atributos tag e id usam valores de strings. Todos os outros atributos WEBCTRL têm valores dinâmicos.

Atributo

Fuzzy

RegEx

Diferenciação de maiúsculas e minúsculas

tag

available

available

available

idx

available

available

available

aaname

available

available

available

name

available

available

available

id

available

available

available

parentid

available

available

available

class

available

available

available

css-selector

Não disponível

Não disponível

Não disponível

innertext

available

available

available

visibleinnertext

available

available

available

isleaf

available

available

available

parentclass

available

available

available

parentname

available

available

available

src

available

available

available

href

available

available

available

tableCol

available

available

available

tableRow

available

available

available

colName

available

available

available

rowName

available

available

available

aria-label

available

available

available

aria-labelledby

available

available

available

CTRL

Atributo

Fuzzy

RegEx

Diferenciação de maiúsculas e minúsculas

Role

available

available

available

name

available

available

available

automationid

available

available

available

labeledby

available

available

available

aastate

available

available

available

virtualname

available

available

available

text

available

available

available

rowName

available

available

available

idx

Não disponível

Não disponível

Não disponível

UIA

Atributo

Fuzzy

RegEx

Diferenciação de maiúsculas e minúsculas

accelkey (Accelerator Key)

available

available

available

acskey (Access Key)

available

available

available

automationid

available

available

available

cls

available

available

available

helpText

available

available

available

legacyAccHelp (Legacy Accessible Help)

available

available

available

enabled

available

available

available

kbfocus (Is Keyboard Focusable)

available

available

available

ispwd (Is Password)

available

available

available

itemstatus

available

available

available

itemtype

available

available

available

rtid (Runtime ID)

available

available

available

Role

available

available

available

name

available

available

available

pid

available

available

available

tableRow

Não disponível

Não disponível

Não disponível

tableCol

Não disponível

Não disponível

Não disponível

rowName

available

available

available

colName

available

available

available

idx

Não disponível

Não disponível

Não disponível

Java

Atributo

Fuzzy

RegEx

Diferenciação de maiúsculas e minúsculas

Role

available

available

available

name

available

available

available

virtualname

available

available

available

javastate

available

available

available

tableRow

Não disponível

Não disponível

Não disponível

tableCol

Não disponível

Não disponível

Não disponível

rowName

available

available

available

colName

available

available

available

idx

Não disponível

Não disponível

Não disponível

SAP

Atributo

Fuzzy

RegEx

Diferenciação de maiúsculas e minúsculas

id

available

available

available

leafid

Esse atributo não fica exposto no painel Atributo porque é mutuamente exclusivo com o atributo id. Ele pode ser adicionado manualmente.

available

available

available

tableRow

Não disponível

Não disponível

Não disponível

tableCol

Não disponível

Não disponível

Não disponível

colName

available

available

available

relpath

available

available

available

itemId

available

available

available

Silverlight

Observe que a tag Silverlight não é compatível com os recursos Fuzzy, RegEx e Diferenciação de maiúsculas e minúsculas.

  • Tags e atributos compatíveis
  • WND
  • HTML
  • WEBCTRL
  • CTRL
  • UIA
  • Java
  • SAP
  • Silverlight

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.