- Visão geral
- Automação de Interface Gráfica
- Aplicativos e tecnologias automatizados com a Automação de Interface Gráfica
- Compatibilidade do projeto
- UI-ANA-016 - Extrair URL de navegador aberto
- UI-ANA-017 - ContinuarComErro verdadeiro
- UI-ANA-018 - Listar atividades de OCR/Imagem
- UI-DBP-006 - Uso do contêiner
- UI-DBP-013 - Uso Incorreto da Automação do Excel
- UI-DBP-030 - Uso de variáveis proibidas em seletores
- UI-PRR-001 - Simular clique
- UI-PRR-002 - Simular Digitação
- UI-PRR-003 - Uso incorreto do aplicativo aberto
- UI-PRR-004 - Atrasos Embutidos em Código
- UI-REL-001 - Idx grande em Seletores
- UI-SEC-004 - Dados de e-mail do seletor
- UI-SEC-010 — restrições de app/URL
- UI-USG-011 - Atributos não permitidos
- UX-SEC-010 — restrições de app/URL
- UX-DBP-029 - Uso de senha não segura
- UI-PST-001 - Nível de log de auditoria nas configurações do projeto
- Ferramenta de Migração de Navegador do UiPath
- Região do Recorte
- Computer Vision Recorder
- Ativar
- Anchor Base
- Anexar Navegador
- Anexar Janela
- Block User Input
- Texto Explicativo
- Marcar
- Click
- Clicar na Imagem
- Click Image Trigger
- Click OCR Text
- Clicar no Texto
- Click Trigger
- Close Application
- Fechar Guia
- Close Window
- Context Aware Anchor
- Copy Selected Text
- Element Attribute Change Trigger
- Element Exists
- Element Scope
- Element State Change Trigger
- Export UI Tree
- Extrair Dados Estruturados
- Find Children
- Localizar Elemento
- Localizar Imagem
- Find Image Matches
- Find OCR Text Position
- Localizar Elemento Relativo
- Find Text Position
- Get Active Window
- Get Ancestor
- Get Attribute
- Get Event Info
- Get From Clipboard
- Obter Texto Completo
- Get OCR Text
- Get Password
- Get Position
- Get Source Element
- Get Text
- Obter Texto Visível
- Voltar
- Avançar
- Ir para a Página Inicial
- Google Cloud Vision OCR
- Hide Window
- Highlight
- Hotkey Trigger
- Hover
- Focalizar Imagem
- Hover OCR Text
- Focalizar Texto
- Imagem Existe
- Indicate On Screen
- Inject .NET Code
- Inject Js Script
- Invoke ActiveX Method
- Key Press Trigger
- Carregar Imagem
- Maximize Window
- Microsoft Azure Computer Vision OCR
- Microsoft OCR
- Microsoft Project Oxford Online OCR
- Minimize Window
- Monitorar eventos
- Mouse Trigger
- Move Window
- Navegar Para
- OCR Text Exists
- On Element Appear
- On Element Vanish
- Aparecer Na Imagem
- Desaparecer Na Imagem
- Abrir Aplicativo
- Abrir Navegador
- Atualizar Navegador
- Replay User Event
- Restore Window
- Save Image
- Select Item
- Select Multiple Items
- Enviar Tecla de Acesso
- Set Clipping Region
- Set Focus
- Set Text
- Set To Clipboard
- Set Web Attribute
- Show Window
- Iniciar Processo
- System Trigger
- Take Screenshot
- Tesseract OCR
- Texto Existe
- Dica de ferramenta
- Type Into
- Digitar Texto Seguro
- Use Foreground
- Wait Attribute
- Esperar Elemento Desaparecer
- Aguardar Imagem Desaparecer
- Application event trigger
- Check/Uncheck
- Check App State
- Check Element
- Click
- Click Event Trigger
- Fechar pop-up
- Drag and Drop
- Extract Table Data
- For Each UI Element
- Get Attribute
- Get Browser Data
- Get Text
- Get URL
- Go To URL
- Highlight
- Hover
- Inject Js Script
- Keyboard Shortcuts
- Keypress Event Trigger
- Mouse Scroll
- Navigate Browser
- Select Item
- Set Browser Data
- Set Runtime Browser
- Set Text
- Take Screenshot
- Type Into
- Use Application/Browser
- Realize pesquisa no navegador e recupere resultados usando APIs de Automação de interface gráfica
- Navegação na Web
- Localizar imagens
- Clicar em imagens
- Disparar e monitorar eventos
- Criar e substituir arquivos
- Páginas HTML: extrair e manipular informações
- Manipulação de janelas
- Seleção automatizada de listas
- Localizar e manipular elementos de janela
- Gerenciar automação de texto
- Carregar e processar imagens
- Gerenciar ações ativadas pelo mouse
- Automatizar o runtime de aplicativos
- Execução automatizada de um aplicativo local
- Navegação em navegador
- Automação da Web
- Exemplo de escopo de disparador
- Computer Vision Local Server
- Automação Móvel
- Notas de versão
- Compatibilidade do projeto
- Get Log Types
- Get Logs
- Get Page Source
- Get Device Orientation
- Get Session Identifier
- Instalar Aplicativo
- Gerenciar Aplicativo Atual
- Manage Other App
- Open DeepLink
- Abrir URL
- Mobile Device Connection
- Deslizar Direcional
- Padrão de Desenho
- Positional Swipe
- Press Hardware Button
- Set Device Orientation
- Take Screenshot
- Obter parte da captura de tela
- Element Exists
- Execute Command
- Get Attribute
- Get Selected Item
- Get Text
- Set Selected Item
- Set Text
- Deslizar
- Tap
- Type Text
- Terminal
- Notas de versão
- Sobre o pacote de atividades Terminal
- Compatibilidade do projeto
- Melhores práticas
- Find Text
- Get Color At Position
- Get Cursor Position
- Get Field
- Obter Campo na Posição
- Obter Área da Tela
- Get Text
- Obter Texto na Posição
- Mover Cursor
- Mover cursor para o texto
- Enviar Tecla de Controle
- Send Keys
- Send Keys Secure
- Set Field
- Definir Campo na Posição
- Terminal Session
- Aguardar Texto do Campo
- Aguardar Texto da Tela
- Aguardar Texto na Posição
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.
uiAutomation.API()
. Por exemplo, uiAutomation.Open()
.
Namespace: UiPath.UIAutomationNext.API.Contracts
Assembly: UiPath.UIAutomationNext.API.Contracts (in UiPath.UIAutomationNext.API.Contracts dll)
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. |
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])
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 seFilePath
ouURL
forem fornecidos)Always
(abre outra instância do aplicativo mesmo se uma já estiver aberta, só funciona seFilePath
ouURL
forem fornecidos)
WindowResize NWindowResize
- escolha o tamanho da janela:Nenhum
Maximizar
Restaurar
Minimizar
UserDataFolderMode BrowserUserDataFolderMode
- OUserDataFolderMode
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 seUserDataFolderPath
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 emUserDataFolderPath
ou um caminho gerado automaticamente seUserDataFolderPath
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
- insiraTrue
se você quiser abrir o navegador no modo anônimo. Por padrão, ele é definido comoFalse
.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.
TargetAppModel
.
Open(
TargetAppModel targetApp,
[TargetAppOptions targetAppOptions])
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 seFilePath
ouURL
forem fornecidos)Always
(abre outra instância do aplicativo mesmo se uma já estiver aberta, só funciona seFilePath
ouURL
forem fornecidos)
WindowResize NWindowResize
- escolha o tamanho da janela:Nenhum
Maximizar
Restaurar
Minimizar
UserDataFolderMode BrowserUserDataFolderMode
- OUserDataFolderMode
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 seUserDataFolderPath
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 emUserDataFolderPath
ou um caminho gerado automaticamente seUserDataFolderPath
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
- insiraTrue
se você quiser abrir o navegador no modo anônimo. Por padrão, ele é definido comoFalse
.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.
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])
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âmetroUrl
estiver configurado)Always
— (abrir outra instância do aplicativo mesmo se uma já estiver aberta, funciona apenas se o parâmetroUrl
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 .
Para operar WebDriverMode em uma configuração sem periféricos, essas etapas podem servir como um guia.
uiAutomation.Open
para 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 webDriverMode
como NWebDriverMode.Headless
.
O código correspondente fica assim:
var screen = uiAutomation.Open(Descriptors.NewApplication.Edge, Options.AppOpen().WithBrowserOptions(webDriverMode: NWebDriverMode.Headless));
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.