Ações de automação do navegador

As ações de automação do navegador permitem que os usuários interajam com aplicativos e componentes Web por meio de elementos da IU. Os elementos da interface do usuário da Web, também chamados de elementos da Web, descrevem exclusivamente os componentes da Web que a ação vai manipular.

Para executar a automação da Web, primeiro você precisa criar uma nova instância do navegador. Você pode conseguir isso usando as ações Iniciar Navegador, que oferecem suporte ao Microsoft Edge Google Chrome, Mozilla Firefox e Internet Explorer. Com as ações Iniciar Navegador, você também pode especificar se a página da Web deve ser iniciada na área de trabalho local ou em um ambiente de área de trabalho virtual.

Observação

Para iniciar um navegador em uma área de trabalho virtual, primeiro capture pelo menos um elemento da interface do usuário nessa área de trabalho. Esse elemento precisa estar disponível no repositório de elementos da interface do usuário do seu fluxo.

Para adicionar um novo elemento da Interface do Usuário, selecione Adicionar elemento de Interface do Usuário por meio da ação de automação do navegador implantado ou do painel elementos da Interface do usuário do designer de fluxo.

Captura de tela das opções para criar um novo elemento de interface do usuário.

Todos os elementos da interface do usuário relacionados à Web são especificados por um ou mais seletores do CSS, seletores da Web que indicam a estrutura hierárquica do componente na página. Os seletores usam a notação > para indicar que cada elemento está contido no elemento à sua esquerda.

Embora os seletores da Web sejam criados automaticamente, ao adicionar elementos de interface do usuário, alguns cenários específicos precisam de seletores criados manualmente. Quando um seletor da Web personalizado é necessário, você pode criar seu próprio editar o seletor existente ou criando um do zero.

Captura de tela das opções para editar e criar seletores.

Para desenvolver fluxos da Web mais dinâmicos, substitua os operadores Igual a por outros operadores ou expressões regulares. Além disso, caso o valor do atributo de um seletor da Web dependa de cálculos dos resultados de ações anteriores, use variáveis em vez do valor embutido em código.

Captura de tela dos operadores disponíveis no construtor do seletor.

Observação

Para encontrar mais informações sobre o desenvolvimento de fluxos da Web e a criação de seletores personalizados da Web para elementos da Web vá para Automatizar fluxos da Web e Criar um seletor personalizado.

Extrair dados de página da Web

Extraia dados de partes específicas de uma página da Web na forma de valores únicos, listas, linhas ou tabelas.

Para obter mais informações sobre como usar esta ação, acesse Extração de dados da Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Elemento da interface do usuário Não Elemento da interface do usuário Selecione o elemento da interface do usuário na página da Web para extrair dados dele
Parâmetros de extração Não Tabela de dados Os parâmetros a serem usados ao extrair dados. Dependendo do modo de extração, este parâmetro aceita dados diferentes.
Máximo de páginas da Web a serem processadas Não Valor numérico O número máximo de páginas da Web a serem processadas
Enviar clique físico para a próxima página N/A Valor booliano False Especifique se o cursor do mouse deve ser movido fisicamente sobre a página, antes de clicar. Um clique físico é necessário para casos em que cliques emulados para a página não realizam a ação intencional no elemento. Como esta opção requer que a janela do navegador esteja focada, ela automaticamente a colocará em primeiro plano.
Seletor CSS da página Não Valor do texto O seletor CSS da página
Modo de extração N/A Indefinido, Valor único, Valores escolhidos manualmente, Lista, Tabela, Tabela HTML inteira Valor único Especificar o que extrair da página da Web
Usar paginação N/D Valor booliano Falso Especificar se a paginação deve ser usada
Obter todas as páginas da Web N/A Valor booliano False Especificar se você deseja obter todas as páginas da Web
Processar dados após extração N/A Valor booliano False Especifique se os dados extraídos devem ser processados para apresentá-los exatamente como exibidos na página da Web. O processamento de dados extraídos inclui a exibição das informações aninhadas em iframes e a filtragem por meio de elementos ocultos ou visíveis. Para conjuntos de dados maiores, ter essa opção habilitada não é recomendado, pois aumentará o tempo de extração.
Timeout Sim Valor numérico 60 Defina o tempo em segundos que você quer aguardar para a extração ser concluída antes que a ação falhe
Armazenar modo de dados N/A Variável, planilha do Excel Variável Especificar se os dados extraídos devem ser armazenados em uma variável ou uma planilha do Excel

Variáveis produzidas

