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 abrir o gravador Capturar elementos.

Clique em Iniciar gravação para começar a capturar elementos. O gravador Capturar Elementos utiliza a tecnologia Unified Target, disponível na versão 20.10 ou superior do pacote UIAutomation.Activities para capturar destinos e âncoras com um 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.

No gravador, você pode:

• Clique em Adicionar Aplicativo ou Adicionar Tela para adicionar um novo aplicativo ou tela.
• A qualquer momento, pause a gravação, clicando em Pausar. Para retomar a gravação, clique novamente em Gravar.

• Gerencie os relementos gravados:

  • Atualize as propriedades de uma tela ou elemento, selecionando-a no painel esquerdo e editando-a no painel Propriedades, à direita.
  • Reorganize e agrupe os elementos, arrastando-os e soltando-os no painel esquerdo.
  • Realce os elementos que você já capturou para identificá-los facilmente passando o mouse sobre seus nomes na janela do Capturar Elementos e usando o botão .

  • Enquanto a gravação está pausada:

    • Remova um elemento, clicando com o botão direito do mouse e selecionando Excluir.
    • Crie um novo elemento como child de uma tela ou elemento, clicando com o botão direito do mouse no elemento existente e selecionando Criar Elemento.
  • Ou então, clique em Configurações e, em seguida, selecione se você deseja configurar cada elemento ou aplicar alterações automaticamente (ambas as configurações são habilitadas por padrão).
• Clique em Salvar objetos na biblioteca para salvar as alterações, fechar o gravador e retornar ao seu projeto.

Capturando todos os elementos

Você pode usar o recurso Capturar Todos os Elementos para capturar todos os elementos de um aplicativo usando a tecnologia do Computer Vision, e depois adicioná-los ao Repositório de Objetos. Esse método é útil para cenários em que a automação depende muito do uso do Repositório de Objetos, pois você não precisa mais adicionar manualmente todos os elementos da interface gráfica, economizando assim tempo ao criar o processo.

1. Clique no botão Capturar todos os elementos no assistente do Capturar Elementos. Você é solicitado a indicar a janela que contém os elementos que você deseja adicionar ao Object Repository. Você também pode selecionar apenas uma região do aplicativo de destino clicando e arrastando um retângulo da área da qual você deseja capturar elementos.

2. Ao indicar o aplicativo, todos os elementos são detectados e destacados em verde. Você também pode desmarcar manualmente os elementos que não quiser adicionar ao Repositório de Objetos. A janela do Assistente de Digitalização permite Escolher todos ou Desmarcar todos os elementos, usando os botões respectivos. Depois que você terminar sua seleção, clicar em Capturar fecha o Assistente de Digitalização e retorna você para a janela do Capturar Elementos.

   Se houver elementos que não foram identificados, você pode nos ajudar a melhorar a detecção enviando uma imagem para o UiPath para análise. Clique em Relatar problemas, selecione uma área com elementos não identificados e, então, selecione Enviar.

   
   

   

   
   
   Observação:

   Esse recurso requer que você tenha configurado um servidor do Computer Vision para usar. Há vários métodos disponíveis para fazer isso, conforme mostrado a seguir:

   • Usar o servidor de nuvem do Computer Vision
   • Usar um servidor no local do Computer Vision

   Após escolher seu tipo de servidor preferido, você deve selecioná-lo para ser usado no projeto atual editando as Configurações do projetodo Servidor e Apikey .

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

Usando a função Capturar Elementos para Aplicativos e Telas Existentes

Se você tiver saido do gravador antes de capturar todos os elementos desejados ou se quiser adicionar ou modificar elementos usando o gravador Capturar Elementos para um aplicativo ou tela que já tiver sido adicionado ao Repositório de Objetos, você poderá iniciar o gravador a qualquer momento no contexto desse aplicativo ou tela:

1. Clique com o botão direito do mouse em qualquer aplicativo ou tela em Descritores da Interface Gráfica do Projeto e selecione Capturar Elementos. Essa ação abrirá a janela Capturar Elementos no contexto daquele aplicativo ou tela:

   • Se você tiver selecionado um aplicativo, todas as telas e elementos sob esse aplicativo serão previamente preenchidos em Capturar Elementos.
   • Se você tiver selecionado uma tela, todos os elementos sob essa tela serão previamente preenchidos em Capturar Elementos.
2. Atualize as telas e elementos conforme necessário. É possível adicionar novas telas, começar a gravar para adicionar novos elementos, editar ou excluir telas ou elementos existentes. Se você fizer alterações em telas e elementos existentes, as alterações serão aplicadas aos descritores no Repositório de Objetos, quando você salvar.
3. Clique em Salvar objetos na biblioteca para salvar as alterações, fechar o gravador e retornar ao seu projeto.

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

Você pode criar seu próprio repositório a partir do painel Repositório de Objetos definindo o aplicativo, cada tela e elemento manualmente.

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 fazer isso, clique no ícone dentro da atividade e siga as etapas para adicionar ou reutilizar 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

