Sobre Bibliotecas

A library is a project which contains one or more workflows that can be reused as activities in other projects. Libraries are saved as NUPKG files when published and can be installed as dependencies from the Package Manager.

For example, you could create a library that collects data from an Excel spreadsheet and appends it to another, as explained in the Creating a Basic Library page. Next, the library can be packaged and used in other processes as an activity.

Como criar uma biblioteca

1. Acesse a Exibição Backstage do Studio > Iniciar > Biblioteca. Isso abre a janela Nova Biblioteca em branco.
2. Preencha o nome e escolha um local para a biblioteca. O local padrão é C:\Users\<current_user>\Documents\UiPath. Adicione uma descrição e selecione Criar. A nova biblioteca é criada e salva na sua máquina local.

Observação:

O nome da biblioteca não pode exceder 128 caracteres e a descrição não pode exceder 500 caracteres.

1. O Painel Projeto mostra a exibição em árvore com a pasta Projeto, Dependências e a , NewActivity.xamlque contém o fluxo de trabalho real.

   Cada arquivo de fluxo de trabalho em uma biblioteca está disponível como uma atividade em projetos em que a biblioteca for instalada como uma dependência. Se você quiser tornar um privado, clique com o botão direito do mouse sobre ele e selecione Ignorar da Publicação. Neste caso, o arquivo é incluído no pacote de biblioteca, mas não fica disponível como um componente reutilizável no painel Atividades.

   Observação:

   UiPath.Mail.ActivitiesUiPath.System.ActivitiesUiPath.UIAutomation.ActivitiesPor padrão, as dependências disponíveis para bibliotecas novas são as mesmas para os projetos novos em branco, a saber , UiPath.Excel.Activities, e , com a regra de Runtime da Versão Mais Antiga Aplicável.

Para adicionar uma dica de ferramenta e link de ajuda a uma atividade, clique com o botão direito do mouse no arquivo de fluxo de trabalho no painel Projeto e selecione Propriedades. A dica de ferramenta fica visível quando você passa o mouse sobre a atividade nos painéis Atividades e Designer em projetos nos quais a biblioteca estiver instalada. O Link de Ajuda é aberto quando você seleciona a atividade no painel Designer e pressione F1.

Arguments you define in the library become activity properties in the projects where the library is installed as a dependency. Annotations you add to an argument in the library are displayed as a tooltip for the property in the resulting activity's Properties panel. For more information about arguments, see Arguments Panel.

Observação:

• No caso das bibliotecas, é recomendável usar Nothingpara atribuir um valor null a uma variável, em vez do "". Isso é feito para evitar quaisquer inconsistências ao usar a biblioteca empacotada como uma dependência para um projeto.
• A propriedade ImplementationVersion do System.Activities.ActivityBuilderobjeto não é compatível. A consequência de se definir um valor para essa propriedade é que os argumentos não são salvos. Esse objeto é exibido no painel Propriedades quando você seleciona a área em branco do painel Designer.

Como Ajustar as Configurações da Biblioteca

Para configurar o projeto de biblioteca, abra a janela Configurações do projeto, clicando em Configurações, no painel Projeto.

As opções a seguir estão disponíveis na guia Geral:

• Nome - editar o nome do projeto.
• Descrição - editar a descrição do projeto.
• Incluir Origens — definido como Sim para empacotar todas as origens de .xaml no arquivo de assembly gerado, incluindo os fluxos de trabalho que foram anteriormente transformados em privados. Se necessário, você pode descompilar o arquivo de assembly e extrair os fluxos de trabalho, que podem ser úteis na hora da depuração.
• Compilar expressões de atividades - definido como Sim para compilar e empacotar todas as expressões de atividades com a biblioteca. Isso resulta em um tempo de execução aprimorado.
• Ready to Run - set to Yes to optimize the generated assemblies for faster JIT compilation at runtime.
• Modern Design Experience - set to Yes to enable a modern experience of working with UI Automation, including new and improved activities, recorders, and wizards, as well as the Object Repository.

Como Publicar uma Biblioteca

Publishing libraries is similar to publishing processes. For more information, see About Publishing Automation Projects.

Limitações ao Publicar Bibliotecas

Ao publicar bibliotecas, considere as seguintes limitações:

• Devido às limitações do NuGet:
  • Não é possível publicar bibliotecas em locais que contenham subpastas restritas ao usuário, usando as variáveis de caminho em ambiente Windows.
  • Notas de versão das bibliotecas publicadas somente ficam visíveis no Orchestrator.
• Bibliotecas com caracteres especiais nos nomes dos .xamlarquivos que contêm podem não ser publicadas com sucesso.
• Libraries containing Invoke Workflow File activities with the Isolated option selected cannot be published. An error message is displayed in the Output panel.
• Ao usar a atividade Invoke Workflow File, certifique-se de que o arquivo invocado está localizado na mesma pasta que o projeto da biblioteca.
• A atividade Launch Workflow Interactive não é compatível com bibliotecas.
• O uso de Invoke Workflow File dentro de uma biblioteca para fazer referência à própria biblioteca não é compatível.

Como Adicionar Componentes Reutilizáveis em Projetos de Automação

1. Abra ou crie um projeto.

2. Na categoria Todos Pacotes, escolha o feed em que a biblioteca é salva e instale o pacote.

3. Selecione OK e o pacote é adicionado à definição do projeto.

4. A atividade é encontrada na categoria personalizada no painel Atividades.

   Observação:

   • Bibliotecas são compatíveis com encaminhamento, o que significa que somente podem ser usadas com projetos criados com o Studio v2018.3 e posterior. Bibliotecas não podem ser publicadas em versões do Orchestrator anteriores à 2018.3.
   • Pode ocorrer erros ao se executar um projeto contendo atividades personalizadas de uma biblioteca criada em uma versão do Studio anterior à 2019.10.1 e publicada com a versão do Studio 2019.10.1 ou posterior. Neste cenário, você deve recriar e republicar a biblioteca.

Observe que em um projeto de biblioteca, ao usar a opção Importar fluxos de trabalho para adicionar um fluxo de trabalho que contenha uma biblioteca, as dependências referenciadas na biblioteca não serão importadas.

Ao importar duas versões da mesma biblioteca personalizada para um projeto no Studio, as atividades adicionais personalizadas contidas apenas na segunda biblioteca não ficam visíveis no painel Atividades, a menos que você remova a primeira biblioteca importada.