Argumento Type Description
ExcelInstance Excel instance A instância do Excel com os dados extraídos. Use esta instância para manipular a planilha (ou salvá-la e fechá-la) usando as ações dedicadas do Excel.
DataFromWebPage Tabela de dados Os dados extraídos na forma de um único valor, lista, linha de dados ou tabela de dados.

Exceções

Exceção Description
Falha ao extrair dados Indica um problema ao extrair dados
Falha ao iniciar instância do Excel Indica um problema ao inicializar uma instância do Excel
Falha ao gravar valores no Excel Indica um problema ao gravar os valores no Excel

Obter detalhes da página da Web

Obter uma propriedade de uma página da Web, como o título ou o texto de origem.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Get N/D Descrição da página da Web, meta palavras-chave da página da Web, título da página da Web, texto da página da Web, fonte da página da Web, endereço de URL atual do navegador da Web Descrição de página da Web Selecione as informações a serem recuperadas da página da Web

Variáveis produzidas

Argumento Type Description
WebPageProperty Valor do texto Os detalhes recuperados da página da Web

Exceções

Exceção Descrição
Falha ao obter detalhes da página da Web Indica um problema ao obter os detalhes da página da Web especificada

Obter detalhes do elemento na página da Web

Obter o valor do atributo de um elemento em uma página da Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Elemento da interface do usuário Não Elemento da interface do usuário Selecione o elemento da interface do usuário na página da Web para obter seus detalhes
Nome do atributo Não Valor do texto Próprio Texto Inserir ou selecionar o atributo cujo valor deve ser recuperado

Variáveis produzidas

Argumento Type Description
AttributeValue Valor do texto O valor do atributo do elemento da Web

Exceções

Exceção Descrição
Falha ao recuperar o atributo do elemento de interface do usuário na página da Web Indica um problema ao recuperar atributo do elemento da página da Web

Tirar captura de tela da página da Web

Obtenha uma captura de tela da página da Web (ou de um elemento da página da Web) exibido no navegador e salve a imagem em um arquivo ou na área de transferência.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Capturar N/D Página da Web inteira, elemento específico Página da Web inteira Especifique se você deseja capturar toda a página da Web ou apenas um elemento específico dela
Elemento da interface do usuário Não Elemento da interface do usuário Selecione o elemento da interface do usuário na página da Web para capturar
Modo de salvamento N/D Área de transferência, Arquivo Área de transferência Especificar se deseja salvar a imagem em um arquivo ou armazená-la na área de transferência
Arquivo de imagem Não Arquivo Definir o caminho completo do arquivo para salvar a captura de imagem
Formato do arquivo N/D BMP, EMF, EXIF, GIF, JPG, PNG, TIFF, WMF BMP Selecione o formato do arquivo de imagem

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Element with specified CSS selector not found Indica que um elemento de página da Web com o seletor CSS especificado não foi encontrado
Falha ao salvar arquivo Indica um problema ao salvar o arquivo especificado
Falha ao salvar na área de transferência Indica um problema ao salvar na área de transferência
Falha ao tirar a captura de tela Indica um problema ao tirar uma captura de tela

Focar campo de texto na página da Web

Defina o foco em um elemento de entrada de uma página da Web e role-o até exibi-lo.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Elemento da interface do usuário Não Elemento da interface do usuário Selecione o elemento de interface do usuário a ser focado na página da Web
Aguarde o carregamento da página N/D Valor booliano Verdadeiro Especificar se deve aguardar que a nova página da Web carregue completamente antes de continuar
Tempo limite ao carregar a página da Web Não Valor numérico 60 Definir o tempo em segundos para a página ser carregada antes que a ação gere um erro
Se uma caixa de diálogo pop-up aparecer N/D Fechar, Pressionar um botão, Não fazer nada Não faça nada Especificar o que fazer se uma caixa de diálogo pop-up aparecer
Botão de diálogo a pressionar Sim Valor do texto OK Insira o botão de diálogo para pressionar se uma caixa de diálogo pop-up aparecer

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Element with specified CSS selector not found Indica que um elemento de página da Web com o seletor CSS especificado não foi encontrado
Falha ao definir o foco de entrada no campo de texto da página da Web Indica um problema ao definir o foco de entrada no campo de texto especificado da página da web

Preencher campo de texto na página da Web

