Automatizar utilizando elementos da IU

Os fluxos de ambiente de trabalho usam elementos de interface para interagir com aplicações e páginas web, por isso não precisam de reconhecer imagens ou coordenadas absolutas. A maioria das ações de automação da interface e do navegador utiliza elementos da interface como entrada para identificar elementos específicos nas janelas e páginas web.

Elementos da IU

Quando implementas uma ação de automação de UI ou de automação de navegador, podes precisar de fornecer um elemento de UI como entrada. Para adicionar um novo elemento de interface, podes adicioná-lo diretamente a partir das propriedades de ação ou através do painel de elementos UI do designer de fluxos.

Cada um destes grupos de ações aceita um tipo diferente de elementos da IU. As ações de automatização da IU aceitam elementos da IU de ambiente de trabalho, enquanto as ações de automatização do browser aceitam elementos da IU Web.

Para adicionar um novo elemento de IU ao seu fluxo, adicione um novo elemento de IU através de uma ação ou do painel de elementos da IU, realce o respetivo elemento e prima Ctrl + Clique esquerdo do rato. Quando a seleção estiver terminada, selecione Concluído.

Quaisquer elementos da interface capturados são adicionados ao painel de elementos da interface. Para aceder ao painel de elementos da IU, selecione o separador Elementos da IU no lado direito do estruturador de fluxos.

Podes ordenar os elementos alfabeticamente através da opção Ordenar do separador de elementos da interface. Para remover todos os elementos da interface que não são usados em nenhuma ação, selecione o ícone dos pontos ao lado da opção Ordenar e depois Remover elementos da interface não utilizados.

Para renomear ou eliminar um elemento da IU, clique no item respetivo e selecione a função adequada.

Para encontrar onde um elemento específico da interface é usado no fluxo, clique com o botão direito e selecione Encontrar utilizações. Os resultados mostram todas as ações que utilizam este elemento da interface. Clique duas vezes num resultado para realçar a ação na área de trabalho.

Tipos de elementos UI

Os fluxos de ambiente de trabalho suportam dois tipos de elementos da IU com base na sua origem: elementos da IU de ambiente de trabalho e elementos da IU Web.

Pode capturar elementos da interface de trabalho de qualquer aplicação Windows, incluindo componentes não relacionados com páginas web dos navegadores, como a barra de endereços. Dentro dos elementos da interface do ambiente de trabalho, são suportados três tipos de seletores:

• Seletores de Automatização da Interface de Utilizador (UIA)

  UIA é o framework moderno de acessibilidade introduzido pela Microsoft para substituir o MSAA. É a tecnologia recomendada para automatizar a maioria das aplicações Windows, especialmente aquelas construídas com frameworks de interface mais recentes como WPF, WinForms e Plataforma Universal do Windows (UWP). A UIA oferece informações sobre elementos mais robustas e detalhadas, estruturas hierárquicas melhoradas e maior fiabilidade em cenários de automação.

  Use os seletores UIA sempre que possível para melhor desempenho, manutenibilidade e suporte em aplicações de ambiente de trabalho modernas.

• seletores de Microsoft Active Accessibility (MSAA)

  A MSAA é uma tecnologia de acessibilidade mais antiga que antecede a UIA. É usado principalmente para aplicações legadas que não expõem elementos UIA, como aplicações Windows mais antigas construídas com tecnologias como VB6 ou o clássico Win32. Embora o MSAA forneça menos detalhe e estrutura do que o UIA, é essencial para permitir a automação em ambientes onde o UIA não está disponível.

  Use seletores MSAA ao direcionar aplicações legadas ou personalizadas que não expõem os seus componentes de interface através da UIA.

• Seletores brutos do UIA3

  UIA3 Raw é um modo avançado de captura baseado em Automatização da Interface de Utilizador que utiliza o framework UIA3 para aceder à árvore bruta e não filtrada de elementos da UI. Ao contrário dos seletores UIA padrão, que dependem de uma visão de controlo refinada da aplicação, o UIA3 Raw expõe todos os elementos da hierarquia da UI, incluindo componentes intermédios, não interativos e ao nível da framework.

  Este modo é particularmente útil para automatizar aplicações com estruturas de interface complexas ou não padrão, como controlos personalizados, aplicações baseadas em Electron, ou casos em que elementos não são acessíveis através de seletores UIA padrão. O UIA3 Raw pode revelar camadas e propriedades hierarquicas adicionais que de outra forma não estariam disponíveis, permitindo um direcionamento mais preciso em cenários desafiantes.

  Use seletores UIA3 Raw quando os seletores UIA não conseguem capturar ou identificar elementos de forma fiável, ou quando for necessário acesso mais profundo à estrutura da interface da aplicação.

O seletor de elementos da interface nas ações de automação permite capturar apenas elementos da interface da área de trabalho. Um menu de modo de captura no canto superior direito do seletor permite-lhe selecionar entre os modos UIA, UIA3 Raw e MSAA. Por defeito, o seletor usa UIA, mas podes mudar para UIA3 Raw para cenários avançados ou MSAA ao automatizar aplicações legadas. Uma mensagem visível no seletor indica quando um modo não predefinido está ativo.

O painel de elementos da interface mostra os elementos capturados, com um indicador que indica se os elementos foram capturados usando UIA, UIA3 Raw ou MSAA. Este indicador ajuda-te a identificar o tipo de seletor usado para cada elemento do teu fluxo.

Pode capturar elementos da interface web a partir de páginas web e usá-los apenas em ações de automação do navegador.

As ações de automatização do browser aceitam exclusivamente elementos da IU capturados a partir de páginas Web. Portanto, o seletor de elementos da interface destas ações não mostra elementos existentes capturados a partir de aplicações de ambiente de trabalho.

