Partilhar via


Ações de automatização do browser

As ações de automatização do browser permitem que os utilizadores interajam com aplicações Web e componentes através de elementos de IU. Os elementos da IU Web, também chamados de elementos da Web, descrevem exclusivamente os componentes da Web a serem processados pela ação.

Para adicionar um novo elemento de IU, selecione Adicionar elemento de IU através da ação de automatização do browser implementada ou do painel Elementos de IU do estruturador de fluxos.

Captura de ecrã das opções para criar um novo elemento da IU.

Todos os elementos da IU relacionados com a Web são especificados por um ou mais seletores CSS — seletores Web — que identificam a estrutura hierárquica do componente na página. Os selecionadores utilizam a notação > para indicar que cada elemento está contido dentro do elemento à sua esquerda.

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

Captura de ecrã 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, se o valor do atributo de um seletor Web depender dos resultados de ações anteriores, utilize variáveis em vez de valores hard-coded.

Captura de ecrã dos operadores disponíveis no construtor de seletores.

Nota

Para encontrar mais informações sobre o desenvolvimento de fluxos da Web e criar seletores Web personalizados para elementos da Web, aceda a Automatizar fluxos da Web e Criar um seletor personalizado.

Extrair dados a partir de uma página Web

Extrair dados de partes específicas de uma página Web sob a forma de valores, listas, linhas ou tabelas individuais.

Para mais informações sobre como utilizar esta ação, aceda a Extração de dados Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Elemento da IU Não Elemento da IU Selecione o elemento da IU na página Web a partir do qual os dados devem ser extraídos
Parâmetros de extração Não Tabela de dados Os parâmetros a utilizar ao extrair dados. Consoante o modo de extração, este parâmetro aceita dados diferentes.
Max web pages to process Não Valor numérico O número máximo de páginas Web a processar
Enviar clique físico para a página seguinte N/A Valor booleano Falso Especifique se move fisicamente o cursor do rato sobre a página antes de clicar. É necessário um clique físico para os casos onde os cliques emulados na página não efetuam a ação intencional no elemento. Uma vez que esta opção requer que a janela do browser esteja focada, esta será automaticamente trazida para primeiro plano.
Seletor de CSS da página Não Valor de texto O seletor de CSS da página
Extraction mode N/A Não definido, Valor único, Valores selecionados manualmente, Lista, Tabela, Tabela HTML completa Valor único Especifique o que deve ser extraído a partir da página Web
Use paging N/D Valor booleano Falso Especifique se pretende utilizar paging
Get all web pages N/D Valor booleano Falso Especifique se pretende obter todas as páginas Web
Processar dados após a extração N/D Valor booleano Falso Especifique se devem ser processados dados extraídos para os apresentar exatamente como apresentados na página Web. O processamento de dados extraídos inclui a apresentação das informações aninhadas em iframes e a filtragem através de elementos ocultos ou visíveis. Para conjuntos de dados maiores, não é recomendado que esta opção seja ativada, pois irá aumentar o tempo de extração.
Limite de tempo excedido Sim Valor numérico 60 Defina o tempo, em segundos, que pretende esperar que a extração esteja concluída antes da ação falhar
Modo de armazenamento de dados N/D Variável, Folha de cálculo do Excel Variável Especifique se pretende armazenar os dados extraídos numa variável ou numa folha de cálculo do Excel

Variáveis produzidas

Argumento Tipo Descrição
ExcelInstance Instância do Excel A instância do Excel com os dados extraídos. Utilize esta instância caso para manipular a folha de cálculo (ou guardá-la e fechá-la) utilizando as ações dedicadas do Excel.
DataFromWebPage Tabela de dados Os dados extraídos sob a forma de um valor, lista, linha de dados ou tabela de dados única.

Exceções

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

Obter detalhes de uma página Web

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

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Get N/D Descrição da página Web, Meta palavras-chave da página Web, Título da página Web, Texto da página Web, Origem da página Web, Endereço URL atual do browser Descrição da página Web Selecione as informações a obter a partir da página Web

Variáveis produzidas

Argumento Tipo Descrição
WebPageProperty Valor de texto Os detalhes obtidos na página Web

Exceções

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

Obter detalhes de um elemento numa página Web

