Sobre Bibliotecas

Uma biblioteca é um projeto que contém um ou mais fluxos de trabalho que podem ser reutilizados como atividades em outros projetos. As bibliotecas são salvas como arquivos NUPKG quando publicadas e podem ser instaladas como dependências a partir do gerenciador de pacotes.

Por exemplo, você pode criar uma biblioteca que colete dados de uma planilha do Excel e anexá-la a outra, conforme explicado na página Como Criar uma Biblioteca Básica. Em seguida, a biblioteca poderá ser empacotada e usada em outros processos como uma atividade.

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: por 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, UiPath.Mail.Activities, UiPath.System.Activities e UiPath.UIAutomation.Activities, com a regra de runtime Menor Versão 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.

Argumentos definidos por você na biblioteca se tornam propriedades de atividade nos projetos em que a biblioteca está instalada como dependência. Anotações adicionadas a um argumento na biblioteca são mostrados como dicas da propriedade no painel Propriedades da atividade. Para obter mais informações sobre argumentos, consulte o Painel Argumentos.

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.
• Pronto para executar - definido como Sim para otimizar os assemblies gerados para uma compilação JIT mais rápida no runtime.
• Experiência moderna de Design - defina como Sim para habilitar a experiência moderna de trabalhar com a automação de interface gráfica, incluindo atividades novas e aprimoradas, gravadores e assistentes, além do repositório de objetos.

Como Publicar uma Biblioteca

A publicação de bibliotecas é similar à publicação de processos. Para mais informações, consulte Sobre os projetos de Automação de Publicação.

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.
• Bibliotecas contendo atividades Invoke Workflow File, com a opção Isolado selecionada não podem ser publicadas. Uma mensagem de erro será exibida no painel de Saída.
• 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.
• Não há suporte para usar a opção Invocar Arquivo de Fluxo de Trabalho dentro de uma biblioteca para referenciar a própria biblioteca.

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.