Encontrar Campo

Permite a busca de elementos de programas Windows

CONFIGURAÇÃO

Para utilizar esse objeto é necessário selecionar um objeto do tipo Automação Windows e configurar os seus parâmetros.

Layout geral do objeto

Preenchendo o objeto:

Campo	Descritivo
Título	É o nome do objeto e não precisa ser alterado, a menos que você queira identificá-lo para facilitar a localização dele no robô, por exemplo: "Encontrar Campo - Novo Campo Windows".
Nome Identificador do Objeto	É um identificador único do objeto e não precisa ser alterado, mas você pode renomear caso queira para localizá-lo mais facilmente quando for usá-lo em outros objetos. Apenas lembre-se que esse nome deve ser único e sem espaços ou caracteres especiais.
Selecionar objeto do tipo Automação Windows	Seleciona objetos do tipo Automação Windows Aplicações.
Forma de Busca	Tipo de busca que será realizada para encontrar o campo. Xpath / Nome / Classe / Id de Automação
Buscar apenas um	Configura Objeto para buscar apenas um elemento (melhor performance).
Buscar uma lista	Configura Objeto para buscar uma lista de elementos.
Tempo de espera	Tempo de espera para encontrar o campo.
Parar execução caso algo der errado na busca do elemento	Habilita lançamento de erro e por consequência, para a execução do robô.
Adicionar tempo de espera para o inicio da execução	Adiciona tempo de espera antes de executar a funcionalidade do objeto
Adicionar tempo de espera para o fim da execução	Adiciona tempo de espera após executar a funcionalidade do objeto

INTERPOLAÇÃO

Trata-se de um conceito técnico utilizado em programação e você não precisa se preocupar em alterá-lo neste momento.

AÇÕES EM ELEMENTOS

Campo	Descritivo
Clicar	Ativa ação de clique no elemento encontrado (apenas para busca de 1 elemento).
Clicar com Direito	Ativa ação de clique com o botão direito no elemento encontrado (apenas para busca de 1 elemento).
Clique Duplo	Ativa ação de clique duplo no elemento encontrado (apenas para busca de 1 elemento).
Digitar	Ativa a digitação no elemento encontrado (apenas para busca de 1 elemento).
Teclas de atalho	Ativa a tecla de atalho no elemento encontrado (apenas para busca de 1 elemento).

SITUAÇÃO ESPECÍFICA DE USO

• Caso deseja trazer o nome, descrição ou valor do texto de janelas Java, recomendamos usar o nome da variável, com o index do resultado (Buscar apenas um) será 0,

  combinando com JavaElement.finalElement e sua propriedade desejada.

VARIÁVEIS

Nome	Valor	Exemplo
Nome do elemeto	name	variavel.Result[0].JavaElement.finalElement.name
Descrição do elemento	description	variavel.Result[0].JavaElement.finalElement.description
Valor do texto	textValue	variavel.Result[0].JavaElement.finalElement.textValue

PRÉ-REQUISITOS

• Para utilizar esse objeto é necessário configurar objeto que Selecione a Janela do Programa ou consiga abrir o programa. Sendo eles, Selecionar Janela (junto com suas variações) e Abrir Programa.

CASOS DE USO

• Utilizar para buscar algum campo dentro de programas Windows e em seguida realizar algum tipo de verificação ou ação nesse elemento.

• Caso necessite de ajuda para achar o Xpath dentro do programa é sugerido a busca da seguinte forma: https://docs.roboteasy.tech/studio/geral/obter-elemento-xpath-gravador-windows.

EXEMPLO

Abrir um programa, encontrar o campo para digitar e fazer a ação com visualização em tela.

ITENS UTILIZADOS NO ROBÔ

• Objetos: Abrir Programa.

Configuração Robô Exemplo Encontra Campo

PASSO 1: Configurar Abrir Programa.

Configuração Abrir Programa

PASSO 2: Configurar Digitar no Campo com o Xpath //* para selecionar o programa inteiro e não somente um campo.

Configuração Encontrar Campo

Configuração Encontrar Campo Ação no elemento

PASSO 3: Executar o robô e verificar as ações.

Execução Sucesso Robô Exemplo Encontrar Campo

Baixar o Robô

9KB

Encontrar Campo - Robô Exemplo.roboteasy

39B

Abrir Programa - Exemplo.txt

EXEMPLO 02

Utilizar a opção Buscar uma Lista para selecionar um elemento de uma Lista de Objetos do Studio e fazer uma ação.

ITENS UTILIZADOS NO ROBÔ

• Objetos: Selecionar Janela - Varrer Lista - Condição If - Caixa de Mensagem

• xPath: /Document/Group[3]/Group[*] (Xpath que pega a lista inteira) - /Document/Group[3]/Group[{count}] (Xpath que identificado o countador correto para a ação)

• Condição: structRepeat3.Name == "Blocos de Comandos"

Robô Exemplo Buscar Uma Lista

PASSO 1: Configurar Selecionar Janela para selecionar o Roboteasy Studio.

Configuração Selecionar Janela

PASSO 2: Configurar Encontrar Campo com o Xpath da Lista de Objetos.

Xpath original não tem o ícone (*), contudo para varrer a lista com todos os elementos é necessário trocar e colocar o ícone em questão, pois ele indica ao objeto varrer funcionar na lista inteira.

Configuração Encontrar Campo

PASSO 3: Configurar Varrer Lista com o Count começando em 1 para fazer a ação correta no elemento desejado.

Configuração Varrer Lista

PASSO 4: Configura Condição If com o nome da variável do varrer lista mais a propriedade .Name (passa somente os nomes da lista) com a condição de igual (==) definindo o nome do elemento desejado na lista.

Configuração Condição IF

PASSO 5: Configurar Caixa de mensagem com o nome da variável do varrer lista mais a propriedade .Name (passa somente os nomes da lista) para demonstrar em tela o nome desejado.

Configuração Caixa de Mensagem

PASSO 6: Configurar Encontra Campo com a variável do Count do Varrer Lista para fazer a ação correta no objeto

Configuração Encontrar Campo

PASSO 7: Executar o robô e verificar as ações.

Execução Sucesso Robô Exemplo Buscar uma Lista

Baixar o Robô

25KB

Encontrar Campo - Buscar Uma Lista.roboteasy