Focalizar Imagem

UiPath.Core.Activities.HoverImage

Pesquisa uma imagem em um elemento de interface gráfica e passa o mouse sobre ela.

Propriedades

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.
• Destino.Seletor - Propriedade de texto usada para localizar um determinado elemento de interface gráfica quando a atividade é executada. Em realidade, é um fragmento XML especificando atributos do elemento GUI procurado e de alguns de seus pais.
• Destino.TempoLimiteEmMs - Especifica o período (em milissegundos) que se deve aguardar para a execução da atividade antes de gerar o erro SelectorNotFoundException. O valor padrão é de 30.000 milissegundos (30 segundos).
• Target.WaitForReady - Antes de executar as ações, aguarda 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 gráfica no aplicativo de destino existam antes de executar, de fato, 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:
  1. 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”.
  2. 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 ElementoDaUI retornada por outra atividade. Essa propriedade não pode ser usada com a propriedade Seletor. Esse campo é compatível apenas com variáveis ElementoDaUI.
• Destino.RegiãoDeRecorte - Define o retângulo de clipagem, em pixels, em relação ao ElementoDaUi, conforme as seguintes direções: esquerda, superior, direita, inferior. 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.
• ModificadoresDeTecla - Habilita você a adicionar um modificador de tecla. 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

• DisplayName - O nome de exibição da atividade.

• AtrasoEmMs - Tempo de espera (em milissegundos) após executar a atividade. O período padrão é 300 milissegundos.

• AtrasoAntes - Tempo de atraso (em milissegundos) antes de a atividade começar a realizar qualquer operação. O período padrão é 200 milissegundos.

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

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Exemplo de uso da atividade Hover Image

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:

1. Abra o Studio e crie um Processo.
2. Arraste uma atividade Sequence para o Designer de fluxo de trabalho.
3. 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.
4. 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.
5. 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.
6. 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.

Baixe o exemplo