Preencha um campo de texto em uma página da Web com o texto especificado.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Elemento da interface do usuário Não Elemento da interface do usuário Selecione o campo de texto a ser preenchido
Texto Não Entrada direta criptografada ou Valor do texto Insira o texto para preencher o campo de texto
Se o campo não estiver em branco Sim Substituir texto, acrescentar texto Substituir texto Especifique se o conteúdo existente deve ser substituído ou acrescentado.
Preencher texto usando teclas físicas N/A Valor booliano False Emule usando pressionamentos de tecla físicos ao preencher texto para elementos de campo de texto da interface do usuário. Os pressionamentos de tecla físicos são necessários para casos em que o preenchimento de texto emulado não executa a ação intencional no elemento. Como esta opção requer que a janela do navegador esteja focada, ela automaticamente a colocará em primeiro plano.
Simular digitação N/A Valor booliano Verdadeiro Especifique se o campo de texto será preenchido de uma só vez por meio da configuração simples do valor da caixa de texto, ou simule uma digitação de usuário ao enviar os caracteres um por um. O último método é mais lento, mas necessário em algumas páginas da Web complexas.
Desfocar caixa de texto após preenchê-la N/D Valor booliano Falso Escolha se deseja desfocar a caixa de texto logo após esta ação para preenchê-la com o texto especificado. No caso de extração de listas de preenchimento automático, este parâmetro deve ser definido como Falso.
Aguarde o carregamento da página N/A Valor booliano Verdadeiro Especificar se deve aguardar que a nova página da Web carregue completamente após preencher o campo de texto
Tempo limite ao carregar a página da Web Não Valor numérico 60 Definir o tempo em segundos para a página ser carregada antes que a ação gere um erro
Se uma caixa de diálogo pop-up aparecer N/D Fechar, Pressionar um botão, Não fazer nada Não faça nada Especificar o que fazer se uma caixa de diálogo pop-up aparecer após preencher o campo de texto
Botão de diálogo a pressionar Sim Valor do texto OK Insira o botão de diálogo para pressionar se uma caixa de diálogo pop-up aparecer

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Element with specified CSS selector not found Indica que um elemento de página da Web com o seletor CSS especificado não foi encontrado
Falha ao gravar no campo de texto Indica um problema ao gravar no campo de texto especificado

Definir estado da caixa de seleção na página da Web

Marque ou desmarque uma caixa de seleção em um formulário da Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Elemento da interface do usuário Não Elemento da interface do usuário Marque a caixa de seleção para definir o estado de
Estado da caixa de seleção N/D Marcada, Desmarcada Marcado Marque o estado da caixa de seleção
Aguarde o carregamento da página N/D Valor booliano Verdadeiro Especificar se deve aguardar que a nova página da Web carregue completamente após definir o estado da caixa de seleção
Tempo limite ao carregar a página da Web Não Valor numérico 60 Definir o tempo em segundos para a página ser carregada antes que a ação gere um erro
Se uma caixa de diálogo pop-up aparecer N/D Fechar, Pressionar um botão, Não fazer nada Não faça nada Especificar o que fazer se uma caixa de diálogo pop-up aparecer após definir o estado da caixa de seleção
Botão de diálogo a pressionar Sim Valor do texto OK Insira o botão de diálogo para pressionar se uma caixa de diálogo pop-up aparecer

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Element with specified CSS selector not found Indica que um elemento de página da Web com o seletor CSS especificado não foi encontrado
Falha ao definir o estado da caixa de seleção Indica um problema ao definir o estado da caixa de seleção especificada

Selecionar botão de opção na página da Web

Selecione um botão de opção na página da Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Elemento da interface do usuário Não Elemento da interface do usuário O botão de opção a ser selecionado
Aguarde o carregamento da página N/D Valor booliano Verdadeiro Especificar se deve aguardar que a nova página da Web carregue completamente após selecionar o botão de opção
Tempo limite ao carregar a página da Web Não Valor numérico 60 Definir o tempo em segundos para a página ser carregada antes que a ação gere um erro
Se uma caixa de diálogo pop-up aparecer N/D Fechar, Pressionar um botão, Não fazer nada Não faça nada Especificar o que fazer se uma caixa de diálogo pop-up aparecer após selecionar o botão de opção
Botão de diálogo a pressionar Sim Valor do texto OK O botão de diálogo para pressionar se uma caixa de diálogo pop-up aparecer

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Element with specified CSS selector not found Indica que um elemento de página da Web com o seletor CSS especificado não foi encontrado
Falha ao selecionar o botão de opção Indica um problema ao selecionar o botão de opção especificado

Definir valor de lista suspensa em página da Web