Obter o valor do atributo de um elemento numa página Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Elemento da IU Não Elemento da IU Selecione o elemento da IU na página Web a partir do qual os detalhes devem ser obtidos
Nome do atributo Não Valor de texto Texto próprio Introduza ou selecione o atributo cujo valor deve ser obtido

Variáveis produzidas

Argumento Tipo Descrição
AttributeValue Valor de texto O valor do atributo do elemento Web

Exceções

Exceção Descrição
Falha ao obter atributo de elemento da IU da página Web Indica um problema ao obter o atributo do elemento da página Web

Fazer captura de ecrã de uma página Web

Fazer uma captura de ecrã da página Web (ou de um elemento da página Web) atualmente apresentada no browser e guardar a imagem num ficheiro ou na área de transferência.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Capture N/D Página Web completa, Elemento específico Página Web completa Especifique se pretende capturar a página Web completa ou apenas um elemento específico desta
Elemento da IU Não Elemento da IU Selecione o elemento da IU a capturar na página Web
Modo de guardar N/D Área de transferência, Ficheiro Área de Transferência Especifique se pretende guardar a imagem num ficheiro ou armazená-la na área de transferência
Image file Não Ficheiro Defina o caminho completo do ficheiro para guardar a captura de imagem
File format N/D BMP, EMF, EXIF, GIF, JPG, PNG, TIFF, WMF BMP Selecione o formato do ficheiro de imagem

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Elemento com seletor CSS especificado não encontrado Indica que não foi encontrado nenhum elemento com o seletor CSS especificado na página Web
Falha ao guardar ficheiro Indica um problema ao guardar o ficheiro especificado
Falha ao guardar na área de transferência Indica um problema ao guardar para a área de transferência
Falha ao fazer captura de ecrã Indica um problema ao fazer uma captura de ecrã

Foco num campo de texto na página Web

Definir o foco num elemento de entrada de uma página Web e torná-lo visível.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Elemento da IU Não Elemento da IU Selecione o elemento da IU para atribuir o foco na página Web
Aguardar que a página carregue N/D Valor booleano Verdadeiro Especifique se pretende esperar que a nova página Web seja totalmente carregada antes de continuar
Tempo limite para que a página Web carregue Não Valor numérico 60 Definir o tempo em segundos para a página carregar antes que a ação emita um erro
Se um diálogo de pop-up aparecer N/D Fechar, Premir um botão, Não fazer nada Não fazer nada Especifique o que fazer se aparecer um diálogo de pop-up
Dialog button to press Sim Valor de texto OK Introduza o botão do diálogo a premir se aparecer um diálogo de pop-up

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Elemento com seletor CSS especificado não encontrado Indica que não foi encontrado nenhum elemento com o seletor CSS especificado na página Web
Falha ao definir foco de entrada em campo de texto da página Web Indica um problema ao definir o foco de entrada no campo de texto da página Web especificado

Preencher campo de texto em página Web

Preencher um campo de texto numa página Web com o texto especificado.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Elemento da IU Não Elemento da IU Selecione o campo de texto a povoar
Texto Não Entrada direta encriptada ou Valor de texto Introduza o texto para preencher o campo de texto
Se o campo não estiver vazio Sim Substituir texto, Anexar texto Substituir texto Especificar se deve substituir conteúdo existente ou anexar a este.
Preencher texto utilizando batimentos de tecla físicos N/A Valor booleano Falso Emular utilizando teclas físicas durante a povoação de texto a elementos de campo de texto da IU. São necessários procedimentos de teclas físicas para os casos em que a população de texto emulada não executa a ação intencional no elemento. Uma vez que esta opção requer que a janela do browser esteja focada, esta será automaticamente trazida para primeiro plano.
Emulate typing N/A Valor booleano Verdadeiro Especifique se o campo de texto deve ser preenchido de uma só vez, definindo o valor da caixa de texto, ou emular um utilizador a escrever enviando um caráter de cada vez. Este último método é mais lento, mas é necessário em algumas páginas Web complexas.
Unfocus text box after filling it N/D Valor booleano Falso Escolha se o foco deve ser removido da caixa de texto imediatamente após esta ação a preencher com o texto especificado. Se extrair de listas de preenchimento automático, este parâmetro deve ser definido como False.
Esperar que a página seja carregada N/A Valor booleano Verdadeiro Especifique se pretende esperar que a nova página Web seja totalmente carregada depois de povoar o campo de texto
Tempo limite para que a página Web carregue Não Valor numérico 60 Definir o tempo em segundos para a página carregar antes que a ação emita um erro
Se um diálogo de pop-up aparecer N/D Fechar, Premir um botão, Não fazer nada Não fazer nada Especifique o que fazer se aparecer um diálogo de pop-up depois de povoar o campo de texto
Dialog button to press Sim Valor de texto OK Introduza o botão do diálogo a premir se aparecer um diálogo de pop-up

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Elemento com seletor CSS especificado não encontrado Indica que não foi encontrado nenhum elemento com o seletor CSS especificado na página Web
Falha ao escrever em campo de texto Indica um problema ao escrever no campo de texto especificado

