Como criar um repositório de objetos

Importante: o Repositório de Objetos funciona com as versões 20.10 e superiores do UiPath.UIAutomation.Activities ou MobileAutomation.Activities nos projetos com a opção Experiência Moderna de Design habilitada.

Um repositório de objetos é uma coleção de elementos agrupados por aplicativos, versões e telas que podem vir de um(a):

• projeto local, ou seja, o repositório local.
• biblioteca, ou seja Dependências da Biblioteca da Interface Gráfica do projeto atual.

Um Repositório Local pode ser criado:

• usando o gravador Caputar Elementos para capturar descritores de interface gráfica.
• manualmente, por meio da criação de aplicativos, telas e elementos diretamente no painel Repositório de Objetos.

Uma Biblioteca de Interface Gráfica pode ser criada:

• extraindo-se o repositório local de qualquer projeto para um projeto de biblioteca, publicando-o como um pacote do NuGet.

• começando de uma nova biblioteca, criando o repositório ali e publicando-o como um pacote do NuGet.

  Assim, você poderá usar os pacotes do Gerenciador NuGet para Biblioteca de Interface Gráfica, adicionando-os como dependências aos seus processos.

  Importante: o gravador Capture Elements grava apenas objetos para reutilização em projetos; o gravador não gera um fluxo de trabalho no painel Designer.

Criação de um Repositório através da Captura de Elementos

Em uma biblioteca ou processo, clique no botão Capturar Elementos no Repositório de Objetos para começar a gravação de objetos.

O gravador Capture Elements utiliza a tecnologia Unified Target de dentro da versão 20.10 e superior do pacote das UIAutomation.Activities para capturar destinos e âncoras com certo nível de precisão em relação a cada seletor, imagem ou âncora.

Os Elementos de interface gráfica são capturados juntos com um Seletor, Seletor Difuso e Imagem, cada qual com um nível de precisão. É possível optar por manter somente um ou todos esses elementos de destino. O mesmo vale para os elementos de âncora associados a cada elemento de interface gráfica no aplicativo.

Propriedades do Descritor

Aplicativos, telas e elementos devem receber nomes descritivos no gravador Capturar Elementos para que sejam facilmente reconhecidos no Repositório de Objetos.

Tipos de Elementos

Os seletores nos aplicativos podem representar botões, caixas de seleção, campos de texto, alternância, caixas de listagem, ou seja, qualquer tipo de elemento que possa interagir com o Robô. O elemento capturado pode ser definido no gravador Capturar Elementos.

Na lista suspensa Tipo, procure e escolha o tipo adequado para cada elemento. No Repositório de Objetos, o elemento recebe um ícone específico para seu tipo, facilitando a diferenciação entre os objetos.

Após capturar os elementos, clique no botão Salvar objetos na biblioteca e eles serão adicionados ao Repositório de Objetos.

Observação:

• Para adicionar elementos adicionais, clique com o botão direito do mouse em uma tela ou elemento no repositório e selecione Criar Elemento. Para adicionar telas adicionais, clique com o botão direito do mouse no aplicativo e selecione Criar tela.
• Para gravar os objetos diretamente sob um aplicativo ou uma tela, clique com o botão direito do mouse em qualquer aplicativo ou tela e, em seguida, selecione Capturar Elementos.

Criação de Repositório a partir do Painel Repositório de Objetos

É possível criar seu próprio repositório de qualquer painel Repositório de Objetos, definindo manualmente o aplicativo, cada tela e elemento.

Criar um Aplicativo de Interface Gráfica

No painel Repositório de Objetos, clique no sinal de mais na guia Descritores ou clique com o botão direito do mouse em Descritores do Projeto na mesma guia e selecione Criar Aplicativo. A janela Criar Aplicativo será aberta:

Adicione um nome de aplicativo, uma versão e uma descrição exclusivos. Clique em Criar aplicativo. Seu aplicativo ficará visível na guia Descritores, em Descritores de Interface Gráfica do Projeto.

Criar uma Tela

Na guia Descritores, selecione seu aplicativo, clique no sinal de mais ou clique com o botão direito do mouse em seu aplicativo e selecione Criar Tela. A janela Adicionar Tela será aberta:

Adicione um nome exclusivo e uma descrição à tela. Indique a tela que deseja automatizar e edite o elemento capturado com o Destino Unificado:

• alterar o caminho do aplicativo, se necessário.

