Sobre o repositório de objetos

O Repositório de Objetos garante o gerenciamento, a reusabilidade e a confiabilidade dos elementos de interface gráfica, capturando-os como objetos em repositórios parecidos com o DOM, que possam ser compartilhados entre os projetos. Permite criar e reusar taxonomias de interface gráfica dentro e entre projetos de automação. Com o Repositório de Objetos, é possível criar uma API de interface gráfica para seu aplicativo e compartilhá-la com sua equipe em minutos.

Os recursos principais do Repositório de Objetos são:

• Os elementos de Interface Gráfica no projeto são gerenciados, atualizados e modificados a partir de um local centralizado.
• visualize uma lista de todas as suas atividades de Interface Gráfica em seu processo, usando a guia UI Activities no painel Repositório de Objetos.
• capture rapidamente os elementos de que precisa em sua automação com o assistente Capture Elements.
• maior confiabilidade do seletor com a ajuda do gravador Capture Elements, que captura elementos com suas âncoras.
• com a ajuda de âncoras, os objetos mantêm sua confiabilidade caso o aplicativo tenha recebido uma Interface Gráfica ligeiramente nova.
• elementos para arrastar e soltar no painel Repositório de Objetos.
• objetos são reusáveis em projetos locais ou entre projetos quando entregues como bibliotecas.

• Fazer upgrade de aplicativos e processar elementos de interface gráfica de uma só vez com as bibliotecas de interface gráfica.

  
  

  

  
  

Pré-requisitos

O Repositório de Objetos funciona com as versões 20.20.x e posteriores do pacote UiPath.UIAutomation.Activities em projetos que usam a Experiência de Design Moderna. Observe que o pacote UiPath.UIAutomationNext.Activities foi descontinuado a partir da versão 20.10. As atividades do UI Automation Next agora podem ser encontradas no pacote de Automação de Interface Gráfica. O Repositório de Objetos não está disponível em projetos multiplataforma.

A alternância Usar Moderna para projetos novos controla a experiência de design padrão para novos projetos. A experiência moderna é uma nova maneira de desenvolver automações com assistentes, gravadores e atividades que fazem parte de pacotes aprimorados para obter suporte para o Repositório de Objetos. Essa alternância ocorre em âmbito global, ou seja, se estiver habilitada todos os novos projetos são criados dentro do contexto da experiência moderna de design.

Quando a alternância do Repositório de Objetos aplicado estiver definida como Sim, as atividades que fazem parte do pacote UIAutomation precisam fazer referência a elementos do Repositório de Objetos.

Também há uma alternância de "Experiência Moderna" no nível do projeto. Se estiver habilitada, o projeto atual opera no contexto da experiência moderna de design. Em uma experiência moderna de design, por padrão, as atividades UI Automation clássicas ficam ocultas. Para habilitá-las, utilize os filtros existentes no Painel de Atividades. Alternativamente, nas configurações do projeto, sempre será possível mudar para a Experiência Clássica em relação a um projeto específico. Outra possibilidade é mudar o comportamento em relação a novos projetos a partir da configurações de backstage do Studio.

Conceitos-chave

Descritores de UI

Um Descritor de interface gráfica é um superconjunto de seletores. Ele contém informações de elementos de identificação exclusiva na tela.

Os Descritores de interface gráfica são extraídos das atividades no fluxo de trabalho e adicionados a um esquema estruturado. Esse esquema os agrupa por Aplicativos, Versões de de Aplicativos, Telas e Elementos de Interface Gráfica. Fora dessa estrutura taxonômica, somente Telas e Elementos contém informações de descritores. Os demais são usados para agrupar, sendo sua função a de assegurar os upgrades entre as versões de um aplicativo.

Os Descritores de Interface Gráfica podem integrar:

• um projeto para amplo reuso.
• repositórios de fragmentos para fins de teste.
• Bibliotecas de Interface Gráfica para compartilhamento global entre projetos.

