# Encontrar Campo

## CONFIGURAÇÃO

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

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FChvnWs87taFtiTdwnoDy%2Fimage.png?alt=media&#x26;token=9a3a8a4e-123a-4542-8820-ab1fcbb98a13" alt=""><figcaption><p>Layout geral do objeto</p></figcaption></figure>

**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                                           | <p>Tipo de busca que será realizada para encontrar o campo.</p><p>Xpath / Nome / Classe / Id de Automação</p>                                                                                                                                                    |
| 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                                                                                                                                                                                                |

{% hint style="info" %}
**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.
{% endhint %}

## 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)*.                  |

{% tabs %}
{% tab title="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.
  {% endtab %}

{% tab title="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**   |
| {% endtab %}          |             |                                                              |
| {% endtabs %}         |             |                                                              |

## 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](https://docs.roboteasy.tech/studio/geral/objetos/windows/aplicacoes/selecionar-janela) (junto com suas variações) e [Abrir Programa](https://docs.roboteasy.tech/studio/geral/objetos/windows/aplicacoes/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.**

<details>

<summary>ITENS UTILIZADOS NO ROBÔ</summary>

* Objetos: [Abrir Programa](https://docs.roboteasy.tech/studio/geral/objetos/windows/aplicacoes/abrir-programa).

</details>

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FQ3tUxXDNtIYL0ukh4wY6%2Fimage.png?alt=media&#x26;token=d155b50d-8a2c-4cbb-8135-870ccf537760" alt=""><figcaption><p>Configuração Robô Exemplo Encontra Campo</p></figcaption></figure>

**PASSO 1:** Configurar Abrir Programa.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FsUtDO1zZkskadbonCGzS%2Fimage.png?alt=media&#x26;token=6a80cb4d-2687-498b-ada9-3d1b9489b9c9" alt=""><figcaption><p>Configuração Abrir Programa</p></figcaption></figure>

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

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FsG8rWxqDxQ9hJ9jm6Ztx%2Fimage.png?alt=media&#x26;token=c9a75f00-2a7f-41b5-b7ae-fbf4bbe00c35" alt=""><figcaption><p>Configuração Encontrar Campo</p></figcaption></figure>

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FhPqutZGqVpUaYDmq55rB%2Fimage.png?alt=media&#x26;token=8a37649e-09d9-4003-91c2-a09d2f9d8eba" alt=""><figcaption><p>Configuração Encontrar Campo Ação no elemento</p></figcaption></figure>

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

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FwMamdnorx7WCjACJjekv%2Fexecu%C3%A7%C3%A3o%20sucesso.gif?alt=media&#x26;token=4880ba1b-beec-4bb5-950a-d41353d8ab40" alt=""><figcaption><p>Execução Sucesso Robô Exemplo Encontrar Campo</p></figcaption></figure>

## Baixar o Robô

{% file src="<https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FcoBDyaZd8RlWkceKeL7r%2FEncontrar%20Campo%20-%20Rob%C3%B4%20Exemplo.roboteasy?alt=media&token=a16fe081-4302-4c9f-b02b-85229a74ea05>" %}

{% file src="<https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fw9cQ2IMxIlxFnJJhIH5W%2FAbrir%20Programa%20%20-%20Exemplo.txt?alt=media&token=ff830f98-bce3-49ca-b4a1-d90388dd5d9e>" %}

## 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.

<details>

<summary>ITENS UTILIZADOS NO ROBÔ</summary>

* **Objetos:** [Selecionar Janela](https://docs.roboteasy.tech/studio/geral/objetos/windows/aplicacoes/selecionar-janela-ativa) - [Varrer Lista](https://docs.roboteasy.tech/studio/geral/objetos/listas/varrer-lista) - [Condição If](https://docs.roboteasy.tech/studio/geral/objetos/blocos-de-comando/condicao-if) - [Caixa de Mensagem](https://docs.roboteasy.tech/studio/geral/objetos/acoes-globais/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"

</details>

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FAcghC3VDMAN459uFWi71%2Fimage.png?alt=media&#x26;token=e6fff472-2b7e-4ccd-b671-23b83b580e04" alt=""><figcaption><p>Robô Exemplo Buscar Uma Lista</p></figcaption></figure>

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

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fq1zVpVzyWp9LqqdZzLmP%2Fimage.png?alt=media&#x26;token=ba315fa2-85bd-4ada-a3c7-4d8350e1e6c2" alt=""><figcaption><p>Configuração Selecionar Janela</p></figcaption></figure>

**PASSO 2:** Configurar Encontrar Campo com o Xpath da Lista de Objetos.&#x20;

{% hint style="info" %}
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.
{% endhint %}

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fh5pY5mNjccVJEv6NLfMz%2Fimage.png?alt=media&#x26;token=c41eb3b8-1242-45ba-a583-aef8a53be444" alt=""><figcaption><p>Configuração Encontrar Campo</p></figcaption></figure>

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

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fu29Pgn9NbCM21VlUlKfv%2Fimage.png?alt=media&#x26;token=4227920a-c4d8-4fb5-94f2-8bb6ac000524" alt=""><figcaption><p>Configuração Varrer Lista</p></figcaption></figure>

**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.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2F9FateZyewfaUVUggVaWJ%2Fimage.png?alt=media&#x26;token=6f31a8d7-a293-481b-8c32-be36136fe11a" alt=""><figcaption><p>Configuração Condição IF</p></figcaption></figure>

**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.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FyRqa9sSZsOoFJVFHXIoF%2Fimage.png?alt=media&#x26;token=037c66cd-3e66-446f-8dc4-bb16ace7e418" alt=""><figcaption><p>Configuração Caixa de Mensagem</p></figcaption></figure>

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

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2F1CIY2h25z6xMaA7JSIIB%2Fimage.png?alt=media&#x26;token=6f084f32-feb0-4a99-a0a2-ce70b522d90b" alt=""><figcaption><p>Configuração Encontrar Campo</p></figcaption></figure>

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

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FMhaJIDxotALUdHiMBCmQ%2Fencontrar%20campo.gif?alt=media&#x26;token=388f23d1-da2c-4dd0-9c5e-98e2a363fc4b" alt=""><figcaption><p>Execução Sucesso Robô Exemplo Buscar uma Lista</p></figcaption></figure>

## Baixar o Robô

{% file src="<https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FuBBteoNlVQ2yUEBMeWYo%2FEncontrar%20Campo%20-%20Buscar%20Uma%20Lista.roboteasy?alt=media&token=68615c53-6d09-4c88-aced-663a79e09e06>" %}