# Obter Elemento Xpath WEB ### Visão Geral XPath é uma linguagem de consulta que permite navegar entre os elementos de um documento estruturado, como XML ou HTML. No Genesis, o XPath é usado pelo componente **Buscar Elementos** para localizar e interagir com elementos de páginas web durante automações.

Componente Buscar Elementos configurado com Forma de Busca XPath e o valor do XPath preenchido

*** ### Pré-requisitos * Componente **Abrir Navegador** já configurado e vinculado ao **Buscar Elementos** * Acesso à página web que contém o elemento a ser localizado *** ### Identificando o formato da página A maioria das páginas criadas nos navegadores utiliza a estrutura HTML. Para confirmar que a página é HTML e garantir que o XPath funcionará: #### Passo 1 — Abrir a ferramenta de desenvolvedor (DevTools) Na página do navegador, clique com o **botão direito** em qualquer área e selecione **Inspecionar** (ou **Inspecionar Elemento**). > 💡 Cada navegador tem um atalho diferente para abrir o DevTools — clicar com o botão direito e selecionar **Inspecionar** é o método que funciona em todos. #### Passo 2 — Verificar a declaração DOCTYPE No topo do código exibido, deve aparecer a tag ``. Essa declaração indica que a página é do tipo HTML e, portanto, compatível com busca por XPath. *** ### Formas de busca disponíveis O componente **Buscar Elementos** aceita diferentes formas de localizar um elemento: | Forma de busca | Descrição | | -------------- | --------------------------------------------------------------------- | | XPath | Caminho completo do elemento na árvore do documento (**recomendado**) | | Nome | Valor do atributo `name` do elemento | | ID | Valor do atributo `id` do elemento | | Nome da Classe | Valor do atributo `class` | | Seletor CSS | Seletor no padrão CSS | | Contém Path | Busca por correspondência parcial do caminho | > 💡 **Recomendação:** use **XPath** sempre que possível — é a forma mais precisa e estável para automações. **Exemplo de XPath:**/html/body/div\[2]/div\[4]/form/div\[1]/div/div\[3]/center/input\[2]
### Como usar — Exemplo prático **Objetivo:** abrir o Google e clicar no botão **"Estou com Sorte"**. **Componentes utilizados:** * **Abrir Navegador** — abre um navegador e acessa a URL do Google * **Buscar Elementos** — localiza o botão via XPath e executa uma ação * **Aguardar** — dá tempo entre ações * **Fechar Navegador** — encerra o navegador ao final do processo

Fluxo completo da rotina com os quatro componentes em sequência

#### Passo 1 — Configurar **Abrir Navegador** Adicione o componente **Abrir Navegador** e preencha: * **Selecionar um navegador:** Chrome * **Selecione a versão do navegador:** versão instalada (ex: `109.0.5414`) * **Endereço da página:** `https://www.google.com.br/index.html` * **Verificar se url está disponível:** marcado * **Tempo de espera:** `60`

Configuração do componente Abrir Navegador

#### Passo 2 — Configurar **Buscar Elementos** com o XPath e ação CLICAR Adicione o componente **Buscar Elementos** logo após o **Abrir Navegador** e preencha: * **Automação Web:** selecione o identificador do **Abrir Navegador** (ex: `browseOpen1874`) * **Forma de Busca:** `XPath` * **Valor de busca:** cole o XPath do botão copiado via DevTools * **Tempo máximo de espera (em segundos):** `60` * **Tipo da ação:** escolha a ação desejada (ex: `Clicar`)

Configuração do componente Buscar Elementos com XPath

#### Passo 3 — Configurar **Aguardar** e **Fechar Navegador** Adicione o componente **Aguardar** para dar tempo entre a ação e o encerramento: * **Tempo (em milissegundos):** `10`

Configuração do componente Aguardar

Em seguida, adicione **Fechar Navegador** e vincule ao mesmo identificador do **Abrir Navegador**: * **Selecionar componente do tipo Automação Web:** `browseOpen1874`

Configuração do componente Fechar Navegador

#### Passo 4 — Executar o robô Execute a rotina e observe se as ações ocorrem na ordem esperada: abertura do Google → clique no botão → espera → fechamento do navegador. *** ### Campos e opções — Buscar Elementos | Campo | Descrição | Valores aceitos | | ----------------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------- | | Título | Nome de exibição do componente | Texto | | Nome Identificador do Componente | ID único do componente na rotina | Texto (gerado automaticamente) | | Automação Web | Vincula este componente ao **Abrir Navegador** correspondente | Identificador do Abrir Navegador | | Tempo de espera antes de iniciar | Delay em milissegundos antes da execução | Número inteiro | | Tempo de espera após finalizar | Delay em milissegundos após a execução | Número inteiro | | Buscar apenas um / Buscar uma lista | Retorna um único elemento ou uma coleção | Toggle | | Forma de Busca | Estratégia de localização do elemento | XPath, Nome, ID, Nome da Classe, Seletor CSS, Contém Path | | Valor de busca | Valor correspondente à Forma de Busca escolhida | Texto | | Variável de texto do conteúdo do elemento | Armazena o texto do elemento em uma variável | Variável | | Tempo máximo de espera (em segundos) | Tempo limite para localizar o elemento | Número inteiro | | Tipo da ação | Ação a ser executada no elemento encontrado | Nenhuma ação, Clicar, Digitar, etc. | *** ### Observações e dicas * 💡 Use **XPath** sempre que possível — é a forma mais precisa de busca e menos propensa a falhas quando a página tem elementos dinâmicos. * 💡 Para copiar o XPath de um elemento: abra o **DevTools**, clique com botão direito no elemento no painel de código e selecione **Copy → Copy XPath** (ou **Copy full XPath**). * 💡 Sempre vincule o **Buscar Elementos** ao **Abrir Navegador** correto no campo **Automação Web** — sem esse vínculo o componente não sabe em qual navegador atuar. * ⚠️ XPaths absolutos (começando com `/html/body/...`) podem quebrar se a estrutura da página mudar. Para páginas mais voláteis, prefira XPaths relativos baseados em atributos estáveis. * ⚠️ Páginas sem a declaração `` podem ter comportamento inesperado na busca por XPath. ## Baixar o Robô {% file src="/files/JYzXp4QQBdBM9vchd5Zv" %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.roboteasy.tech/studio/geral/obter-elemento-xpath-web.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.