Abrir

Abre um aplicativo da área de trabalho ou uma página do navegador da Web para serem usados na automação de interface gráfica.

Essa API é usada chamando o serviço UIAutomation, com base no seguinte formato: uiAutomation.API(). Por exemplo, uiAutomation.Open().

Definição

Namespace: UiPath.UIAutomationNext.API.Contracts

Assembly: UiPath.UIAutomationNext.API.Contracts (in UiPath.UIAutomationNext.API.Contracts dll)

Sobrecarregas

Sobrecarga	Description
Open(String, TargetAppOptions, String, String)	Abre um aplicativo de área de trabalho específico ou uma página da Web para usar na automação de interface gráfica, identificado pelo nome da tela no Repositório de Objetos.
Open(TargetAppModel, TargetAppOptions)	Abre um aplicativo de área de trabalho específico ou uma página da Web para usar na automação de interface gráfica, identificado pelo objeto TargetAppModel .
Open(String, String, String, NAppOpenMode, NWindowResize, NInteractionMode)	Abre um aplicativo de área de trabalho específico ou uma página da Web para usar na automação de interface gráfica, identificado pelo nome da tela no Repositório de Objetos, juntamente com outras personalizações do aplicativo ou da página da Web.

Open(String, TargetAppOptions, String, String)

Abre um aplicativo de área de trabalho específico ou uma página da Web para usar na automação de interface gráfica, identificado pelo nome da tela no Repositório de Objetos.

Open(
    string screenName,  
    TargetAppOptions targetAppOptions, 
    [string appName],
    [string appVersion])

screeName String

O nome da tela que você quer focar, como uma String gravada no Repositório de Objetos.

targetAppOptions

Opções e configurações adicionais para anexar ao aplicativo ou página da web:

• Timeout Double - Especifique quantos segundos aguardar a execução da atividade antes de gerar um erro. O valor padrão é 30 segundos. Ao indicar uma janela em um ambiente de Área de Trabalho Remota, a configuração padrão de Tempo limite é definida como 60 segundos.
• InteractionMode NInteractionMode:
  • HardwareEvents - Usa o driver de hardware para executar as Actions. Essa é a API mais lenta e não pode funcionar em segundo plano, mas é compatível todos os aplicativos de desktop.
  • Simulate - Simula as Actions usando APIs de acessibilidade. Recomendado na automação do navegador, aplicativos Java ou SAP. Mais confiável que Eventos de hardware. Envia todo o texto em uma única Actions. Funciona mesmo que o aplicativo de destino não esteja em foco. Teste se o elemento de interface gráfica de seu aplicativo de destino é compatível com isso.
  • DebuggerApi - Executa Actions usando APIs do depurador. Funciona apenas com elementos do Chromium. Envia todos os textos de uma vez. Funciona mesmo que o aplicativo de destino não esteja em foco. Para obter mais detalhes, verifique esta página.
  • WindowMessages - Envia a entrada do mouse e do teclado por meio de mensagens do Win32. Recomendado para aplicativos de desktop. Geralmente mais confiável que Eventos de hardware. Envia todo o texto em uma única Actions. Funciona mesmo que o aplicativo de destino não esteja em foco. Teste se o elemento de interface gráfica de seu aplicativo de destino é compatível com isso.
  • Background - Executa Actions em segundo plano. Tenta usar a API Simulate ou Chromium quando possível, enquanto APIs complexas (image, native tex) são executadas normalmente, em primeiro plano. É altamente recomendável usar essa API com a funcionalidade Verificar Execução .
• OpenMode NAppOpenMode - escolha quando abrir o aplicativo:
  • Never (nunca abra o aplicativo)
  • IfNotOpen (abrir apenas se o aplicativo estiver fechado; essa é a seleção padrão, funciona apenas se FilePath ou URL forem fornecidos)
  • Always (abre outra instância do aplicativo mesmo se uma já estiver aberta, só funciona se FilePath ou URL forem fornecidos)
• WindowResize NWindowResize - escolha o tamanho da janela:
  • Nenhum
  • Maximizar
  • Restaurar
  • Minimizar
• UserDataFolderMode BrowserUserDataFolderMode - O UserDataFolderMode que você deseja definir. É usado para iniciar o navegador com uma pasta específica de dados do usuário.
  • Automatic - O modo Picture In Picture usa uma pasta diferente do modo padrão, gerada automaticamente se UserDataFolderPath não estiver definida.
  • DefaultFolder - Usa a pasta do navegador padrão, independentemente de ser executada na sessão principal ou PIP.
  • CustomFolder - Usa a pasta especificada em UserDataFolderPath ou um caminho gerado automaticamente se UserDataFolderPath não estiver definido.
