Como criar uma biblioteca básica

The following tutorial walks you through the steps of creating a library in Studio, publishing and using it in other automation projects.

Creating a library is similar to Creating a Basic Process. The difference is that a library is a package containing reusable components which can 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. 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 exceder 128 caracteres e a descrição não pode exceder 500 caracteres.

   • Selecione o local em que deseja criar o projeto.

   • Select Windows - Legacy for the Compatibility option and VB for Language.

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

Como adicionar atividades do Excel

1. No painel de atividades, pesquise a atividade Excel Process Scope e solte-a no painel Designer.

2. Adicione uma atividade Use Excel File à sequência. Essa atividade é necessária para a maioria das atividades relacionadas ao Excel.

3. No campo Arquivo do Excel, procure o arquivo do Excel do qual você deseja obter os dados. Opcionalmente, você pode usar o campo Referenciar como para alterar a maneira como esse arquivo é referenciado em todo o fluxo de trabalho (Excel1 neste caso).

4. Adicione uma segunda atividade Use Excel File dentro da primeira atividade Use Excel File e navegue até o arquivo do Excel onde você deseja copiar os dados. Adicione uma referência opcional a esse segundo arquivo (Excel2neste caso).

5. Adicione uma atividade Copiar/Colar Intervalo.

6. No campo Origem , selecione o Mais botão para indicar o nome da planilha na primeira pasta de trabalho. Para esse exemplo, o campo deve mostrar Excel1.Sheet("Sheet1").

7. No campo "Destino", selecione Mais para indicar o nome da planilha na segunda pasta de trabalho (Excel2.Sheet("Sheet1") no nosso caso). Seu projeto deve ser semelhante à imagem abaixo.

   

8. 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 copiados para outra.

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