• adicionar argumentos de aplicativo.

  Ao terminar, clique em Criar tela.

Criar um Elemento de Interface Gráfica

Na guia Descritores, selecione a tela de seu app, clique no sinal de mais ou clique com o botão direito do mouse na tela, selecionando Criar Elemento. A janela Adicionar Elementos se abre:

Na seção Tipo de Descritor, clique em Indicar elemento para usar o Destino Unificado para indicar e capturar o elemento da tela.

Adicione um nome intuitivo no campo Nome do Elemento e selecione o tipo de elemento na lista suspensa em Tipo. Clique em Salvar quando estiver concluído.

Observação:

• Para editar um elemento no Repositório de Objetos, clique nele com o botão direito do mouse e selecione Editar Elemento ou clique duas vezes no elemento na árvore.
• Para editar o descritor de um elemento, clique na opção Editar Descritor, na janela Editar Elemento ou clique com o botão direito do mouse no elemento na árvore e, depois, selecione Editar Descritor.

Usando o Repositório de Objetos com Gravadores

Se o Repositório de objetos estiver imposto em sua instância do Studio (de acordo com as instruções na página Sobre o Repositório de objetos), ao usar o Gravador App/Web, as atividades geradas não farão referência automática aos descritores do repositório.

No nível das atividades, uma dica de ferramenta informativa avisa você para adicionar descritores ao Repositório de Objetos ou usar os existentes.

Para tanto, clique no ícone dentro da atividade. Depois, siga os passos para adicionar ou reutilizar os descritores ou selecione Opções > Adicionar ao Repositório de Objetos para adicionar o elemento ao Repositório de Objetos.

Adicionar Elementos das Atividades a um Repositório

Após ter criado um repositório de objetos, é possível adicionar mais elementos de interface gráfica diretamente do painel Designer.

No painel Designer, adicione uma atividade compatível com os seletores como Clique ou Digitar em. Certifique-se que a atividade adicionada esteja dentro de uma atividade Usar Aplicativo/Navegador.

No corpo da atividade, clique no ícone do Repositório de Objetos para abrir a janela Opções de Seleção. Capture o elemento, selecione Confirmar e a janela Adicionar Elemento ao Repositório de Objetos será aberta. Adicione um nome ao elemento e clique em Salvar. Observe que o elemento foi adicionado para o painel Repositório de Objetos.

Usar Objetos no Projeto Atual

No Repositório de Objetos, arraste e solte um aplicativo, tela ou elemento sobre uma atividade de seu fluxo de trabalho. A imagem, os argumentos e outros detalhes do objeto são adicionados automaticamente à atividade.

No exemplo abaixo, arrastamos o objeto MyAppScreen até o alto da atividade Use Application/Browser. O caminho do aplicativo foi adicionado automaticamente à atividade.

Alternativamente, arraste um objeto no alto do sinal de mais, dentro do fluxo de trabalho para abrir uma lista de atividades compatíveis. Selecione a atividade e o objeto será adicionado automaticamente. Dentro do processo, a atividade recebe a seguinte identificação: nome da atividade + nome do objeto.

Depois que o objeto for acionado, a atividade receberá as propriedades do descritor do Repositório de Objetos, visíveis no painel Propriedades da atividade.

• Para editar o descritor, clique em Mostrar no alto do painel de propriedades, para acessar o Repositório de objetos, onde você poderá usar a opção Editar descritor.

• Para remover o vínculo entre a atividade e o Repositório de Objetos, clique em Desvincular, no alto do painel Propriedades. Quando o Repositório de Objetos for aplicado, a desvinculação removerá o destino da atividade.

  
  

  

  
  

Tão logo os objetos forem adicionados ao fluxo de trabalho, a guia Atividades de Interface Gráfica no painel Repositório de Objetos exibe as atividades e objetos contidos ali por ordem hierárquica. Se não estiverem visíveis, salve o projeto e verifique novamente.

Os fluxos de trabalho são marcados:

• com um ponto cinza, se pelo menos uma atividade do arquivo do fluxo de trabalho referir-se a um Decritor de Interface Gráfica do painel Objetos;
• com um ponto azul, se todas as atividades do fluxo de trabalho fizerem referência aos Descritores de Interface Gráfica do painel Objetos.

As atividades de Interface Gráfica são marcadas:

