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.

Observaçã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.

Clicar no O botão ao lado do campo de URL abre uma nova sessão do navegador com as configurações atuais. Isso torna possível usar um novo conjunto de dados de usuário do navegador enquanto mantém 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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Observação:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

• DisplayName - 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 em 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 que a atividade funcione 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.