Elementos de Interface Gráfica

Os Elementos de Interface Gráfica contêm seletores de elementos totais ou parciais, seletores de âncoras, tela e contexto de captura de imagens de elementos e outros metadados que descrevem os elementos na tela.

Telas

As telas são Escopos de interface gráfica, extraídas das atividades dentro do fluxo de trabalho ou geradas no momento da captura do elemento. Uma tela agrupa vários elementos que pertencem à mesma tela juntos.

Aplicativos de Interface Gráfica

Um Aplicativo de Interface Gráfica é um aplicativo direcionado que pode ter várias versões, podendo cada uma delas ter várias telas. Os aplicativos podem ser de vários tipos:

• Aplicativo da Área de Trabalho/Web
• Aplicativo Móvel

Para definir os aplicativos móveis, é necessário usar o pacote UiPath.MobileAutomation.Activities.

A estrutura das bibliotecas de interface gráfica criada com o Navegador de Objetos tem a seguinte hierarquia: Aplicativo > Versão > Tela > Elemento de Interface Gráfica.

Bibliotecas de UI

Uma Biblioteca de Interface é um encapsulamento de elementos agrupados por aplicativos, versões de aplicativos e telas. Os elementos que você define podem ser extraídos como uma Biblioteca de Interface Gráfica e, após sua publicação, eles pode ser instalados em outros projetos como uma dependência.

Uma Biblioteca de Interface Gráfica pode conter vários aplicativos, mas somente uma versão de de um determinado aplicativo. Tal mecanismo assegura que, ao fazer o upgrade de uma dependência, você também faça o upgrade da versão do aplicativo que estiver usando em seus projetos.

Observe que, ao criar uma versão de um aplicativo existente, será necessário reusar os elementos existentes. Os elementos têm identificadores exclusivos, os quais são usados quando mencionados nas atividades. Você sempre poderá alterar o conteúdo de um elemento (descritores e outros metadados).

Reutilização

O Repositório de Objetos permite reusar os elementos de Interface Gráfica entre os projetos:

• todos os elementos armazenados localmente podem ser reutilizados no nível do projeto
• para fins de teste, é possível usar o painel Fragmentos onde salvar e passar os aplicativos entre os projetos. Em Fragmentos é possível adicionar aplicativos ao repositório de projetos locais.

• extraia os elementos para as bibliotecas de Interface Gráfica, instalando-os como dependência em seus projetos sempre que quiser reusá-los em nível global. Além disso, é possível adotar uma abordagem de reusar primeiro e começar pela criação de Bibliotecas de Interface Gráfica com elementos que serão necessários por todos os seus projetos de automação.

  
  

  

  
  
  
  

  

  
  

Estrutura do Repositório de Objetos

O repositório de objetos tem uma estrutura de árvore, na qual cada nó é um objeto que representa telas ou elementos, todos de maneira hierárquica no aplicativo. A estrutura é a seguinte:

• Aplicativo ─ pode ser de dois tipos: móvel ou de área de trabalho/Web, dependendo da tecnologia usada para Automação de Interface Gráfica.
• Versão ─ os aplicativos podem ter várias versões
• Tela ─ janela de nível superior da versão de um aplicativa, a qual somente pode ser criada em uma versão do app.
• Elemento de Interface Gráfica ─ um objeto na tela com um descritor e metadados. O Elemento pode ser de vários tipos.

Os Elementos de Interface Gráfica podem ser reorganizados livremente na estrutura da árvore, desde que permaneçam sobe a tela designada. Para movê-los, basta arrastar e soltar o elemento no local desejado dentro da árvore.

Os elements podem, ainda, fazer parte de outros elements e também podem ser agrupados em contêineres sem qualquer função específica na Interface Gráfica. Isso permite a definição de uma estrutura de interface gráfica que fique o mais próxima possível do que o usuário verá na tela.