Definir o estado de uma caixa de verificação na página Web

Selecionar ou desmarcar uma caixa de verificação num formulário Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Elemento da IU Não Elemento da IU Selecione a caixa de verificação cujo estado deve ser definido
Estado da caixa de verificação N/D Marcado, Desmarcado Selecionada Selecione o estado da caixa de verificação
Esperar que a página seja carregada N/D Valor booleano Verdadeiro Especifique se pretende esperar que a nova página Web seja totalmente carregada depois de definir o estado da caixa de verificação
Tempo limite para que a página Web carregue Não Valor numérico 60 Definir o tempo em segundos para a página carregar antes que a ação emita um erro
Se um diálogo de pop-up aparecer N/D Fechar, Premir um botão, Não fazer nada Não fazer nada Especifique o que fazer se aparecer um diálogo de pop-up depois de definir o estado da caixa de verificação
Dialog button to press Sim Valor de texto OK Introduza o botão do diálogo a premir se aparecer um diálogo de pop-up

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Elemento com seletor CSS especificado não encontrado Indica que não foi encontrado nenhum elemento com o seletor CSS especificado na página Web
Falha ao definir o estado da caixa de verificação Indica um problema ao definir o estado da caixa de verificação especificada

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

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

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Elemento da IU Não Elemento da IU O botão de opção a selecionar
Aguardar que a página carregue N/D Valor booleano Verdadeiro Especifique se pretende esperar que a nova página Web seja totalmente carregada depois de selecionar o botão de opção
Tempo limite para que a página Web carregue Não Valor numérico 60 Definir o tempo em segundos para a página carregar antes que a ação emita um erro
Se um diálogo de pop-up aparecer N/D Fechar, Premir um botão, Não fazer nada Não fazer nada Especifique o que fazer se aparecer um diálogo de pop-up depois de selecionar o botão de opção
Dialog button to press Sim Valor de texto OK O botão do diálogo a premir se aparecer um diálogo de pop-up

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Elemento com seletor CSS especificado não encontrado Indica que não foi encontrado nenhum elemento com o seletor CSS especificado na página Web
Falha ao selecionar botão de opção Indica um problema ao selecionar o botão de opção especificado

Definir valor da lista pendente na página Web

Defina ou limpe as opções selecionadas para uma lista pendente num formulário web.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Elemento da IU Não Elemento da IU Selecione a lista pendente cujo valor deve ser definido
Operação N/D Limpar todas as opções, Selecionar opções por nome, Selecionar opções por índice Limpar todas as opções Selecione se pretende selecionar um valor ou limpar o valor selecionado na lista pendente
Nomes das opções Não Lista de valores de Texto Introduza uma opção ou uma lista de opções a selecionar na lista pendente. Várias opções fazem sentido apenas ao trabalhar com listas de seleção múltipla. Se a lista for de seleção única, só será utilizada a primeira opção da lista especificada.
Utilizar expressões regulares N/A Valor booleano Falso Especificar os valores de nomes de opção a interpretar como uma expressão regular
Índices de opções Não Lista de valores Numéricos Introduza um índice ou uma lista de índices a selecionar na lista pendente. Várias opções fazem sentido apenas ao trabalhar com listas de seleção múltipla. Se a lista for de seleção única, só será utilizada a primeira opção da lista especificada.
Aguardar que a página carregue N/A Valor booleano Verdadeiro Especifique se pretende esperar que a nova página Web seja totalmente carregada depois de definir o valor da lista pendente
Tempo limite para carregamento da página web Não Valor numérico 60 Definir o tempo em segundos para a página carregar antes que a ação emita um erro
Se um diálogo de pop-up aparecer N/D Fechar, Premir um botão, Não fazer nada Não fazer nada Especifique o que fazer se aparecer um diálogo de pop-up depois de definir o valor da lista pendente
Dialog button to press Sim Valor de texto OK Introduza o botão do diálogo a premir se aparecer um diálogo de pop-up

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Elemento com seletor CSS especificado não encontrado Indica que não foi encontrado nenhum elemento com o seletor CSS especificado na página Web
Falha ao definir a opção selecionada Indica um problema ao definir a opção da lista pendente selecionada

