> For the complete documentation index, see [llms.txt](https://docs.roboteasy.tech/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboteasy.tech/studio/geral/gravador-web-genesis.md).

# Gravador Web Genesis

### Visão Geral

O **Gravador Web** é uma ferramenta do Genesis que permite capturar elementos de páginas web e gerar automaticamente os componentes da rotina (ex: **Escrever**, **Clicar**) já com **XPath**, **TagName** e ação configurados — sem precisar inspecionar manualmente a página.

<p align="center"><img src="/files/EgygXJjhTC5G0gsACmEq" alt=""></p>

<p align="center"> Menu de contexto do <strong>Gravador Web</strong> aberto sobre um elemento da página</p>

***

### Pré-requisitos

* Chrome instalado na máquina
* URL da página alvo

***

### Como usar

#### Passo 1 — Abrir o Gravador Web

Na barra superior do Genesis, clique no ícone de **três tracinhos** (menu) ao lado de **Perfil** e selecione **Gravador Web**.

#### Passo 2 — Configurar a URL e a versão do Chrome

No modal **Configurar gravador WEB**, preencha:

* **Digite a URL para iniciar a gravação:** endereço da página que será gravada (ex: `https://roboteasy.tech`)
* **Selecione a versão do Chrome:** por padrão vem selecionada a versão mais recente — altere apenas se precisar de uma versão específica

Clique em **Iniciar gravação**.

<p align="center"><img src="/files/khs81KqQ3bmGXzsKxuI2" alt=""></p>

<p align="center"> Modal <strong>Configurar gravador WEB</strong> com URL e versão do Chrome preenchidas</p>

#### Passo 3 — Navegar até o elemento

O Chrome abrirá automaticamente na URL informada. No canto superior direito da tela, serão exibidos os controles de **Pausar** (`||`) e **Parar** (`■`) a gravação.

<p align="center"><img src="/files/7FhZGJ5iQZ6JGpaZxGgP" alt=""></p>

<p align="center"> Controles de pausar e parar a gravação</p>

Navegue até o elemento que deseja capturar.

#### Passo 4 — Selecionar a ação no elemento

Clique com o **botão direito** sobre o elemento alvo. Um menu de contexto do gravador abrirá com as ações disponíveis:

| Ação             | O que faz                                               |
| ---------------- | ------------------------------------------------------- |
| Escrever         | Registra uma ação de digitação no elemento              |
| Clicar           | Registra um clique esquerdo no elemento                 |
| Tecla de atalho  | Registra uma combinação de teclas                       |
| Clique direito   | Registra um clique com o botão direito                  |
| Pegar valor      | Captura o valor atual do elemento (ex: texto, conteúdo) |
| Trocar de Aba    | Registra a troca de aba do navegador                    |
| Navegar para URL | Registra a navegação para outra URL                     |

<p align="center"><img src="/files/WGS3XSnsnpQYJDRV4G95" alt=""></p>

<p align="center"> Menu de contexto do gravador com as ações disponíveis</p>

#### Passo 5 — Confirmar a ação capturada

Após selecionar a ação, o painel de confirmação abrirá à direita com os dados capturados:

* **Título para relembrar a ação** — nome descritivo da ação (ex: `Escrever`)
* **TagName** — tag HTML do elemento (ex: `p`, `input`)
* **Ação** — ação escolhida no passo anterior
* **XPath** — caminho completo do elemento na página
* **Digite** — (somente para ação **Escrever**) texto que será digitado quando a rotina rodar

Clique em **Confirmar** para registrar a ação na rotina ou **Cancelar** para descartar.

<p align="center"><img src="/files/LabLDuBFupFHIYbnbgvZ" alt=""></p>

<p align="center"> Painel de confirmação com XPath, TagName, ação e campo de texto</p>

#### Passo 6 — Repetir para os demais elementos

Continue navegando e repetindo o processo para cada elemento necessário.

#### Passo 7 — Encerrar a gravação

Quando terminar, clique no botão **■ (Parar)** nos controles do gravador. Para interromper temporariamente sem encerrar, use **|| (Pausar)**.

#### Passo 8 — Verificar o componente gerado no Genesis

Cada ação confirmada gera um componente na rotina já pré-configurado. O exemplo abaixo mostra o componente **Escrever \[Gravador]** gerado a partir da ação **Escrever**:

* **Nome Identificador do Componente:** `recordSearchElement10001` (gerado automaticamente)
* **Forma de Busca:** `XPath`
* **Valor de busca:** XPath capturado (ex: `/html[1]/body[1]/div[5]/div[1]/div[1]/div[1]/div[1]/p[1]`)
* **Tempo máximo de espera (em segundos):** `60`
* **Parar execução caso algo dê errado na busca do elemento:** marcado
* **Tipo da ação:** `Digitar`
* **Texto:** valor digitado no campo **Digite** do passo 5
* **Limpar Campo:** marcado

<p align="center"><img src="/files/eDyF9BrY5zuHLxIVBalG" alt=""> </p>

<p align="center">Componente <strong>Escrever [Gravador]</strong> gerado automaticamente na rotina</p>

> ⚠️ Após a geração, o campo **Automação Web** aparece em vermelho — é necessário vinculá-lo ao componente **Abrir Navegador** correspondente antes de executar a rotina.

***

### Campos e opções

#### Modal Configurar gravador WEB

| Campo                                | Descrição                                   | Valores aceitos              |
| ------------------------------------ | ------------------------------------------- | ---------------------------- |
| Digite a URL para iniciar a gravação | URL da página que será gravada              | URL válida                   |
| Selecione a versão do Chrome         | Versão do Chrome que será usada na gravação | Versão disponível na máquina |

#### Painel de confirmação de ação

| Campo                                  | Descrição                                                   | Valores aceitos |
| -------------------------------------- | ----------------------------------------------------------- | --------------- |
| Digite um título para relembrar a ação | Nome descritivo da ação                                     | Texto           |
| TagName                                | Tag HTML do elemento capturado (preenchido automaticamente) | Somente leitura |
| Ação                                   | Ação escolhida no menu de contexto                          | Somente leitura |
| XPath                                  | Caminho XPath do elemento (preenchido automaticamente)      | Somente leitura |
| Digite                                 | Texto que será digitado (somente para ação **Escrever**)    | Texto           |

#### Componente gerado na rotina

| Campo                                                   | Descrição                                                  | Valores aceitos                  |
| ------------------------------------------------------- | ---------------------------------------------------------- | -------------------------------- |
| Automação Web                                           | Vincula o componente ao **Abrir Navegador** correspondente | Identificador do Abrir Navegador |
| Forma de Busca                                          | Estratégia de localização (já vem como `XPath`)            | XPath, Nome, ID, etc.            |
| Valor de busca                                          | XPath capturado pelo gravador                              | Texto (XPath)                    |
| Tempo máximo de espera (em segundos)                    | Tempo limite para localizar o elemento                     | Número inteiro                   |
| Parar execução caso algo dê errado na busca do elemento | Interrompe a rotina se o elemento não for encontrado       | Marcado / Desmarcado             |
| Tipo da ação                                            | Ação configurada pelo gravador                             | Digitar, Clicar, etc.            |
| Texto                                                   | Texto que será digitado (quando aplicável)                 | Texto                            |
| Campo Senha                                             | Marca o campo como sensível (oculta o valor)               | Marcado / Desmarcado             |
| Limpar Campo                                            | Limpa o conteúdo do campo antes de digitar                 | Marcado / Desmarcado             |

***

### Observações e dicas

* 💡 Use o **Gravador Web** quando quiser mapear rapidamente vários elementos de uma página — os componentes são criados prontos na rotina, com XPath e ação já configurados.
* 💡 Por padrão, o gravador usa a **versão mais recente do Chrome** disponível. Só altere se precisar testar compatibilidade com uma versão específica.
* 💡 Após gerar os componentes, revise o campo **Título** de cada um para nomes mais descritivos — isso facilita a manutenção da rotina.
* ⚠️ O campo **Automação Web** do componente gerado fica **vazio (em vermelho)** por padrão. É obrigatório vinculá-lo a um **Abrir Navegador** existente antes de executar a rotina.
* ⚠️ Use **|| (Pausar)** quando precisar interagir com a página sem registrar ações (ex: preencher login). Retome a gravação depois.
* ⚠️ O Gravador Web captura **apenas elementos de páginas web**. Para aplicações desktop, use o **Gravador Windows**.
