Como criar uma biblioteca básica

O tutorial a seguir orienta você pelas etapas de criação de uma biblioteca no Studio, publicação e uso dela em outros projetos de automação.

Criar uma biblioteca é semelhante a Criar um processo básico. A diferença é que uma biblioteca é um pacote contendo componentes reutilizáveis que podem ser 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.

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. Launch Studio. In the HOME Backstage view, select Library to create a new library project. The New Blank Library window is displayed.

   

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 Mostrar opções avançadas e escolha o local onde criar o projeto.

   • Selecione Windows para a opção Compatibilidade e VB para Linguagem.

3. Select Create. The new library is opened in Studio.

Resultado

The library project is created and opens in Studio, ready for activities to be added.

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 Excel file, procure o arquivo do Excel do qual você deseja obter os dados. Ou então, você pode usar

O campo Referenciar como para alterar a forma 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 de onde você deseja copiar os dados. Adicione uma referência opcional a este 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. In the ribbon, select Run File or use Ctrl + F6 to execute the workflow. The data gathered from the first Excel spreadsheet is copied to another.

Resultado

The data from the first Excel spreadsheet is copied to the second. The workflow runs successfully.

Como criar o pacote de uma biblioteca

Para adicionar essa biblioteca como um componente reutilizável a outros projetos de automação, você precisa empacotá-la como um arquivo .nupkg publicando o projeto.

1. Abra o projeto da biblioteca no Studio.

2. From the ribbon, select the Publish button. The Publish Library window opens.

   • 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. Select Publish. The package is now available in the local folder as a .nupkg file.

   

Resultado

The library is published as a .nupkg file to your custom feed folder and is ready to be installed in other projects.

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 novo Processo no Studio, conforme explicado na página Criação de um processo básico.

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

Como adicionar um feed personalizado

1. In the Studio ribbon, select Manage Packages > Settings. The default and user-defined feeds are displayed.

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. Select Add. Your new feed is added to the section.

   

Resultado

The custom feed is added to Studio. It is now available under All Packages when managing package dependencies.

Você precisa seguir as etapas acima sempre que quiser adicionar ou remover um feed definido pelo usuário no Studio. Consulte a página Sobre os pacotes de atividades para ter mais informações sobre 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. Select Install, then Save. The package is now installed in your project, and visible in the Project panel, under Dependencies.

   

Resultado

The package is installed as a dependency in your project. Its activities are available in the Activities panel.

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. In the Studio ribbon, select Run File or use Ctrl + F6 to execute the activity.

   

Resultado

The library activity runs successfully in the project. The reusable component is ready to use in any project where the package is installed.

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