Definir ou limpar as opções selecionadas de uma lista suspensa em um formulário da Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Elemento da interface do usuário Não Elemento da interface do usuário Selecione a lista suspensa para definir seu valor
Operação N/D Limpar todas as opções, Selecionar opções por nome, Selecionar opções por índice Limpar todas as opções Indicar se deve selecionar um valor ou limpar o valor selecionado da lista suspensa
Nomes da opção Não Lista de Valores do texto Insira uma opção ou uma lista de opções a serem selecionadas na lista suspensa. Múltiplas opções só fazem sentido ao trabalhar com listas de seleção múltipla. Se a lista for de seleção única, apenas a primeira opção da lista especificada será usada.
Usar expressões regulares N/A Valor booliano Falso Especifique se os valores de nomes de opção devem ser interpretados como uma expressão regular
Índices de opção Não Lista de Valores numéricos Insira um índice ou uma lista de índices a serem selecionados na lista suspensa. Múltiplas opções só fazem sentido ao trabalhar com listas de seleção múltipla. Se a lista for de seleção única, apenas a primeira opção da lista especificada será usada.
Aguarde o carregamento da página N/A Valor booliano Verdadeiro Especificar se deve aguardar que a nova página da Web carregue completamente após definir o valor da lista suspensa
Tempo limite ao carregar a página da Web Não Valor numérico 60 Definir o tempo em segundos para a página ser carregada antes que a ação gere um erro
Se uma caixa de diálogo pop-up aparecer N/D Fechar, Pressionar um botão, Não fazer nada Não faça nada Especificar o que fazer se uma caixa de diálogo pop-up aparecer após definir o valor da lista suspensa
Dialog button to press Sim Valor do texto OK Insira o botão de diálogo para pressionar se uma caixa de diálogo pop-up aparecer

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Element with specified CSS selector not found Indica que um elemento de página da Web com o seletor CSS especificado não foi encontrado
Failed to set the selected option Indica um problema ao definir a opção de lista suspensa selecionada

Pressionar botão na página da Web

Pressione um botão na página da Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Elemento da interface do usuário Não Elemento da interface do usuário Selecione o botão para pressionar
Aguarde o carregamento da página N/D Valor booliano Verdadeiro Especificar se deve aguardar que a nova página da Web carregue completamente após pressionar o botão
Tempo limite ao carregar a página da Web Não Valor numérico 60 Definir o tempo em segundos para a página ser carregada antes que a ação gere um erro
Se uma caixa de diálogo pop-up aparecer N/D Fechar, Pressionar um botão, Não fazer nada Não faça nada Especificar o que fazer se uma caixa de diálogo pop-up aparecer após pressionar o botão
Dialog button to press Sim Valor do texto OK Insira o botão de diálogo para pressionar se uma caixa de diálogo pop-up aparecer

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Element with specified CSS selector not found Indica que um elemento de página da Web com o seletor CSS especificado não foi encontrado
Failed to click on web page button Indica um problema ao clicar no botão da página da Web especificada

Se a página da Web contiver

Marca o início de um bloco de ações condicional, dependendo se um texto ou elemento específico existe em uma página da Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Check if web page N/D Contém elemento, Não contém elemento, Contém texto, Não contém texto Contém elemento Verifique se existe um texto ou elemento de página da Web específico em uma página da Web
Elemento da interface do usuário Não Elemento da interface do usuário Selecione o elemento da interface do usuário na página da Web para verificar
Texto Não Valor do texto Inserir o texto na página da Web para verificar

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Failed to communicate with the browser Indica que ocorreu um erro com o navegador

Aguardar conteúdo da página da Web

Suspenda o fluxo até que uma parte específica do texto ou elemento da página da Web apareça ou desapareça em uma página da Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Wait for web page to N/D Contém elemento, Não contém elemento, Contém texto, Não contém texto Conter elemento Especifique se um texto ou elemento de página da Web deve ser aguardado para aparecer ou desaparecer em uma página da Web
Elemento da interface do usuário Não Elemento da interface do usuário Selecione o elemento da interface do usuário na página da Web para verificar
Texto Não Valor do texto Inserir o texto na página da Web para verificar

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Wait for web page content failed Indica falha na operação de espera

Iniciar novo Internet Explorer