Premir um botão na página Web

Premir um botão na página Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Elemento da IU Não Elemento da IU Selecione o botão a premir
Aguardar que a página carregue N/D Valor booleano Verdadeiro Especifique se pretende esperar que a nova página Web seja totalmente carregada depois de premir o botão
Tempo limite para que a página Web carregue Não Valor numérico 60 Definir o tempo em segundos para a página carregar antes que a ação emita um erro
Se um diálogo de pop-up aparecer N/D Fechar, Premir um botão, Não fazer nada Não fazer nada Especifique o que fazer se aparecer um diálogo de pop-up depois de premir o botão
Dialog button to press Sim Valor de texto OK Introduza o botão do diálogo a premir se aparecer um diálogo de pop-up

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Elemento com seletor CSS especificado não encontrado Indica que não foi encontrado nenhum elemento com o seletor CSS especificado na página Web
Falha ao clicar em botão na página Web Indica um problema ao clicar no botão especificado da página Web

Se a página Web contiver

Marcar o início de um bloco de ações condicional consoante um texto ou um elemento da IU específico existe numa página Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende 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 o elemento Verificar se um texto ou elemento de página Web específico de existe numa página Web
Elemento da IU Não Elemento da IU Selecione o elemento da IU a verificar na página Web
Texto Não Valor de texto Introduza o texto a verificar na página Web

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Falha ao comunicar com o browser Indica que ocorreu um erro no browser

Esperar por conteúdo da página Web

Suspender o fluxo até que um fragmento de texto ou um elemento de página Web específico apareça ou desapareça numa página Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Wait for web page to N/D Contém o elemento, Não contém o elemento, Contém o texto, Não contém o texto Contém o elemento Especifique se deve esperar que um texto ou um elemento de página Web específico apareça ou desapareça numa página Web
Elemento da IU Não Elemento da IU Selecione o elemento da IU a verificar na página Web
Texto Não Valor de texto Introduza o texto a verificar na página Web

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Falha ao esperar por conteúdo da página Web Indica que a operação de espera falhou

Iniciar novo Internet Explorer

Iniciar uma nova instância ou anexar a uma instância em execução do Internet Explorer para automatizar sites e aplicações Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Launch mode N/D Iniciar browser de automatização, Iniciar novo Internet Explorer, Anexar a uma instância em execução do Internet Explorer Iniciar browser de automatização Especifique se deve iniciar o browser de automatização, uma nova instância do Internet Explorer ou anexar a uma instância existente
Attach to Internet Explorer tab N/D Por título, Por URL, Utilizar janela em primeiro plano Por título Especifique se deve anexar a um separador do Internet Explorer pelo respetivo título ou URL, ou anexar ao separador ativo do Internet Explorer em execução como janela em primeiro plano
Initial URL Não Valor de texto Introduza o URL do site a visitar quando o browser for iniciado
Tab title Não Valor de texto Introduza o título (ou parte deste) do separador do Internet Explorer de destino para anexar
Tab URL Não Valor de texto Introduza o URL (ou parte deste) do separador do Internet Explorer de destino para anexar
Window state N/D Normal, Maximizado, Minimizado Normal Especifique se o browser deve ser iniciado numa janela no estado normal, minimizado ou maximizado
Clear cache N/A Valor booleano Falso Especifique se a cache do browser deve ser totalmente limpa após este ser iniciado
Clear cookies N/D Valor booleano Falso Especifique se todos os cookies armazenados no browser devem ser limpos após este ser iniciado
Esperar que a página seja carregada N/D Valor booleano Verdadeiro Especifique se pretende esperar que a nova página Web seja totalmente carregada antes de continuar
Tempo limite para que a página Web carregue Não Valor numérico 60 Definir o tempo em segundos para a página carregar antes que a ação emita um erro
Se um diálogo de pop-up aparecer N/D Fechar, Premir um botão, Não fazer nada Não fazer nada Especifique o que fazer se aparecer um diálogo de pop-up durante o carregamento da página Web inicial
Dialog button to press Sim Valor de texto OK Introduza o botão do diálogo a premir se aparecer um diálogo de pop-up
Custom user agent string Sim Valor de texto Especifique a cadeia de agente de utilizador personalizada para o programa auxiliar da Web do runtime. Se este campo ficar vazio, o programa auxiliar da Web utiliza por predefinição a cadeia de agente de utilizador do Internet Explorer instalada no computador.