A partir do Repositório de Objetos, arraste e solte uma tela ou elemento no alto de uma atividade em seu fluxo de trabalho. A imagem, os argumentos e outros detalhes do objeto são adicionados automaticamente à atividade. Quando uma atividade usa uma tela ou elemento do Repositório de Objetos, clicar no ícone do Repositório de Objetos, na atividade, destacará o descritor que ela usa na árvore do Repositório de Objetos.

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 e solte um objeto no alto do sinal de mais, dentro do fluxo de trabalho. Se você arrastar e soltar uma tela, uma atividade Use Application/Browser será adicionada automaticamente. Se você arrastar e soltar um elemento, uma lista de atividades compatíveis será exibida. Selecione a atividade desejada 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 indicar ou editar o descritor da atividade, selecione Opções e, depois, Indicar destino na tela ou Editar destino. Uma caixa de diálogo será então exibida, informando que a ação é realizada no descritor dentro do Repositório de Objetos. Confirme sua opção, selecionando Indicar descritor e Editar descritor, respectivamente.

• Para indicar ou editar o descritor somente em relação à atividade atual, primeiro você deve remover o vínculo entre a atividade e o Repositório de Objetos, selecionando Opções , e em seguida Desvincular do Repositório do Objetos. Observe que, 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.

Uso de objetos em automações codificadas

Ao trabalhar com APIs de automação de interface gráfica, há dois métodos principais para acessar elementos de interface gráfica:

1. Chamando elementos de interface gráfica como strings.
2. usando IElementDescriptors a partir do Repositório de objetos.

1. Chamando elementos de interface gráfica como Strings

1. Crie um aplicativo no Repositório de objetos do seu projeto chamado MyApplication.
   1. Crie uma tela para o aplicativo chamado MainScreen.
   2. Crie um elemento chamado HomePageIcon.
2. Crie uma variável para a tela.
3. Use a Open API para abrir a tela usando o código abaixo:

   var screen = uiAutomation.Open("MainScreen");

   Para encontrar o ObjectRepositorynamespace e o Descriptors, pressione CTRL + spaceem seu teclado.
4. Use a API Click no elemento de interface gráfica, usando o código abaixo:

   screen.Click("HomePageIcon");

2. Chamando elementos de interface gráfica como IElementDescriptors

Utilize o formato abaixo ao chamar objetos como IElementDescriptors: ObjectRepository.Descriptors.<ApplicationName>.<ScreenName>.<UiElementName>, onde ObjectRepository é um namespace que integra a classe Descriptors. A classe Descriptors inclui ainda todos os elementos da interface gráfica que você capturou no Repositório de objetos.

Observação: recomendamos que você não use Object como o nome de seu aplicativo no Repositório de objetos.

1. Crie um aplicativo no Repositório de objetos do seu projeto chamado MyApplication.
   1. Crie uma tela para o aplicativo chamado MainScreen.
   2. Crie um elemento chamado HomePageIcon.
2. Para melhorar a legibilidade, você pode definir seu aplicativo como uma variável aplicando uma instrução using no início do seu fluxo de trabalho. Aqui está um exemplo: using app = <ProjectName>.ObjectRepository.Descriptors.<AppName>.
   Com essa abordagem, você pode chamar facilmente descritores no seguinte formato: app.<ScreenName>.<UiElementName>
3. Crie uma variável para a tela.
4. Use a Open API para abrir a tela usando o código abaixo:

   var screen = uiAutomation.Open(ObjectRepository.Descriptors.MyApplication.MainScreen);

   Para encontrar o ObjectRepositorynamespace e o Descriptors, pressione CTRL + spaceem seu teclado.
5. Use a API Click no elemento de interface gráfica, usando o código abaixo:

   screen.Click(ObjectRepository.Descriptors.MyApplication.MainScreen.HomePageIcon);

   
   

   

   
   
6. Se desejar usar elementos do repositório de objetos de um projeto de biblioteca importado, execute as seguintes etapas:
   1. No projeto do qual você exportou a biblioteca, crie um novo caso de teste codificado ou arquivo de fluxo de trabalho codificado.
   2. Atualize o pacote UiPath.CodedWorkflows para a versão mais recente.
   3. No arquivo onde você deseja utilizar os elementos do repositório de objetos importados, faça referência ao projeto de onde você exportou os elementos na seção namespaces, usando o seguinte formato: <ProjectName> = <LibraryName>.ObjectRepository.Descriptors.
   4. Ao usar APIs, como Click ou Open, chame os elementos de interface gráfica usando o seguinte formato:

      screen.Click(<LibraryName>.ObjectRepository.Descriptors.MyApplication.MainScreen.HomePageIcon);

Editar Descritores

Descritores de elementos

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.

  Observação: tanto os Seletores quanto os Seletores Fuzzy em seus descritores podem ser editados diretamente no UIExplorer usando o botão .

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

Descritores de telas

Para editar um descritor de telas, na guia Descritores, clique com o botão direito do mouse na tela e selecione Editar descritor. A janela Editar tela é exibida.

Você pode editar o caminho do aplicativo ou a URL do navegador, os argumentos do aplicativo e o seletor de janelas, e selecionar se apenas aplicativos com um título que seja uma correspondência exata podem ser usados na automação. O caminho do aplicativo, o URL do navegador e os campos de argumentos de aplicativo suportam expressões, variáveis e argumentos.

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.