Inicie uma nova instância ou anexe a uma instância do Internet Explorer em execução para automatizar sites e aplicativos Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Launch mode N/D Abrir navegador de automação, Abrir novo Internet Explorer, Anexar à execução do Internet Explorer Iniciar navegador de automação Especificar se o navegador de automação ou uma nova instância do Internet Explorer deve ser iniciada ou anexada a uma existente
Attach to Internet Explorer tab N/D Por título, Por URL, Usar janela em primeiro plano Por título Especificar se deve ser anexada a uma guia Internet Explorer por título, URL ou à guia ativa de Internet Explorer em execução como janela de primeiro plano
Initial URL Não Valor do texto Inserir a URL do site a ser visitado quando o navegador da Web for iniciado
Tab title Não Valor do texto Inserir o título (ou parte dele) da guia Internet Explorer para anexar
Tab URL Não Valor do texto Insira a URL (ou parte dela) da guia Internet Explorer para anexar
Window state N/D Normal, Maximizado, Minimizado Normal Especificar se a janela do navegador deve ser iniciada em estado normal, minimizado ou maximizado
Área de trabalho de destino N/A Computador local, qualquer área de trabalho virtual que esteja conectada atualmente ou que tenha pelo menos um elemento de interface do usuário capturado Computador local Defina a cadeia de conexão da área de trabalho de destino que o navegador inicia
Clear cache N/A Valor booliano False Especificar se é para limpar todo o cache do navegador da Web logo após iniciá-lo
Clear cookies N/D Valor booliano False Especificar se é para limpar todos os cookies armazenados no navegador da Web logo após iniciá-lo
Wait for page to load N/D Valor booliano Verdadeiro Especificar se deve aguardar que a nova página da Web carregue completamente antes de continuar
Tempo limite ao carregar a página da Web Não Valor numérico 60 Definir o tempo em segundos para a página ser carregada antes que a ação gere um erro
Se uma caixa de diálogo pop-up aparecer N/D Fechar, Pressionar um botão, Não fazer nada Não faça nada Especificar o que fazer se uma caixa de diálogo pop-up aparecer ao carregar a página da Web inicial
Dialog button to press Sim Valor do texto OK Insira o botão de diálogo para pressionar se uma caixa de diálogo pop-up aparecer
Custom user agent string Sim Valor do texto Especifique a cadeia de caracteres do agente do usuário personalizado do auxiliar da Web em tempo de execução. Se esse campo permanecer vazio, o auxiliar da Web em tempo de execução usará, por padrão, a cadeia de caracteres de agente do usuário do Internet Explorer instalada no computador.

Observação

As opções Limpar cache e Limpar cookies somente funcionam conforme o esperado, se a execução no modo protegido estiver desativada no menu Opções da Internet.

Variáveis produzidas

Argumento Type Description
InternetExplorer Web browser instance A instância do Internet Explorer a ser usada com ações de automação do navegador

Exceções

Exceção Descrição
Failed to launch Internet Explorer Indica um problema ao iniciar o Internet Explorer
Invalid URL Indica que a URL fornecida era inválida

Iniciar novo Firefox

Inicie uma nova instância ou anexe a uma instância do Firefox em execução para automatizar sites e aplicativos Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Launch mode N/D Iniciar nova Instância, Anexar à instância em execução Iniciar nova instância Especificar se uma nova instância do Firefox deve ser iniciada ou anexada a uma existente
Attach to Firefox tab N/D Por título, Por URL, Usar janela em primeiro plano Por título Especificar se deve ser anexada a uma guia Firefox por título, URL ou à guia ativa de Firefox em execução como janela de primeiro plano
Initial URL Não Valor do texto Inserir a URL do site a ser visitado quando o navegador da Web for iniciado
Tab title Não Valor do texto Inserir o título (ou parte dele) da guia Firefox para anexar
Tab URL Não Valor do texto Insira a URL (ou parte dela) da guia Firefox para anexar
Window state N/D Normal, Maximizado, Minimizado Normal Especificar se a janela do navegador deve ser iniciada em estado normal, minimizado ou maximizado
Área de trabalho de destino N/A Computador local, qualquer área de trabalho virtual que esteja conectada atualmente ou que tenha pelo menos um elemento de interface do usuário capturado Computador local Defina a cadeia de conexão da área de trabalho de destino que o navegador inicia
Clear cache N/A Valor booliano False Especificar se é para limpar todo o cache do navegador da Web logo após iniciá-lo
Clear cookies N/D Valor booliano False Especificar se é para limpar todos os cookies armazenados no navegador da Web logo após iniciá-lo
Wait for page to load N/D Valor booliano Verdadeiro Especificar se deve aguardar que a nova página da Web carregue completamente antes de continuar
Tempo limite ao carregar a página da Web Não Valor numérico 60 Definir o tempo em segundos para a página ser carregada antes que a ação gere um erro
Se uma caixa de diálogo pop-up aparecer N/D Fechar, Pressionar um botão, Não fazer nada Não faça nada Especificar o que fazer se uma caixa de diálogo pop-up aparecer ao carregar a página da Web inicial
Dialog button to press Sim Valor do texto OK Insira o botão de diálogo para pressionar se uma caixa de diálogo pop-up aparecer
Timeout Não Valor numérico 60 Defina o tempo em segundos que você deseja aguardar pela inicialização do navegador antes de considerar que a ação falhou
Pasta de dados do usuário N/A Padrão Picture-in-Picture, padrão do navegador, Personalizado Padrão do Picture-in-Picture Especifique a pasta de dados do usuário que o navegador usa quando o fluxo é executado em Picture-in-Picture. Se a opção Padrão do navegador estiver selecionada, o navegador não poderá ser aberto no desktop e no Picture-in-Picture ao mesmo tempo. Saiba mais
Caminho da pasta de dados do usuário Não Pasta Especifique o caminho da pasta de dados do usuário que o navegador usa quando o fluxo é executado em Picture-in-Picture. Saiba mais