Nota

As opções Limpar cache e Limpar cookies só funcionam como pretendido se a execução em modo protegido estiver desativada no menu Opções da Internet.

Variáveis produzidas

Argumento Tipo Descrição
InternetExplorer Web browser instance A instância do Internet Explorer a utilizar com ações de automatização do browser

Exceções

Exceção Descrição
Falha ao iniciar o Internet Explorer Indica um problema ao iniciar o Internet Explorer
URL Inválido Indica que o URL fornecido é inválido

Iniciar novo Firefox

Iniciar uma nova instância ou anexar a uma instância em execução do Firefox para automatizar sites e aplicações Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Launch mode N/D Iniciar nova Instância, Anexar a uma instância em execução Iniciar nova Instância Especifique se deve iniciar uma nova instância do Firefox ou anexar a uma instância existente
Attach to Firefox tab N/D Por título, Por URL, Utilizar janela em primeiro plano Por título Especifique se deve anexar a um separador do Firefox pelo respetivo título ou URL, ou anexar ao separador ativo do Firefox em execução como janela em primeiro plano
Initial URL Não Valor de texto Introduza o URL do site a visitar quando o browser for iniciado
Tab title Não Valor de texto Introduza o título (ou parte deste) do separador do Firefox de destino para anexar
Tab URL Não Valor de texto Introduza o URL (ou parte deste) do separador do Firefox de destino para anexar
Window state N/D Normal, Maximizado, Minimizado Normal Especifique se o browser deve ser iniciado numa janela no estado normal, minimizado ou maximizado
Clear cache N/A Valor booleano Falso Especifique se a cache do browser deve ser totalmente limpa após este ser iniciado
Clear cookies N/D Valor booleano Falso Especifique se todos os cookies armazenados no browser devem ser limpos após este ser iniciado
Esperar que a página seja carregada N/D Valor booleano Verdadeiro Especifique se pretende esperar que a nova página Web seja totalmente carregada antes de continuar
Tempo limite para que a página Web carregue Não Valor numérico 60 Definir o tempo em segundos para a página carregar antes que a ação emita um erro
Se um diálogo de pop-up aparecer N/D Fechar, Premir um botão, Não fazer nada Não fazer nada Especifique o que fazer se aparecer um diálogo de pop-up durante o carregamento da página Web inicial
Dialog button to press Sim Valor de texto OK Introduza o botão do diálogo a premir se aparecer um diálogo de pop-up
Timeout Não Valor numérico 60 Defina o tempo, em segundos, que pretende esperar que o browser seja iniciado antes da ação falhar
Pasta de dados de utilizador N/A Picture-in-Picture predefinido, Predefinição do browser, Personalizado Predefinição de Picture-in-Picture Especifique a pasta de dados do utilizador que o browser utiliza quando o fluxo é executado no Picture-in-Picture. Se a opção Predefinição do browser estiver selecionada, o navegador não pode ser aberto no ambiente de trabalho e no Picture-in-Picture ao mesmo tempo. Mais informações
Caminho da pasta de dados de utilizador Não Pasta Especifique o caminho da pasta de dados do utilizador que o browser utiliza quando o fluxo é executado no Picture-in-Picture. Mais informações

Variáveis produzidas

Argumento Tipo Descrição
Browser Instância de browser da web A instância do Firefox a utilizar com ações de automatização do browser

