Anexar

Foco em um aplicativo de área de trabalho ou uma página do navegador da Web que já está aberta para ser usado na automação de interface gráfica.

Essa API é usada chamando o serviço UIAutomation, com base no seguinte formato: uiAutomation.<APIMethod>(). 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
Attach(String, TargetAppOptions, String, String)	Foco em um aplicativo de área de trabalho específico ou uma página da Web para uso na automação de interface gráfica, identificado pelo nome de tela no Repositório de Objetos.
Attach(TargetAppModel, TargetAppOptions)	Foco em um aplicativo de área de trabalho específico ou página da web para usar na automação de interface gráfica, identificado pelo objeto TargetAppModel .
Attach(String, String, String, NAppAttachMode, NWindowResize, NInteractionMode)	Foco em um aplicativo de área de trabalho específico ou página da Web para uso 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.

Attach(String, TargetAppOptions, String, String)

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

Attach(
    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 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.

Attach(TargetAppModel, TargetAppOptions)

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

Attach(
    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 String - Um fragmento XML que armazena os atributos de um elemento da interface do usuário.
• FilePath String — se o aplicativo não for um navegador da web, especifica o caminho completo do arquivo executável a ser aberto.
• Arguments String - 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 String - Se o aplicativo for um navegador da Web, especifica a URL da página da Web a ser aberta.
• Title String - O título do aplicativo ou navegador.

targetAppOptions 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.

Attach(String, String, String, NAppAttachMode, NWindowResize, NInteractionMode)

Foco em um aplicativo de área de trabalho específico ou página da Web para uso 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.

Attach(string screenName,
    [string appName],
    [string appVersion],
    [NAppAttachMode appAttachMode],
    [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.

appAttachMode NAppAttachMode

• ByProcessName — as APIs adicionais pesquisarão em todas as janelas com o mesmo nome de processo que o aplicativo indicado.
• ByInstance — outras APIs pesquisarão na instância do aplicativo indicada, incluindo todas as janelas pai e filho (alertas, pop-ups, etc.). Outras instâncias do aplicativo são excluídas.
• SingleWindow - Outras APIs pesquisarão apenas na janela indicada.

windowResize NWindowResize

Escolha o tamanho da janela:

• Nenhum
• Maximizar
• Restaurar
• Minimizar

interactionMode 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.