• UserDataFolderPath String - A pasta de dados do usuário que o navegador usa. O padrão é %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType , se não tiver sido definida.
• IsIncognito Boolean - insira True se você quiser abrir o navegador no modo anônimo. Por padrão, ele é definido como False.
• WebDriverMode NWebDriverMode - Indica como o WebDriver é usado ao abrir uma nova sessão do navegador. As seguintes opções estão disponíveis:
  • Disabled - Desabilita o uso do WebDriver.
  • WithGUI - A GUI do navegador é exibida.
  • Headless - O navegador é iniciado de forma silenciosa, sem GUI.

appName String

O nome do aplicativo ao qual anexar. Esse parâmetro é aplicável para aplicativos de desktop.

appVersion String

A versão do aplicativo a ser anexada. Esse parâmetro é aplicável para aplicativos de desktop.

Open(TargetAppModel, TargetAppOptions)

Abre um aplicativo de área de trabalho específico ou uma página da Web para usar na automação de interface gráfica, identificado pelo objeto TargetAppModel .

Open(
    TargetAppModel targetApp,
    [TargetAppOptions targetAppOptions])

targetApp ModeloDoAplicativoDeDestino

O aplicativo de destino ou a página da Web a ser anexada. É um objeto do tipo TargetAppModel que fornece informações sobre o aplicativo:

• Selector - Um fragmento XML que armazena os atributos de um elemento da interface do usuário.
• FilePath — se o aplicativo não for um navegador da web, especifica o caminho completo do arquivo executável a ser aberto.
• Arguments - Se o aplicativo não for um navegador da web, você pode especificar os parâmetros a serem passados para o aplicativo de destino na inicialização.
• Url - Se o aplicativo for um navegador da Web, especifica a URL da página da Web a ser aberta.
• Title - O título do aplicativo ou navegador.

targetAppOptions

Opções e configurações adicionais para anexar ao aplicativo ou página da web:

• Timeout Double - Especifique quantos segundos aguardar a execução da atividade antes de gerar um erro. O valor padrão é 30 segundos. Ao indicar uma janela em um ambiente de Área de Trabalho Remota, a configuração padrão de Tempo limite é definida como 60 segundos.
• InteractionMode NInteractionMode:
  • HardwareEvents - Usa o driver de hardware para executar as Actions. Essa é a API mais lenta e não pode funcionar em segundo plano, mas é compatível todos os aplicativos de desktop.
  • Simulate - Simula as Actions usando APIs de acessibilidade. Recomendado na automação do navegador, aplicativos Java ou SAP. Mais confiável que Eventos de hardware. Envia todo o texto em uma única Actions. Funciona mesmo que o aplicativo de destino não esteja em foco. Teste se o elemento de interface gráfica de seu aplicativo de destino é compatível com isso.
  • DebuggerApi - Executa Actions usando APIs do depurador. Funciona apenas com elementos do Chromium. Envia todos os textos de uma vez. Funciona mesmo que o aplicativo de destino não esteja em foco. Para obter mais detalhes, verifique esta página.
  • WindowMessages - Envia a entrada do mouse e do teclado por meio de mensagens do Win32. Recomendado para aplicativos de desktop. Geralmente mais confiável que Eventos de hardware. Envia todo o texto em uma única Actions. Funciona mesmo que o aplicativo de destino não esteja em foco. Teste se o elemento de interface gráfica de seu aplicativo de destino é compatível com isso.
  • Background - Executa Actions em segundo plano. Tenta usar a API Simulate ou Chromium quando possível, enquanto APIs complexas (image, native tex) são executadas normalmente, em primeiro plano. É altamente recomendável usar essa API com a funcionalidade Verificar Execução .
• OpenMode NAppOpenMode - escolha quando abrir o aplicativo:
  • Never (nunca abra o aplicativo)
  • IfNotOpen (abrir apenas se o aplicativo estiver fechado; essa é a seleção padrão, funciona apenas se FilePath ou URL forem fornecidos)
  • Always (abre outra instância do aplicativo mesmo se uma já estiver aberta, só funciona se FilePath ou URL forem fornecidos)
• WindowResize NWindowResize - escolha o tamanho da janela:
  • Nenhum
  • Maximizar
  • Restaurar
  • Minimizar
• UserDataFolderMode BrowserUserDataFolderMode - O UserDataFolderMode que você deseja definir. É usado para iniciar o navegador com uma pasta específica de dados do usuário.
  • Automatic - O modo Picture In Picture usa uma pasta diferente do modo padrão, gerada automaticamente se UserDataFolderPath não estiver definida.
  • DefaultFolder - Usa a pasta do navegador padrão, independentemente de ser executada na sessão principal ou PIP.
  • CustomFolder - Usa a pasta especificada em UserDataFolderPath ou um caminho gerado automaticamente se UserDataFolderPath não estiver definido.
