Como reutilizar objetos e bibliotecas de EU

Iniciar de uma Biblioteca de Interface Gráfica

É recomendável inicar pela criação de seus elementos compartilháveis de Interface Gráfica diretamente dentro das bibliotecas, quando souber que seus aplicativos internos serão automatizados várias vezes. Porém, mesmo se você não fizer isso ainda poderá extraí-los dos seus processos existentes.

Quando começar a criar uma Biblioteca de Interface Gráfica, comece pela criação de um processo simples de Biblioteca. Para capturar os elementos de seu aplicativo, siga as etapas descritas em Como criar um repositório de objetos.

Extrair como Projeto da Biblioteca de UI

O repositório local do projeto pode ser extraído para um projeto de biblioteca de Interface Gráfica. Essa ação permite publicar a biblioteca e reutilizar seus elementos, adicionando-a como uma dependência ao seu processo. Clique no ícone Extrair como ícone do Projeto de Biblioteca da Interface Gráfica, na guia Descritores e nomeie sua biblioteca na janela Nova Biblioteca da Interface Gráfica.

Clique em Criar e os descritores serão extraídos.

Clique em Sim para fechar o projeto atual e abrir os descritores extraídos em um projeto de biblioteca ou em Não para retornar para o fluxo de trabalho atual.

Após abrir a biblioteca da Interface Gráfica, você pode publicá-la e usá-la em outros fluxos de trabalho.

Publicar uma Biblioteca de Interface Gráfica

Ao publicar uma biblioteca de Interface Gráfica, um pacote .nupkg é criado. Ele poderá ser instalado em outro projeto como uma dependência e seus descritores poderão ser usados como seletores em outras atividades. Tais pacotes podem ser publicados no Orchestrator e compartilhados em sua organização.

Você pode publicar o fluxo de trabalho inteiro em conjunto com sua biblioteca de Interface Gráfica ou com a extraída.

A publicação do fluxo de trabalho inteiro ou da biblioteca de interface gráfica extraída é feita da mesma maneira que qualquer outro processo. Leia mais sobre Publicação de projetos.

Carregar Bibliotecas de Interface Gráfica em Projetos

Crie um processo no Studio. Na janela Gerenciar Pacotes, acesse o feed onde publicou sua Biblioteca de UI, instalando-a no projeto atual, assim como faria com um pacote de atividade. A Biblioteca de Interface Gráfica é adicionada como uma dependência ao seu projeto e seus descritores ficam visíveis no painel Repositório de Objetos em Bibliotecas de Interface Gráfica. Observe que uma Biblioteca de UI pode conter uma única versão de um Descritor de UI e uma única versão de um aplicativo.

Os descritores na seção Bibliotecas de Interface Gráfica também podem ser adicionados ao projeto local. Para tanto, clique com o botão direito do mouse no nome do aplicativo e escolha Adicionar aos Objetos de Interface Gráfica.

Sempre que precisr usar uma Tela ou Elemento de Interface Gráfica do painel Descritores ou da seção de Bibliotecas de Interface Gráfica do projeto, basta arrastá-lo e soltá-lo no alto da atividade que oferece suporte ao Repositório de Objetos. A atividade obtém o descritor automaticamente.

Observação: a versão da biblioteca da interface gráfica não é incrementada na janela Publicar. Ao publicar uma nova versão da mesma biblioteca de Interface Gráfica, certifique-se de adicionar corretamente o número da nova versão.

Fazer Upgrade do Aplicativo e Seletores de Processos

Usando as bibliotecas de Interface Gráfica é possível atualizar os seletores de um processo de uma só vez, sempre que o aplicativo que você estiver automatizando receber uma nova Interface Gráfica, como ocorre às vezes com aplicativos de área de trabalho ou sites.

Dentro de um projeto de biblioteca, crie a primeira versão de uma biblioteca do repositório de objetos com elementos de um aplicativo. Publique a biblioteca quanto estiver concluída.
Use os objetos dentro das atividades como parte de um processo, instalando a biblioteca como uma dependência.
Na biblioteca inicial, atualize o descritor de cada tela ou elemento com a nova Interface Gráfica do aplicativo. É importante não excluir os elementos. Em vez disso, porém, atualize seus seletores para que o vínculo entre o “element” e o “select” seja preservado.
Publique a biblioteca com uma versão superior e instale-a no processo inicial.
Os descritores serão atualizados automaticamente dentro das atividades.

