Entrar em um iFrame

Visão Geral

O iFrame é uma tag ou etiqueta em um documento HTML que viabiliza a inclusão de outro documento HTML dentro do primeiro. Em outras palavras, ele permite que, a partir de uma página inicial, seja possível abrir uma seção de outra página qualquer.

O objeto Entrar em um iFrame permite que o robô acesse um iframe presente em uma página da Web carregada no navegador. Um iframe é uma tag HTML que incorpora outro documento HTML dentro da página atual, permitindo interações ou extrações que estão isoladas do documento principal.

Funcionamento

Esse objeto navega para dentro de um iframe especificado pelo XPath, permitindo que objetos subsequentes realizem ações ou extrações dentro desse contexto de iframe.

Quando usar

Quando a automação precisa interagir com elementos dentro de um iframe de uma página Web.
Quando é necessário extrair dados que estão dentro de um iframe na página.

Quando não usar

Não é necessário utilizar este objeto para páginas que não possuem iframe. (Não documentado explicitamente, mas inferido pelo comportamento padrão.)

Configuração

CAMPO

DESCRITIVO

Título

Nome que identifica o objeto no robô. Pode ser editado para facilitar a leitura.

Nome Identificador do Objeto

Identificador único do objeto para referência interna no robô.

Selecionar componente do tipo Automação Web

Selecionar o objeto Abrir Navegador como o principal.

Forma de Busca

Método de localização do iframe (ex: XPath).

Valor de Busca

XPath que localiza o elemento <iframe> na página.

Tempo máximo de espera (em segundos)

Tempo limite para localizar o iframe antes de erro.

Retornos

Esse objeto não retorna valores diretos (somente altera o contexto de execução para dentro do iframe).

Erros comuns e como evitar

Erro ao localizar o iframe: Verifique se o XPath está correto e se o iframe realmente existe no DOM.
Execução parada por timeout: Ajuste o “Tempo máximo de espera” se a página demorar a carregar.

Boas práticas

Sempre nomeie o objeto para refletir o iframe em que ele atua (ex: “Entrar iFrame Formulário”).
Certifique-se de voltar ao contexto principal depois de ações no iframe, usando o objeto Voltar para o Frame Principal, se necessário.