Abrir Navegador

UiPath.Core.Activities.OpenBrowser

Um contêiner que permite que você abra um navegador em um URL específico e realize várias atividades nele.

Atenção:

As URLs internas não podem ser abertas usando essa atividade quando o navegador não as aceita diretamente como argumentos de linha de comando.

Você não pode abrir páginas internas do Chrome (chrome://) ou do Edge (edge://). No entanto, você pode abrir páginas internas do Firefox (about:).

No corpo da atividade

No painel do designer, a atividade é apresentada como um contêiner, no qual você pode adicionar atividades para interagir com o navegador especificado.

O campo URL permite que você forneça o link que o navegador deve abrir.

Clicando no botão ao lado do campo URL abre uma nova sessão do navegador com as definições de configuração atuais. Isso possibilita o uso de um novo conjunto de dados do usuário do navegador, mantendo a configuração existente. Pode ser especialmente útil quando você automatiza navegadores em Picture-in-Picture.

Também está presente uma sequência, na qual são adicionadas as ações executadas no navegador.

Propriedades

Comum

• ContinuarComErro — especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

  Observação: se essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.
• NomeDeExibição - o nome de exibição da atividade.

Entrada

• TipoDeNavegador - Escolha o tipo de navegador que deseja usar usando o botão suspenso. As seguintes opções estão disponíveis: IE, Firefox, Chrome, Edge, Personalizado. O Tipo Personalizado é adequado para outros navegadores baseados no Chromium, como o JxBrowser. a propriedade Oculto não é suportada ao usar o tipo Personalizado de navegador. Para mais informações sobre como configurar um navegador personalizado, consulte a seção Navegador Personalizado .

  Observação: se a propriedade TipoDeNavegador estiver definida para Personalizado, a propriedade MétodoDeComunicação deve ser definida para WebDriver para a atividade funcionar corretamente.
• Url - O URL que você deseja abrir no navegador especificado.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• BaixarAutomaticamenteWebDriver - Se selecionado, baixa automaticamente da Internet para a pasta %localappdata%\UiPath\WebdriverExe o executável do WebDriver necessário. Por padrão, essa caixa de seleção está desmarcada.
• MétodoDeComunicação - Escolha o método de comunicação. Os seguintes estão disponíveis: Nativo e WebDriver.
• Oculto - Abre um navegador oculto.
• NovaSessão - Começa uma nova sessão no navegador selecionado. Essa opção é específica do Internet Explorer.
• Particular - Abre uma sessão privada/modo incógnito.

• ModoDaPastaDeDadosDoUsuário - O ModoDaPastaDeDadosDoUsuário que você quer definir. É usado para iniciar o navegador com uma pasta de dados do usuário específica.

  • ModoDaPastaDeDadosDoUsuário.Automático - O modo Picture In Picture usa uma pasta diferente do modo padrão, gerada automaticamente se CaminhoDaPastaDeDadosDoUsuário não estiver definida.
  • ModoDaPastaDeDadosDoUsuário.PastaPadrão - Usa a pasta do navegador padrão, independentemente de ser executada na sessão principal ou em PiP.
  • ModoDaPastaDeDadosDoUsuário.PastaPersonalizada - Usa a pasta especificada em CaminhoDaPastaDeDadosDoUsuário ou um caminho gerado automaticamente se CaminhoDaPastaDeDadosDoUsuário não estiver definida.
• CaminhoDaPastaDeDadosDoUsuário - A pasta de dados do usuário que o navegador usará. O padrão é %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType, se não tiver sido definida.

Mais detalhes sobre ModoDaPastaDeDadosDoUsuário e CaminhoDaPastaDeDadosDoUsuário podem ser encontrados aqui.

Saída

• NavegadorDaUi - O resultado da atividade como um objeto de NavegadorDaUi. Armazena todas as informações sobre a sessão do seu navegador. Apenas variáveis Navegador são compatíveis.

Navegador Personalizado

Um navegador Personalizado é um navegador diferente daqueles amplamente utilizados (Chrome, Chromium Edge, Firefox, IE etc.) e que é construído com base no projeto Chromium. Oferecemos suporte a duas categorias desses navegadores: navegadores criados com Chromium Embedded Framework (CEF) e navegadores que usam a estrutura JxBrowser.

Esses navegadores personalizados podem ser automatizados usando o método de comunicação WebDriver.

Para que isso ocorra, devem suportar o parâmetro de linha de comando --remote-debugging-port, assim como todos os navegadores baseados em Chromium o fazem.

Configurando um navegador personalizado

O navegador personalizado que deseja utilizar deve ter um executável chromedriver.exe adequado para a versão do Chromium com a qual o navegador personalizado foi desenvolvido PATH.

Na chave de registro HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE, sob Software\UiPath\UiPath Platform\CustomBrowser, o valor de Comando deve conter o caminho para o executável do navegador personalizado ou um comando que inicia esse navegador personalizado.

Opcionalmente, nos casos em que você precisa executar apenas uma única instância do navegador personalizado e, por motivos de segurança, deseja especificar a porta de depuração remota na qual a comunicação com o navegador personalizado é feita, um valor de registro chamado RemoteDebuggingPort deve ser adicionado à mesma chave de registro na qual o Comando foi especificado.

Seletores de páginas de tal navegador personalizado têm custom_browser como nome do aplicativo do navegador.

Exemplo de uso da atividade Open Browswer

Aqui você pode ver como a atividade Open Browser é usada em um exemplo que incorpora várias atividades.