Fazer check-in em um Repositório de Objetos

Ao se criar um repositório de objetos, os metadados associados aos descritores são mapeados no painel Projeto, como parte do projeto atual, seja ele um processo ou uma biblioteca de Interface Gráfica.

Ao fazer o controle de versões do projeto, o repositório de objetos também é adicionado ao repositório TFS, SVN ou GIT, com os demais arquivos do projeto. Você pode adicionar novos descritores ao repositório e, em seguida, fazer check-in das alterações, da mesma maneira como faria com outros projetos. Leia mais Sobre controle de versão no Studio.

Após adicionar um novo descritor, clique com o botão direito do mouse na pasta Objects, no painel Projeto e selecione Fazer Check-in, a janela Fazer check-in das mudanças irá se abrir, exibindo a mesma hierarquia de elementos como a do Repositório de Objetos.

Adicionar a Fragmentos

Os Fragmentos podem armazenar Aplicativos para fins de testes. É possível adicionar o repositório local de objetos inteiro ao painel Fragmentos para utilização posterior em outros projetos locais, sejam eles processos ou bibliotecas. Clique com o botão direito do mouse no aplicativo e selecione Adicionar aos Fragmentos. Os aplicativos são adicionados junto com as telas child e os elementos de Interface gráfica.

No painel Fragmentos, é possível editar e adicionar descritores ao projeto através da opção de menu de contexto, disponível no menu da versão do aplicativo. Adicionar telas e elementos de UI ao seu projeto pode ser feito através do mesmo menu de contexto disponível para cada um dos elementos.

Não há suporte para o recurso de arrastar e soltar elementos a partir do Painel Fragmentos. Tampouco há suporte para referir elementos a partir do Painel Fragmentos. O Painel Fragmentos é apenas uma funcionalidade de teste que permite salvar os elementos em seu disco. Dalí, os elementos poderão ser adicionados ao repositório local e vice-versa. Consequentemente, qualquer recurso adicionado - seja ele um descritor, uma tela, uma versão de aplicativo ou um aplicativo inteiro - poderá ser removido do painel Fragmentos, sem que isso afete a existência daquele recurso em outras áreas do projeto, como o painel Repositório de Objetos, por exemplo.

O papel do painel Fragmentos é o de um repositório de objetos pessoais "em disco". Esse repositório pode conter elementos de qualquer um de seus projetos locais e os disponibiliza para outros projetos. Como benefício adicional, considerando que os Fragmentos nunca se envolve com a referenciação de elementos, nem com a execução do tempo de execução, você pode armazenar aqui várias versões do mesmo aplicativo. Para criar várias versões de um aplicativo, clique com o botão direito do mouse no aplicativo, escolha Criar Versão e, em seguida, copie os elementos da versão anterior para garantir que você manterá a exclusividade dos elementos entre as versões.

Na caixa de diálogo Nova versão de aplicativo dentro de Fragmentos, preencha as informações da nova versão e, depois, clique em Criar versão.

Observação: os repositórios de objetos não podem ser publicados a partir do painel Fragmentos, pois não desempenham nenhuma função interna referente a projetos ou ao runtime.

Copiar e Colar Objetos

Você pode copiar a estrutura da árvore inteira de e para o Repositório de Objetos, o painel Fragmentos ou entre as instâncias do Studio, usando as opções em Copiar Árvore, disponíveis ao se clicar com o botão direito do mouse no Repositório de Objetos e no Painel Fragmentos.

Além disso, a opção Copiar ou a combinação de atalhos de teclado, Ctrl + C e Ctrl + V permite que você copie elementos individuais do repositório e os cole nos locais acima citados.

Encontrar Referências

Usando a opção Encontrar Referências você pode verificar se o Elemento ou o Descritor de Interface Gráfica de sua biblioteca é usado em todo o projeto.

Para tanto, clique com o botão direito do mouse em um Elemento de Interface Gráfica na guia Descritores de qualquer um dos painéis de Navegador de Objetos (Descritores de Interface Gráfica do Projeto, Bibliotecas de Interface Gráfica ou Fragmentos ─ Descritores de Interface Gráfica) e selecione Encontrar Referências. Os resultados serão exibidos no painel Encontrar Referências. Clicar duas vezes em um resultado vai concentrar-se na atividade que usa o Elemento da Interface Gráfica.