Para mais informações sobre automação desktop e web, consulte Automatizar fluxos de desktop e Automatizar fluxos web.

Elementos da interface do utilizador para páginas da Web

Para capturar um elemento da IU a partir de uma página Web, precisa de instalar a extensão do browser apropriada. Para mais informações sobre navegadores suportados e a extensão necessária, consulte Usar navegadores e gerir extensões.

Distinguir os elementos da interface de desktop dos da interface web

O painel de elementos da interface mostra indicações visuais distintas para o ajudar a reconhecer rapidamente a diferença entre elementos da interface de ambiente de trabalho e da interface web.

Quando capturas um elemento do ambiente de trabalho, o ícone do ambiente de trabalho aparece. Quando capturas um elemento web, aparece o ícone web. Desta forma, confirmas o tipo de elemento antes de o guardar.

Outro método de verificar o tipo de um elemento da IU é rever os seus seletores. Normalmente, os elementos da IU têm o ambiente de trabalho como elemento principal, enquanto os elementos da IU Web têm uma página Web como elemento raiz.

Elementos da interface nas janelas do navegador

Automatize a parte da aplicação de um navegador (1) utilizando elementos da interface de utilizador do ambiente de trabalho. Por exemplo, utilize ações de automatização da IU para interagir com a barra de endereço ou com os separadores.

Por outro lado, automatize as páginas web carregadas dentro do navegador (2) usando elementos da interface web e ações de automação do navegador.

Durante a gravação, o gravador distingue automaticamente a área da aplicação do navegador das páginas web e gera os elementos e ações de interface apropriados.

As interações com elementos de interface de utilizador da Web com funcionalidade de arrastar e largar podem não funcionar como esperado devido às limitações inerentes. Como solução, capture elementos da IU de ambiente de trabalho numa página Web abrindo o seletor de elementos de IU através de uma ação do grupo de automatização da IU selecionando Adicionar elemento da IU no parâmetro UI element. O elemento da IU capturado é do tipo ambiente de trabalho e pode ser utilizado na ação Drag and drop UI element in window. Tenha em mente que só pode usar elementos da interface de trabalho em ações do grupo de ações de automação de UI do Power Automate for desktop. É importante notar que os elementos da interface de utilizador do ambiente de trabalho nas páginas Web não são tão fiáveis como os seus equivalentes Web e estão sujeitos a características específicas da aplicação do browser, como a respetiva versão.

Propriedades de elementos da IU

Todos os elementos da IU são compostos por um ou mais seletores que identificam o componente de IU ou Web com que o Power Automate interage.

Para gerir os seletores de um elemento da IU, clique com o botão direito do rato nele e selecione Editar. Esta opção abre o construtor de seletores, onde pode editar os seletores com um editor visual ou de texto.

Cada seletor é composto por vários elementos que representam a estrutura hierárquica do elemento da IU na aplicação ou página web. Os atributos descrevem cada elemento de forma exclusiva e distinguem-no dos outros elementos.

Todos os seletores são apresentados com um nome amigável predefinido que os torna facilmente acessíveis. Para mudar o nome de um seletor, clique com o botão direito do rato no respetivo nome e selecione Mudar o nome.

Quando editas um elemento da interface com múltiplos seletores, podes desativar um seletor clicando com o botão direito e selecionando Desabilitar. Esta funcionalidade pode ser útil durante os testes.

Depois de editar os seletores, selecione Guardar para aplicar as alterações. Guardar aplica as alterações em todos os seletores num único passo.

Para mais informações sobre seletores e como os construir manualmente, consulte Construir um seletor personalizado.

Elementos da IU com seletores baseados em texto

Para além do método padrão para gerar seletores para elementos da interface, o Power Automate suporta a criação de seletores com base no valor de texto de um elemento.

Esta caraterística é útil para cenários de automatização que fazem o tratamento de elementos em aplicações de ambiente de trabalho ou páginas web que têm sempre textos específicos. Os seletores baseados nestes textos são mais fiáveis e resilientes a possíveis alterações futuras na estrutura da aplicação ou da página web.

Só podes gerar seletores baseados em texto ao capturar elementos da interface usando o seletor de elementos da interface (painel de elementos da interface ou ações de automação do navegador/interface). Não consegues gerá-los durante a gravação.

Para capturar um elemento da interface com um seletor baseado em texto, abra o seletor de elementos da interface, clique com o botão direito no elemento desejado e selecione Capturar com base no texto.

Depois, aparece uma nova janela com dois campos no ecrã:

• O campo Valor de texto contém o texto do elemento como um valor proposto. Pode alterar este valor para um valor codificado ou variável.
• Pode definir o campo Operador para vários operadores para ajustar a funcionalidade do seletor.

Selecionar Capturar adiciona o elemento UI com o seletor de texto adequado no repositório de elementos UI.

Os seletores baseados em texto utilizam o atributo Nome do elemento capturado para a automatização do ambiente de trabalho e o atributo Texto para a automatização do browser. Só estão disponíveis para elementos da IU que contenham um valor de texto.

Em outras palavras, eles estão disponíveis para elementos de UI com um atributo Name ou Text que inclui um valor. Não estão disponíveis para elementos que não tenham esse valor de texto, mesmo que tenham elementos subordinados com texto na respetiva estrutura.

Problemas e limitações conhecidos

• Se selecionares Adicionar elemento UI, passares o rato sobre uma janela e escolheres capturar um elemento UI por texto, o processo gera um seletor padrão. Este seletor inclui o atributo Processo juntamente com Nome.

• Quando usas uma variável com um operador diferente de Igual a, o editor de texto personalizado mostra o seletor em vez do construtor visual. Esta funcionalidade evita uma limitação que torna a combinação acima não funcional no construtor visual.