- 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
Focalizar Imagem
UiPath.Core.Activities.HoverImage
Pesquisa uma imagem em um elemento de interface gráfica e passa o mouse sobre ela.
Entrada
- Imagem.Imagem - Uma imagem existente a ser pesquisada. Este campo é compatível apenas com variáveis Imagem.
- Imagem.Precisão - Uma unidade de medida de 0 a 1 que expressa a semelhança mínima entre a imagem que procurada e a localizada. Útil em situações em que a imagem a ser encontrada é ligeiramente diferente daquela que você está procurando. O valor padrão é 0,8.
- Imagem.Perfil - Permite alterar o algoritmo de detecção de imagem que você deseja usar. Básico é o algoritmo clássico, que apresenta velocidade e custo de recursos médios. Aprimorado pode oferecer resultados mais precisos à custa de mais recursos. Por padrão, este campo é definido como Básico.
- Target.Selector - Propriedade de texto usada para localizar um determinado elemento da interface do usuário quando a atividade é executada. Na verdade, é um fragmento XML especificando atributos do elemento GUI que você está procurando e de alguns de seus pais.
- Target.TimeoutMS - Especifica a quantidade de tempo (em milissegundos) para aguardar a execução da atividade antes que o erro
SelectorNotFoundException
seja lançado. O valor padrão é 30000 milissegundos (30 segundos). -
Target.WaitForReady - Antes de executar as ações, aguarde o destino ficar pronto. As seguintes opções estão disponíveis:
- Nenhum — não espera por nada, exceto o elemento de interface gráfica do alvo existir antes de executar a ação. Por exemplo, você pode usar essa opção se quiser recuperar apenas o texto de uma página web ou clicar em um botão específico, sem precisar esperar todos os elementos da interface gráfica carregarem. Observe que isso pode ter consequências indesejadas se o botão depender de elementos ainda não carregados, como scripts.
-
Interativo/completo - espera que todos os elementos da interface do usuário no aplicativo de destino existam antes de executar a ação.
Para avaliar se um aplicativo está no estado Interativo ou Concluído, as seguintes tags são verificadas:
- Aplicativos de área de trabalho — uma mensagem
wm_null
é enviada para verificar a existência das tags,<wnd>
,<ctrl>
,<java>
ou.<uia>
Se existirem, a atividade é executada. - Aplicativos web:
- Internet Explorer - A tag
<webctrl>
é usada para verificar se o estado Pronto do documento HTML está definido como Concluído. Além disso, o estado Ocupado deve ser definido como “Falso”. - Outros - A tag
<webctrl>
é usada para verificar se o estado Pronto do documento HTML está Concluído.
- Aplicativos SAP — primeiro a presença da tag
<wnd>
é verificada e, depois disso, uma API específica do SAP é usada para detectar se a sessão está ocupada ou não.
- Target.Element - Use a variável UiElement retornada por outra atividade. Esta propriedade não pode ser usada junto com a propriedade Selector. Este campo suporta apenas variáveis UiElement.
- Target.ClippingRegion - Define o retângulo de recorte, em pixels, relativo ao UiElement, nas seguintes direções: esquerda, superior, direita, inferior. Ele suporta números positivos e negativos.
Opções
- EnviarMensagensDaJanela - Se esta caixa de seleção estiver selecionada, o foco é executado enviando uma mensagem específica para o aplicativo de destino. Este método de entrada é mais rápido e funciona em segundo plano. Por padrão, esta caixa de seleção fica desmarcada. Se a caixa de seleção não estiver selecionada, o método padrão executará o foco usando o driver de hardware. O método padrão é o mais lento e não funciona em segundo plano, porém é compatível com todos os aplicativos de desktop.
-
KeyModifiers - permite adicionar um modificador de chave. As seguintes opções estão disponíveis: Alt, Ctrl, Shift, Win.
Observação: ModificadoresDeTecla não pode ser usado com a opção EnviarMensagensDaJanela. Nenhum erro é gerado ao executar um fluxo de trabalho que contém uma atividade com essa combinação de opções. - PosiçãoDoCursor.DeslocamentoX - Deslocamento horizontal da posição do cursor de acordo com a opção selecionada no campo Posição.
- PosiçãoDoCursor.DeslocamentoY - Deslocamento vertical da posição do cursor de acordo com a opção selecionada no campo Posição.
- PosiçãoDoCursor.Posição - Descreve o ponto inicial do cursor ao qual são adicionados os deslocamentos das propriedades DeslocamentoX e DeslocamentoY. As seguintes opções estão disponíveis: SuperiorEsquerda, SuperiorDireita, InferiorEsquerda, InferiorDireita e Centro. A opção padrão é Centro.
Comum
- NomeDeExibição - o nome de exibição da atividade.
- DelayMS - Tempo de atraso (em milissegundos) após a execução da atividade. A quantidade de tempo padrão é 300 milissegundos.
- DelayBefore - Tempo de atraso (em milissegundos) antes que a atividade comece a executar qualquer operação. A quantidade de tempo padrão é 200 milissegundos.
-
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.
Diversos
- Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.
A atividade Hover Image é usada para pesquisar uma imagem dentro de um elemento da interface gráfica e passar o mouse sobre ela.
Para exemplificar como usar esta atividade, criamos um exemplo que abre um navegador, passa o mouse sobre uma imagem, inicia uma ação e exibe os resultados relacionados a essa ação.
É assim que um processo de automação pode ser construído:
- Abra o Studio e crie um Processo.
- Arraste uma atividade Sequence para o Designer de fluxo de trabalho.
-
Arraste uma atividade Open Browser dentro do contêiner Sequência.
- No painel Propriedades, selecione a opção
IE
na lista suspensa TipoDeNavegador. - Adicione a expressão
"https://www.goodreads.com/book/show/7144.Crime_and_Punishment"
no campo Url. - Marque a caixa de seleção para a opção NovaSessão. Essa opção abre uma nova sessão do navegador selecionado.
- No painel Propriedades, selecione a opção
-
Arraste uma atividade Hover Image para dentro do contêiner Corpo da atividade Open Browser.
- Abra o endereço do site adicionado anteriormente na atividade Open Browser.
- Selecione o botão Clique para abrir o menu de opções a partir da atividade Hover Image em clique na opção Capturar da tela. Selecione a imagem desejada.
-
Arraste uma atividade Click Image para baixo da atividade Hover Image.
- No painel Propriedades, selecione a opção
CLICK_SINGLE
na lista suspensa TipoDeClique. - Selecione a opção
BTN_LEFT
na lista suspensa BotãoDoMouse. - Selecione a opção
Target
na lista suspensa Destino. - Adicione a expressão
"<html title='*' /><webctrl aaname='Other editions' parentid='imagecol' tag='A' />"
ao campo Seletor. - Selecione a opção
INTERACTIVE
na lista suspensa AguardarAtéEstarPronto.
- No painel Propriedades, selecione a opção
-
Execute o processo. O robô abre um novo navegador, acessa o site, passa o mouse sobre a imagem selecionada e clica no botão Outras edições.