• com um ponto vazio, se a atividade não se referir a um Descritor de Interface Gráfica do painel Objetos.
• com um ponto azul, se fizer referência a um Descritor de Interface Gráfica do painel Objetos.

Editar Descritores

Os descritores podem ser editados a partir do Repositório de Objetos em dois cenários, aos quais iremos referir-nos como edição "on-line" e "off-line":

• edição on-line — tanto o aplicativo quanto o navegador puderem ser acessados na máquina atual. O app/navegador será exibido na tela, permitindo que os elementos sejam novamente selecionados ou alterados.
• edição off-line — não é possível acessar o aplicativo ou navegador na máquina atual, seja porque o app não está instalado ou porque a máquina está desligada. Os seletores de elementos ficam visíveis, o que permite fazer alterações.

Edição On-line

Na guia Descritores, clique com o botão direito do mouse e selecione Editar Descritor. A seleção da tela se abre, o que permite capturar um elemento diferente, editar seletores e âncoras.

O mesmo pode ser feito, clicando-se no botão Editar Descritor, na janela Editar Elemento.

Observação: no runtime, os descritores de interface gráfica são resolvidos a partir do painel Repositório de objetos, se as atividades fizerem referência a esses descritores de interface gráfica.

Edição offline

Os mesmos passos da edição on-line são igualmente aplicáveis neste caso. Na guia Descritores, clique com o botão direito do mouse em uma tela ou elemento e selecione Editar Descritor.

A edição off-line permite fazer alterações diretamente nas configurações do descritor dos elementos. Entretanto, não é possível indicar novos elementos. Para tanto, verifique se o aplicativo/navegador está aberto no estado correto.

Resolver Descritores de Interface Gráfica

Sempre que indicar uma tela ou Elemento de Interface Gráfica que já estiver referenciado no Repositório de Objetos, seja em Descritores de Interface Gráfica do Projeto ou nas Bibliotecas de Interface Gráfica, a correspondência será automaticamente detectada e a seguinte janela aparecerá:

As seguintes opções estão disponíveis:

• Reusar ─ adiciona o descritor correspondente do Repositório de Objetos à atividade atual.
• Criar novo ─ abre a janela de opções para criação de uma tela/elemento ou para atualizar um existente no Repositório de Objetos.
• Cancelar — mantém o seletor indicado no momento dentro da atividade, sem fazer alterações aos objetos no repositório.

A indicação de uma tela busca por um descritor de interface gráfica correspondente, ao passo que a indicação de um elemento de destino busca por um descritor de interface gráfica correspondente. Ao usar o Gravador, as ocorrências correspondentes de tela e elementos serão pesquisadas dentro da biblioteca da interface gráfica dos Descritores de Interface Gráfica do Projeto ou nas dependências importadas das Bibliotecas da Interface Gráfica.

Observação: no runtime, os descritores de interface gráfica são resolvidos a partir do painel Navegador de objetos, se as atividades fizerem referência a esses descritores de interface gráfica.

Variáveis nos Descritores

Para aumentar seu nível de reusabilidade, é possível usar variáveis nos descritores.

É possível editar um destino, adicionar variáveis a ele e depois adicionário ao Repositório de Objetos. Alternativamente, você pode adicionar variáveis aos seletores nas telas ou elementos existentes no Repositório de Objetos. Sempre que adicionar um descritor contendo uma variável a um processo, assegure-se de criar a variável no processo, caso contrário a expressão não poderá ser lida.

Para adicionar uma variável a um seletor de descritor, clique com o botão direito do mouse no elemento dentro do Repositório de Objetos. Depois, selecione Editar Descritor e adicione a variável na janela Opções de Seleção.

As variáveis adicionadas nos seletores devem ficar encerradas entre chaves duplas. Por exemplo, conforme se vê na imagem abaixo, <name='{{VarNumber}}'/> adiciona o valor da variável VarNumber ao atributo name no seletor.

No exemplo abaixo, usamos uma variável dentro do campo URL do Navegador da atividade Use Application/Browser e, em seguida, adicionamos o destino ao Repositório de Objetos como um objeto de tela. Desta maneira, asseguramos que o descritor relate os casos em que a URL mudar.

Realçar Elementos

No painel Repositório de Objetos, clique com o botão direito do mouse em uma tela ou elemento e selecione Realce para realçar os elementos dentro do aplicativo, desde que o app esteja aberto na máquina ou a página da Web esteja aberta no navegador.