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.

Criar uma biblioteca é semelhante à Como criar um processo básico. A diferença é que os pacotes são para criar componentes reutilizáveis para serem usados no contexto de outros projetos.

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.

Esse exemplo usa as atividades do Excel que não exigem a instalação do Microsoft Excel na 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. Na janela Nova Biblioteca em Branco:
   • Digite um nome para o novo projeto e uma descrição que resuma o que você deseja fazer com essa automação. Para este exemplo, você pode usar o nome QuickLibrary.
     Observação: o nome do projeto não pode ter mais de 128 caracteres e a descrição não mais de 500 caracteres.
   • Selecione o local em que deseja criar o projeto.

   • Selecione Windows - Legado para a opção Compatibilidade e VB para Idioma.

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

Como adicionar atividades do Excel

1. No painel Atividades, procure a atividade Read Range em Sistema > Arquivo > Pasta de trabalho e solte-a no painel Designer.
   • 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. No painel Atividades, procure a atividade Append Range em Sistema > Arquivo > Pasta de trabalho. Adicione-a abaixo da atividade Read Range.
   • 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

Para adicionar essa biblioteca como um componente reutilizável a outros projetos de automação, você precisa criar um pacote dela como um arquivo .nupkg ao publicar o projeto.

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

Para usar o pacote em outro projeto, primeiro você precisa adicioná-lo como uma dependência do projeto. Para começar, crie um Processo no Studio, conforme explicado na página Como criar um processo básico.

Leia mais sobre as dependências do projeto na página Sobre dependências.

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.
   
   

   

   
   

Você precisa seguir as etapas acima sempre que quiser adicionar ou remover um feed definido pelo usuário no Studio. Confira a página Sobre os pacotes de atividades para obter mais informações sobre os feeds de atividades.

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 Copy Sheet ou Auto Fill Range, mas elas exigem que o Microsoft Excel esteja instalado na 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