Como criar uma biblioteca básica

O tutorial a seguir mostra as etapas de criação de uma biblioteca no Studio e como publicar e usá-la em outros projetos de automação.

Creating a library is similar to Creating a Basic Process. The difference is packages are for creating reusable components to be used in the context of other projects.

Esse exemplo recebe dados de uma planilha do Excel e os acrescenta em outro arquivo do Excel. Em seguida, ele avança pelas etapas para criar o pacote e publicar o projeto em um feed personalizado, instalando o pacote em outro projeto e usando a atividade que ele contém.

Este exemplo usa atividades do Excel que não exigem que o Microsoft Excel seja instalado em sua máquina.

Vamos começar.

Como criar uma biblioteca

1. Inicie o Studio. Em INÍCIO (Modo de exibição Backstage), clique em Biblioteca para criar um projeto de biblioteca. A janela Nova biblioteca em branco será exibida.

   

2. Digite um nome para o projeto, use QuickLibrary para este exemplo. Adicione uma breve descrição e escolha um local.

   Observação:

   O nome do projeto não pode exceder 128 caracteres e a descrição não pode exceder 500 caracteres.

3. Clique em Criar. A nova biblioteca será aberta no Studio.

Como adicionar atividades do Excel

1. In the Activities panel, search for the Read Range activity under System > File > Workbook, and drop it to the Designer panel.

   • No campo Caminho da pasta de trabalho, adicione o caminho ao arquivo do Excel do qual você deseja obter os dados.
   • No campo Nome da planilha, adicione o nome da planilha. Nesse exemplo, o nome permanece o padrão Sheet1.
   • No campo Intervalo, adicione o intervalo de células a ser lido. Nesse exemplo, deixe o campo vazio para que todas as células sejam lidas.

2. No painel Propriedades da atividade Read Range, clique no campo ao lado de DataTable, em seguida, use o atalho de teclado Ctrl + K para abrir o campo da variável e adicione o nome GetRange. A variável do tipo DataTable armazena os dados das células lidas.

   

   

3. In the Activities panel, search for the Append Range activity under System > File > Workbook. Add it below the Read Range activity.

   • No Caminho da pasta de trabalho, adicione o caminho ao arquivo que você deseja anexar os dados copiados.

   • Em Nome da planilha, adicione o nome da planilha. Nesse exemplo, deixe o padrão Sheet.

   • No campo Tabela de dados, adicione a variável GetRange criada anteriormente que armazena as informações. Seu projeto deve ser semelhante à imagem abaixo.

     

4. Na faixa de opções, clique em Executar Arquivo ou use Ctrl + F6 para executar o fluxo de trabalho. Os dados coletados da primeira planilha do Excel são anexados a outra. Isso não substitui os dados atuais na segunda planilha.

Como criar o pacote de uma biblioteca

To add this library as a reusable component to other automation projects, you need to package it as a .nupkg file by publishing the project.

1. Abra o projeto da biblioteca no Studio.

2. Na faixa de opções, clique no botão Publicar. A janela Publicar Biblioteca será aberta.

   • Na guia Propriedades do pacote, insira um nome para o pacote. No campo Notas de versão, adicione alguns detalhes sobre a biblioteca. Isso é útil para rastrear as alterações feitas na biblioteca em cada nova versão publicada.
   • Na guia Opções de publicação, selecione Publicar em > Personalizar e depois, no campo URL personalizada, adicione o caminho a uma pasta local. Por exemplo, você pode criar uma pasta myfeed em sua área de trabalho.

3. Clique em Publicar. O pacote agora está disponível na pasta local como um arquivo .nupkg.

Como instalar componentes reutilizáveis

To use the package in another project, you first need to add it as a project dependency. To get started, create a new Process in Studio, as explained in the Creating a Basic Process page.

Read more about project dependencies in the About Dependencies page.

Como adicionar um feed personalizado

1. Na faixa de opções do Studio, clique em Gerenciar Pacotes > Configurações. Os feeds padrão e definido pelo usuário serão exibidos.

2. No contêiner Origens de pacotes definidos pelo usuário, adicione um nome para seu feed no campo Nome. No campo Origem, adicione o caminho da pasta que você publicou na sua biblioteca.

3. Clique em Adicionar. Seu novo feed será adicionado à seção.

   

You need to follow the above steps whenever you want to add or remove a user-defined feed in Studio. Check out the About Activities Packages to read more information about activities feeds.

Como instalar o pacote

1. Na janela Gerenciar Pacotes, acesse o feed adicionado anteriormente na guia Todos os Pacotes na esquerda. A lista de pacotes disponíveis no feed será exibida.

2. Procure o pacote e selecione-o. Em nosso exemplo, o nome do pacote é QuickLibrary.

3. Clique em Instalar e Salvar. O pacote agora está instalado no seu projeto e visível no painel Projeto, em Dependências.

   

Como adicionar atividades da biblioteca

1. No painel Atividades, procure o nome do pacote, no nosso caso Quick Library.

2. Solte a atividade no painel Designer.

3. Na faixa de opções do Studio, clique em Executar Arquivo ou use Ctrl + F6 para executar a atividade.

   

Você pode adicionar outras atividades como Copiar Planilha ou Preencher Intervalo Automático, mas elas exigem que o Microsoft Excel esteja instalado em sua máquina.

A vantagem de componentes reutilizáveis é que reduzem a repetição. Você os cria uma vez e os reutiliza em outros projetos.

Para baixar a biblioteca que criamos acima, clique no botão abaixo:

Baixe o exemplo