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 executar a automatização Web, primeiro é necessário criar uma nova instância do browser. Pode conseguir isso através das ações de Iniciação do Browser, que suportam 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.

Nota

Para iniciar um browser num ambiente de trabalho virtual, primeiro capture pelo menos um elemento da IU nesse ambiente de trabalho. Este elemento precisa de estar disponível no repositório de elementos da IU do seu fluxo.

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.

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.

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.

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
Ambiente de trabalho de destino	N/A	Computador local, qualquer área de trabalho virtual que esteja conectada no momento ou tenha pelo menos um elemento da IU capturado	Computador local	Defina a cadeia de ligação do ambiente de trabalho de destino que o browser inicia
Clear cache	N/A	Valor booleano	False	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
Ambiente de trabalho de destino	N/A	Computador local, qualquer área de trabalho virtual que esteja conectada no momento ou tenha pelo menos um elemento da IU capturado	Computador local	Defina a cadeia de ligação do ambiente de trabalho de destino que o browser inicia
Clear cache	N/A	Valor booleano	False	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	Web browser instance	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
Ambiente de trabalho de destino	N/A	Computador local, qualquer área de trabalho virtual que esteja conectada no momento ou tenha pelo menos um elemento da IU capturado	Computador local	Defina a cadeia de ligação do ambiente de trabalho de destino que o browser inicia
Clear cache	N/A	Valor booleano	False	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	Web browser instance	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
Ambiente de trabalho de destino	N/A	Computador local, qualquer área de trabalho virtual que esteja conectada no momento ou tenha pelo menos um elemento da IU capturado	Computador local	Defina a cadeia de ligação do ambiente de trabalho de destino que o browser inicia
Clear cache	N/A	Valor booleano	False	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	Web browser instance	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 de transferência na página Web

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

Importante

A ação Clicar na ligação de transferência na página Web só funciona no Internet Explorer, que atingiu o fim do ciclo de vida. Em vez disso, recomendamos que utilize ações HTTP.

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ções

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	Não	Elemento da IU		Selecione o elemento da IU sobre o qual o rato deve pairar na página Web
Mover o rato para pairar	Não	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