Exceções

Exceção Descrição
Falha ao iniciar o Firefox Indica um problema ao iniciar o Firefox
URL Inválido Indica que o URL fornecido é inválido

Iniciar novo Chrome

Iniciar uma nova instância ou anexar a uma instância em execução do Chrome para automatizar sites e aplicações Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Launch mode N/D Iniciar nova Instância, Anexar a uma instância em execução Iniciar nova Instância Especifique se deve iniciar uma nova instância do Chrome ou anexar a uma instância existente
Attach to Chrome tab N/D Por título, Por URL, Utilizar janela em primeiro plano Por título Especifique se deve anexar a um separador do Chrome pelo respetivo título ou URL, ou anexar ao separador ativo do Chrome em execução como janela em primeiro plano
Initial URL Não Valor de texto Introduza o URL do site a visitar quando o browser for iniciado
Tab title Não Valor de texto Introduza o título (ou parte deste) do separador do Chrome de destino para anexar
Tab URL Não Valor de texto Introduza o URL (ou parte deste) do separador do Chrome de destino para anexar
Window state N/D Normal, Maximizado, Minimizado Normal Especifique se o browser deve ser iniciado numa janela no estado normal, minimizado ou maximizado
Clear cache N/A Valor booleano Falso Especifique se a cache do browser deve ser totalmente limpa após este ser iniciado
Clear cookies N/D Valor booleano Falso Especifique se todos os cookies armazenados no browser devem ser limpos após este ser iniciado
Esperar que a página seja carregada N/D Valor booleano Verdadeiro Especifique se pretende esperar que a nova página Web seja totalmente carregada antes de continuar
Tempo limite para que a página Web carregue Não Valor numérico 60 Definir o tempo em segundos para a página carregar antes que a ação emita um erro
Se um diálogo de pop-up aparecer N/D Fechar, Premir um botão, Não fazer nada Não fazer nada Especifique o que fazer se aparecer um diálogo de pop-up durante o carregamento da página Web inicial
Dialog button to press Sim Valor de texto OK Introduza o botão do diálogo a premir se aparecer um diálogo de pop-up
Timeout Não Valor numérico 60 Defina o tempo, em segundos, que pretende esperar para que o browser seja aberto antes da ação falhar
Pasta de dados de utilizador N/A Picture-in-Picture predefinido, Predefinição do browser, Personalizado Predefinição de Picture-in-Picture Especifique a pasta de dados do utilizador que o browser utiliza quando o fluxo é executado no Picture-in-Picture. Se a opção Predefinição do browser estiver selecionada, o navegador não pode ser aberto no ambiente de trabalho e no Picture-in-Picture ao mesmo tempo. Mais informações
Caminho da pasta de dados de utilizador Não Pasta Especifique o caminho da pasta de dados do utilizador que o browser irá utilizar quando o fluxo é executado no Picture-in-Picture. Mais informações

Variáveis produzidas

Argumento Tipo Descrição
Browser Instância de browser da web A instância do Chrome a utilizar com ações de automatização do browser

Exceções

Exceção Descrição
Falha ao iniciar o Chrome Indica um problema ao iniciar o Chrome
URL Inválido Indica que o URL fornecido é inválido

Iniciar novo Microsoft Edge