Variáveis produzidas

Argumento Type Description
Browser Web browser instance A instância do Firefox a ser usada com ações de automação do navegador

Exceções

Exceção Descrição
Falha ao iniciar o Firefox Indica um problema ao iniciar o Firefox
URL inválida Indica que a URL fornecida era inválida

Iniciar novo Chrome

Inicie uma nova instância ou anexe a uma instância do Chrome em execução para automatizar sites e aplicativos Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Launch mode N/D Iniciar nova Instância, Anexar à instância em execução Iniciar nova instância Especificar se uma nova instância do Chrome deve ser iniciada ou anexada a uma existente
Anexar à guia Chrome N/D Por título, Por URL, Usar janela em primeiro plano Por título Especificar se deve ser anexada a uma guia Chrome por título, URL ou à guia ativa de Chrome em execução como janela de primeiro plano
URL inicial Não Valor do texto Inserir a URL do site a ser visitado quando o navegador da Web for iniciado
Título da guia Não Valor do texto Insira o título (ou parte dele) da guia Chrome para anexar
URL da guia Não Valor do texto Insira a URL (ou parte dela) da guia Chrome para anexar
Estado da janela N/D Normal, Maximizado, Minimizado Normal Especificar se a janela do navegador deve ser iniciada em estado normal, minimizado ou maximizado
Área de trabalho de destino N/A Computador local, qualquer área de trabalho virtual que esteja conectada atualmente ou que tenha pelo menos um elemento de interface do usuário capturado Computador local Defina a cadeia de conexão da área de trabalho de destino que o navegador inicia
Clear cache N/A Valor booliano False Especificar se é para limpar todo o cache do navegador da Web logo após iniciá-lo
Clear cookies N/D Valor booliano False Especificar se é para limpar todos os cookies armazenados no navegador da Web logo após iniciá-lo
Wait for page to load N/D Valor booliano Verdadeiro Especificar se deve aguardar que a nova página da Web carregue completamente antes de continuar
Tempo limite ao carregar a página da Web Não Valor numérico 60 Definir o tempo em segundos para a página ser carregada antes que a ação gere um erro
Se uma caixa de diálogo pop-up aparecer N/D Fechar, Pressionar um botão, Não fazer nada Não faça nada Especificar o que fazer se uma caixa de diálogo pop-up aparecer ao carregar a página da Web inicial
Dialog button to press Sim Valor do texto OK Insira o botão de diálogo para pressionar se uma caixa de diálogo pop-up aparecer
Timeout Não Valor numérico 60 Defina o tempo em segundos que você deseja esperar até que o navegador seja aberto antes que a ação falhe
Pasta de dados do usuário N/A Padrão Picture-in-Picture, padrão do navegador, Personalizado Padrão do Picture-in-Picture Especifique a pasta de dados do usuário que o navegador usa quando o fluxo é executado em Picture-in-Picture. Se a opção Padrão do navegador estiver selecionada, o navegador não poderá ser aberto no desktop e no Picture-in-Picture ao mesmo tempo. Saiba mais
Caminho da pasta de dados do usuário Não Pasta Especifique o caminho da pasta de dados do usuário que o navegador usará quando o fluxo for executado no Picture-in-Picture. Saiba mais

Variáveis produzidas

Argumento Type Description
Browser Web browser instance A instância do Chrome a ser usada com ações de automação do navegador

Exceções

Exceção Descrição
Failed to launch Chrome Indica um problema ao iniciar o Chrome
URL inválida Indica que a URL fornecida era inválida

Iniciar novo Microsoft Edge