• UserDataFolderPath String - A pasta de dados do usuário que o navegador usa. O padrão é %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType , se não tiver sido definida.
• IsIncognito Boolean - insira True se você quiser abrir o navegador no modo anônimo. Por padrão, ele é definido como False.
• WebDriverMode NWebDriverMode - Indica como o WebDriver é usado ao abrir uma nova sessão do navegador. As seguintes opções estão disponíveis:
  • Disabled - Desabilita o uso do WebDriver.
  • WithGUI - A GUI do navegador é exibida.
  • Headless - O navegador é iniciado de forma silenciosa, sem GUI.

Open(String, String, String, NAppOpenMode, NWindowResize, NInteractionMode)

Abre um aplicativo de área de trabalho específico ou uma página da Web para usar na automação de interface gráfica, identificado pelo nome da tela no Repositório de Objetos, juntamente com outras personalizações do aplicativo ou da página da Web.

Open(
    string screenName,
    [string appName],
    [string appVersion],
    [NAppOpenMode openMode],
    [NWindowResize windowResize],
    [NInteractionMode interactionMode])

screeName String

O nome da tela que você quer focar, como uma String gravada no Repositório de Objetos.

appName String

O nome do aplicativo ao qual anexar. Esse parâmetro é aplicável para aplicativos de desktop.

appVersion String

A versão do aplicativo a ser anexada. Esse parâmetro é aplicável para aplicativos de desktop.

openMode NAppOpenMode

Selecione quando abrir o aplicativo de destino para a execução da automação:

• Never (nunca abra o aplicativo)
• IfNotOpen (abre apenas se o aplicativo estiver fechado; essa é a seleção padrão, funciona apenas se o parâmetro Url estiver configurado)
• Always — (abrir outra instância do aplicativo mesmo se uma já estiver aberta, funciona apenas se o parâmetro Url estiver configurado).

NWindowResize

Escolha o tamanho da janela:

• Nenhum
• Maximizar
• Restaurar
• Minimizar

NInteractionMode

Escolha qual API o Robô deve usar para interagir com o aplicativo de destino:

• HardwareEvents - Usa o driver de hardware para executar as Actions. Essa é a API mais lenta e não pode funcionar em segundo plano, mas é compatível todos os aplicativos de desktop.
• Simulate - Simula as Actions usando APIs de acessibilidade. Recomendado na automação do navegador, aplicativos Java ou SAP. Mais confiável que Eventos de hardware. Envia todo o texto em uma única Actions. Funciona mesmo que o aplicativo de destino não esteja em foco. Teste se o elemento de interface gráfica de seu aplicativo de destino é compatível com isso.
• DebuggerApi - Executa Actions usando APIs do depurador. Funciona apenas com elementos do Chromium. Envia todos os textos de uma vez. Funciona mesmo que o aplicativo de destino não esteja em foco. Para obter mais detalhes, verifique esta página.
• WindowMessages - Envia a entrada do mouse e do teclado por meio de mensagens do Win32. Recomendado para aplicativos de desktop. Geralmente mais confiável que Eventos de hardware. Envia todo o texto em uma única Actions. Funciona mesmo que o aplicativo de destino não esteja em foco. Teste se o elemento de interface gráfica de seu aplicativo de destino é compatível com isso.
• Background - Executa Actions em segundo plano. Tenta usar a API Simulate ou Chromium quando possível, enquanto APIs complexas (image, native tex) são executadas normalmente, em primeiro plano. É altamente recomendável usar essa API com a funcionalidade Verificar Execução .

Execução do WebDriverMode como sem periféricos

Para operar WebDriverMode em uma configuração sem periféricos, essas etapas podem servir como um guia.

Comece definindo uma variável para sua tela. Use a função uiAutomation.Openpara abrir um novo aplicativo no navegador de sua escolha - nesta instância, Edge. Depois disso, use a classe Options na sobrecarga para especificar certas opções do navegador. Entre essas opções, defina webDriverModecomo NWebDriverMode.Headless.

O código correspondente fica assim:

var screen = uiAutomation.Open(Descriptors.NewApplication.Edge, Options.AppOpen().WithBrowserOptions(webDriverMode: NWebDriverMode.Headless));

Esse código funciona para configurar seu WebDriver no modo Headless, habilitando a automação do navegador sem que o navegador esteja visivelmente aberto.