Iniciar uma nova instância ou anexar a uma instância em execução do Microsoft Edge para automatizar sites e aplicações Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Launch mode N/D Iniciar nova Instância, Anexar a uma instância em execução Iniciar nova Instância Especifique se deve iniciar uma nova instância do Microsoft Edge ou anexar a uma instância existente
Attach to Microsoft Edge tab N/D Por título, Por URL, Utilizar janela em primeiro plano Por título Especifique se deve anexar a um separador do Microsoft Edge pelo respetivo título ou URL, ou anexar ao separador ativo do Microsoft Edge em execução como janela em primeiro plano
Initial URL Não Valor de texto Introduza o URL do site a visitar quando o browser for iniciado
Tab title Não Valor de texto Introduza o título (ou parte deste) do separador do Microsoft Edge de destino para anexar
Tab URL Não Valor de texto Introduza o URL (ou parte deste) do separador do Microsoft Edge de destino para anexar
Window state N/D Normal, Maximizado, Minimizado Normal Especifique se o browser deve ser iniciado numa janela no estado normal, minimizado ou maximizado
Clear cache N/A Valor booleano Falso Especifique se a cache do browser deve ser totalmente limpa após este ser iniciado
Clear cookies N/D Valor booleano Falso Especifique se todos os cookies armazenados no browser devem ser limpos após este ser iniciado
Esperar que a página seja carregada N/D Valor booleano Verdadeiro Especifique se pretende esperar que a nova página Web seja totalmente carregada antes de continuar
Tempo limite para que a página Web carregue Não Valor numérico 60 Definir o tempo em segundos para a página carregar antes que a ação emita um erro
Se um diálogo de pop-up aparecer N/D Fechar, Premir um botão, Não fazer nada Não fazer nada Especifique o que fazer se aparecer um diálogo de pop-up durante o carregamento da página Web inicial
Dialog button to press Sim Valor de texto OK Introduza o botão do diálogo a premir se aparecer um diálogo de pop-up
Timeout Não Valor numérico 60 Defina o tempo, em segundos, que pretende esperar que o browser seja iniciado antes da ação falhar
Pasta de dados de utilizador N/A Picture-in-Picture predefinido, Predefinição do browser, Personalizado Predefinição de Picture-in-Picture Especifique a pasta de dados do utilizador que o browser utiliza quando o fluxo é executado no Picture-in-Picture. Se a opção Predefinição do browser estiver selecionada, o navegador não pode ser aberto no ambiente de trabalho e no Picture-in-Picture ao mesmo tempo. Mais informações
Caminho da pasta de dados de utilizador Não Pasta Especifique o caminho da pasta de dados do utilizador que o browser utiliza quando o fluxo é executado no Picture-in-Picture. Mais informações

Variáveis produzidas

Argumento Tipo Descrição
Browser Instância de browser da web A instância do Microsoft Edge a utilizar com ações de automatização do browser

Exceções

Exceção Descrição
Falha ao iniciar o Microsoft Edge Indica um problema ao iniciar o Microsoft Edge
URL Inválido Indica que o URL fornecido é inválido

Criar novo separador

Criar um novo separador e navegar para o URL indicado (suportado no Microsoft Edge, Chrome e Firefox).

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
URL to navigate to Não Valor de texto Introduza o URL (ou uma variável que contenha o URL) de destino
Esperar que a página seja carregada N/D Valor booleano Verdadeiro Especifique se pretende esperar que a nova página Web seja totalmente carregada antes de continuar
Tempo limite para que a página Web carregue Não Valor numérico 60 Definir o tempo em segundos para a página carregar antes que a ação emita um erro
Se um diálogo de pop-up aparecer N/D Fechar, Premir um botão, Não fazer nada Não fazer nada Especifique o que fazer se aparecer um diálogo de pop-up durante o carregamento da página Web
Dialog button to press Sim Valor de texto OK Introduza o botão do diálogo a premir se aparecer um diálogo de pop-up

Variáveis produzidas

Argumento Tipo Descrição
NewBrowser Web browser instance A nova instância do browser a utilizar com ações de automatização do browser

Exceções

Exceção Descrição
URL Inválido Indica que o URL fornecido é inválido
Falha ao criar novo separador Indica um problema ao criar um novo separador

Aceder a página Web

Navegar para uma nova página no browser.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Navigate N/D URL de destino, Anterior, Seguinte, Recarregar página Web URL de destino Especifique o destino da navegação
URL Não Valor de texto Introduza o URL de destino da navegação
Esperar que a página seja carregada N/D Valor booleano Verdadeiro Especifique se pretende esperar que a página Web seja totalmente carregada antes de continuar
Tempo limite para que a página Web carregue Não Valor numérico 60 Definir o tempo em segundos para a página carregar antes que a ação emita um erro
Se um diálogo de pop-up aparecer N/D Fechar, Premir um botão, Não fazer nada Não fazer nada Especifique o que fazer se aparecer um diálogo de pop-up durante o carregamento da página Web
Dialog button to press Sim Valor de texto OK Introduza o botão do diálogo a premir se aparecer um diálogo de pop-up

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Falha ao navegar para página Web Indica um problema ao navegar para a página Web especificada
URL Inválido Indica que o URL fornecido é inválido