Inicie uma nova instância ou anexe a uma instância do Microsoft Edge em execução para automatizar sites e aplicativos Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Launch mode N/D Iniciar nova Instância, Anexar à instância em execução Iniciar nova instância Especificar se uma nova instância do Microsoft Edge deve ser iniciada ou anexada a uma existente
Attach to Microsoft Edge tab N/D Por título, Por URL, Usar janela em primeiro plano Por título Especificar se deve ser anexada a uma guia Microsoft Edge por título, URL ou à guia ativa de Microsoft Edge em execução como janela de primeiro plano
Initial URL Não Valor do texto Inserir a URL do site a ser visitado quando o navegador da Web for iniciado
Tab title Não Valor do texto Inserir o título (ou parte dele) da guia Microsoft Edge para anexar
Tab URL Não Valor do texto Insira a URL (ou parte dela) da guia Microsoft Edge para anexar
Window state N/D Normal, Maximizado, Minimizado Normal Especificar se a janela do navegador deve ser iniciada em estado normal, minimizado ou maximizado
Área de trabalho de destino N/A Computador local, qualquer área de trabalho virtual que esteja conectada atualmente ou que tenha pelo menos um elemento de interface do usuário capturado Computador local Defina a cadeia de conexão da área de trabalho de destino que o navegador inicia
Clear cache N/A Valor booliano False Especificar se é para limpar todo o cache do navegador da Web logo após iniciá-lo
Clear cookies N/D Valor booliano False Especificar se é para limpar todos os cookies armazenados no navegador da Web logo após iniciá-lo
Wait for page to load N/D Valor booliano Verdadeiro Especificar se deve aguardar que a nova página da Web carregue completamente antes de continuar
Tempo limite ao carregar a página da Web Não Valor numérico 60 Definir o tempo em segundos para a página ser carregada antes que a ação gere um erro
Se uma caixa de diálogo pop-up aparecer N/D Fechar, Pressionar um botão, Não fazer nada Não faça nada Especificar o que fazer se uma caixa de diálogo pop-up aparecer ao carregar a página da Web inicial
Dialog button to press Sim Valor do texto OK Insira o botão de diálogo para pressionar se uma caixa de diálogo pop-up aparecer
Timeout Não Valor numérico 60 Defina o tempo em segundos que você deseja aguardar pela inicialização do navegador antes de considerar que a ação falhou
Pasta de dados do usuário N/A Padrão Picture-in-Picture, padrão do navegador, Personalizado Padrão do Picture-in-Picture Especifique a pasta de dados do usuário que o navegador usa quando o fluxo é executado em Picture-in-Picture. Se a opção Padrão do navegador estiver selecionada, o navegador não poderá ser aberto no desktop e no Picture-in-Picture ao mesmo tempo. Saiba mais
Caminho da pasta de dados do usuário Não Pasta Especifique o caminho da pasta de dados do usuário que o navegador usa quando o fluxo é executado em Picture-in-Picture. Saiba mais

Variáveis produzidas

Argumento Type Description
Browser Web browser instance A instância do Microsoft Edge a ser usada com ações de automação do navegador

Exceções

Exceção Descrição
Falha ao iniciar o Microsoft Edge Indica um problema ao iniciar o Microsoft Edge
URL inválida Indica que a URL fornecida era inválida

Criar nova guia

Criar uma guia e navegar até a URL fornecida (com suporte no Microsoft Edge, Chrome e Firefox).

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
URL to navigate to Não Valor do texto Insira a URL ou uma variável que contém a URL. para navegar até
Wait for page to load N/D Valor booliano Verdadeiro Especificar se deve aguardar que a nova página da Web carregue completamente antes de continuar
Tempo limite ao carregar a página da Web Não Valor numérico 60 Definir o tempo em segundos para a página ser carregada antes que a ação gere um erro
Se uma caixa de diálogo pop-up aparecer N/D Fechar, Pressionar um botão, Não fazer nada Não faça nada Especificar o que fazer se uma caixa de diálogo pop-up aparecer ao carregar a página da Web
Dialog button to press Sim Valor do texto OK Insira o botão de diálogo para pressionar se uma caixa de diálogo pop-up aparecer

Variáveis produzidas

Argumento Type Description
NewBrowser Web browser instance A nova instância do navegador da Web a ser usada com ações de automação do navegador

Exceções

Exceção Description
Invalid URL Indica que a URL fornecida era inválida
Failed to create a new tab Indica um problema ao criar uma nova guia

Acessar página da Web

Navegue no navegador da Web para uma nova página.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Navigate N/D Para URL, Voltar, Avançar, Recarregar página da Web Para URL Especificar para onde navegar
URL Não Valor do texto Inserir a URL até onde navegar
Wait for page to load N/D Valor booliano Verdadeiro Especificar se deve aguardar que a página da Web carregue completamente antes de continuar
Tempo limite ao carregar a página da Web Não Valor numérico 60 Definir o tempo em segundos para a página ser carregada antes que a ação gere um erro
Se uma caixa de diálogo pop-up aparecer N/D Fechar, Pressionar um botão, Não fazer nada Não faça nada Especificar o que fazer se uma caixa de diálogo pop-up aparecer ao carregar a página da Web
Dialog button to press Sim Valor do texto OK Insira o botão de diálogo para pressionar se uma caixa de diálogo pop-up aparecer

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Failed to navigate to web page Indica um problema ao navegar para a página da Web especificada
Invalid URL Indica que a URL fornecida era inválida