Clicar em ligação na página Web

Clicar numa ligação ou em qualquer outro elemento de uma página Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Elemento da IU Não Elemento da IU Selecione o elemento da IU a clicar na página Web
Tipo de clique N/D Clique com o botão esquerdo do rato, Clique com o botão direito do rato, Clique duplo, Botão esquerdo do rato para baixo, Botão esquerdo do rato para cima, Botão direito do rato para baixo, Botão direito do rato para cima, Clique com o botão central do rato Clique com o botão esquerdo do rato O tipo de clique a efetuar
Enviar clique físico N/D Valor booleano Falso Especifique se move fisicamente o cursor do rato sobre o elemento antes de clicar. É necessário um clique físico para os casos onde os cliques emulados não efetuam a ação intencional no elemento. Uma vez que esta opção requer que a janela do browser esteja focada, esta será automaticamente trazida para primeiro plano.
Esperar que a página seja carregada N/A Valor booleano Verdadeiro Especifique se pretende esperar que a nova página Web seja totalmente carregada depois de clicar na ligação
Tempo limite para que a página Web carregue Não Valor numérico 60 Definir o tempo em segundos para a página carregar antes que a ação emita um erro
Se um diálogo de pop-up aparecer N/D Fechar, Premir um botão, Não fazer nada Não fazer nada Especifique o que fazer se aparecer um diálogo de pop-up depois de clicar na ligação
Dialog button to press Sim Valor de texto OK Introduza o botão do diálogo a premir se aparecer um diálogo de pop-up

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Elemento com seletor CSS especificado não encontrado Indica que não foi encontrado nenhum elemento com o seletor CSS especificado na página Web
Falha ao clicar em elemento da IU Indica um problema ao clicar no elemento especificado

Clicar numa ligação numa página Web que origina a transferência de um ficheiro.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Elemento da IU Não Elemento da IU Selecione o elemento da IU a clicar na página Web
Pasta de destino Não Pasta Introduza ou selecione o caminho completo da pasta (ou uma variável que contenha a pasta) em que o ficheiro transferido deve ser guardado

Variáveis produzidas

Argumento Tipo Descrição
DownloadedFile Ficheiro O ficheiro no disco em que a transferência é guardada. Este valor é um caminho de ficheiro composto pela pasta de transferência especificada acima e pelo nome do ficheiro fornecido pelo servidor Web.
Exceção Descrição
Falha ao transferir ficheiro Indica um problema ao transferir o ficheiro especificado
Elemento com seletor CSS especificado não encontrado Indica que não foi encontrado nenhum elemento com o seletor CSS especificado na página Web
Falha ao clicar em elemento da IU Indica um problema ao clicar no elemento especificado
Falha ao guardar ficheiro Indica um problema ao guardar o ficheiro especificado

Executar função JavaScript na página Web

Executar uma função JavaScript na página Web e obter o resultado devolvido.

Nota

A migração para as extensões de browser do Manifest V3 afeta esta ação. Para obter mais informações sobre o Manifest V3 e como afeta a ação Executar função JavaScript na página Web, aceda a Migração para o Manifest V3.

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

Variáveis produzidas

Argumento Tipo Descrição
Result Valor de texto O resultado da função JavaScript executada

Exceções

Exceção Descrição
Falha ao executar JavaScript Indica um problema ao executar JavaScript

Pairar o rato sobre um elemento numa página Web

Pairar o rato sobre um elemento de uma página Web.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser com que pretende trabalhar
Elemento da IU No Elemento da IU Selecione o elemento da IU sobre o qual o rato deve pairar na página Web
Mover o rato para pairar No Valor booleano False Especifique se move fisicamente o cursor do rato sobre o elemento para pairar sobre o elemento da IU. É necessário pairar fisicamente para os casos em que pairar emulado não efetua a ação intencional no elemento. Uma vez que esta opção requer que a janela do browser esteja focada, esta será automaticamente trazida para primeiro plano.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Falha ao pairar sobre elemento Indica um problema ao pairar sobre o elemento especificado

Fechar browser

Fechar uma janela do browser.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Web browser instance Não Instância do browser Introduza ou escolha a variável que contém a instância do browser a fechar

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Falha ao fechar o browser Indica um problema ao fechar o browser