Clicar no link na página da Web

Clique em um link ou qualquer outro elemento de uma página da Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Elemento da interface do usuário Não Elemento da interface do usuário Selecione o elemento da interface do usuário na página da Web para clicar
Tipo de clique N/D Clique com o botão esquerdo, clique com o botão direito, clique duplo, botão esquerdo para baixo, botão esquerdo para cima, botão direito para baixo, botão direito para cima, clique com o botão do meio Clique com o botão esquerdo do mouse O tipo de clique a ser executado
Enviar clique físico N/D Valor booliano Falso Especifique se o cursor do mouse deve ser movido fisicamente sobre o elemento antes de clicar. Um clique físico é necessário para casos em que cliques emulados não realizam a ação intencional no elemento. Como esta opção requer que a janela do navegador esteja focada, ela automaticamente a colocará em primeiro plano.
Aguarde o carregamento da página N/A Valor booliano Verdadeiro Especificar se deve aguardar que a nova página da Web seja carregada completamente após clicar no link
Tempo limite ao carregar a página da Web Não Valor numérico 60 Definir o tempo em segundos para a página ser carregada antes que a ação gere um erro
Se uma caixa de diálogo pop-up aparecer N/D Fechar, Pressionar um botão, Não fazer nada Não faça nada Especificar o que fazer se uma caixa de diálogo pop-up aparecer após clicar no link
Botão de diálogo a pressionar Sim Valor do texto OK Insira o botão de diálogo para pressionar se uma caixa de diálogo pop-up aparecer

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Element with specified CSS selector not found Indica que um elemento de página da Web com o seletor CSS especificado não foi encontrado
Failed to click UI element Indica um problema ao clicar no elemento especificado

Clique em um link em uma página da Web que resulte no download de um arquivo.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Elemento da interface do usuário Não Elemento da interface do usuário Selecione o elemento da interface do usuário na página da Web para clicar
Pasta de destino Não Pasta Inserir ou escolher o caminho completo da pasta ou uma variável que contenha a pasta para salvar o arquivo baixado

Variáveis produzidas

Argumento Type Description
DownloadedFile Arquivo O arquivo no disco onde o download foi salvo. Este valor é um caminho do arquivo que consiste na pasta de download, conforme especificado acima, mais o nome do arquivo fornecido pelo servidor Web.
Exceção Descrição
Failed to download file Indica um problema ao baixar o arquivo especificado
Element with specified CSS selector not found Indica que um elemento de página da Web com o seletor CSS especificado não foi encontrado
Failed to click UI element Indica um problema ao clicar no elemento especificado
Failed to save file Indica um problema ao salvar o arquivo especificado

Executar a função JavaScript na página da Web

Execute uma função JavaScript na página da Web e obter o resultado retornado.

Observação

A migração para as extensões do navegador Manifest V3 afeta esta ação. Para encontrar mais informações sobre o Manifest V3 e como ele afeta a ação Executar função JavaScript na página da Web, acesse Migração para o Manifest V3.

Parâmetros de entrada
Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
JavaScript function Sim Valor do texto função ExecuteScript() { /*seu código aqui, retorna algo (opcionalmente); */ } Inserir a função JavaScript para executar na página da Web

Variáveis produzidas

Argumento Type Description
Result Valor do texto O resultado da função JavaScript que executou

Exceções

Exceção Description
Failed to run JavaScript Indica um problema ao executar JavaScript

Passe o mouse sobre um elemento na página da Web

Passe o mouse sobre um elemento de uma página da Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web com a qual trabalhar
Elemento da interface do usuário No Elemento da interface do usuário Selecione o elemento de interface do usuário a ser focado na página da Web
Mover o mouse para focalizar No Valor booliano False Especifique se o cursor do mouse deve ser movido fisicamente sobre o elemento para passar o mouse sobre o elemento da IU. Uma passagem física do mouse é necessária para os casos em que a passagem do mouse emulada não executa a ação intencional no elemento. Como esta opção requer que a janela do navegador esteja focada, ela automaticamente a coloca em primeiro plano.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Failed to hover over element Indica um problema ao passar o mouse sobre o elemento especificado

Fechar navegador da Web

Feche uma janela do navegador da Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Web browser instance Não Instância de navegador da Web Insira ou escolha a variável que contém a instância do navegador da Web para fechar

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Failed to close the web browser Indica um problema ao fechar o navegador da Web