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, selecione a compatibilidade e a linguagem do projeto e, em seguida, 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.
   • Não use lib como um nome de biblioteca, pois isso resultará em um erro de compilação em projetos em qual a biblioteca estiver instalada.
3. 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 determinado arquivo privado, clique com o botão direito do mouse e selecione Tornar Privado. 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. Argumentos marcados como necessários ficam disponíveis no corpo da atividade no painel Designer. Anotações que você adiciona a um argumento na biblioteca são mostrados como dicas da propriedade no painel Propriedades da atividade resultante. 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.
• URL do Automation Hub - URL de uma ideia do Automation Hub vinculada ao projeto. Para obter mais informações, consulte Vinculação de um projeto a uma ideia no Automation Hub.
• Ícone do projeto - Opcionalmente, defina um ícone personalizado para o projeto. Você pode procurar e selecionar um arquivo ou inserir um caminho ou URL público para um arquivo ico, jpeg, jpg ou png de até 1MB.

  Após a publicação do projeto, o ícone é exibido ao lado do pacote na janela Gerenciar pacotes no Studio.

• Incluir Origens - Defina como Sim para incluir todas as origens .xaml no pacote da biblioteca, incluindo fluxos de trabalho que foram transformados em privados anteriormente. Para Windows - Bibliotecas legadas, os arquivos são salvos no arquivo de assembly gerado e na pasta lib\net45 no arquivo .nupkg. Para bibliotecas Windows e multiplataforma, os arquivos são salvos na pasta content no arquivo .nupkg.
• 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. Disponível para Windows — somente bibliotecas legadas.
• Pronto para executar — definido como Sim para otimizar os assemblies gerados para uma compilação JIT mais rápida no runtime. Disponível para Windows — somente bibliotecas legadas.
• 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.
• Se uma biblioteca contém um arquivo .xaml e um argumento que tem o mesmo nome, ela não pode ser publicada.
• Projetos de biblioteca com o Windows - Legado não podem ser publicados se contiverem atividades Invoke Workflow File com a opção Isolado selecionada. Uma mensagem de erro é exibida no painel Saída ao tentar publicar. Essa limitação não se aplica às bibliotecas que usam a compatibilidade do Windows ou multiplataforma.
• 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.
• Se uma biblioteca contém uma atividade que aceita um caminho de arquivo como entrada, quando o componente é usado em um projeto, os caminhos que incluem variáveis de ambiente são interpretados como caminhos relativos para a pasta da biblioteca. Para contornar isso, use o método Environment.GetEnvironmentVariable ou uma atividade Get Environment Folder para recuperar o caminho da pasta e, em seguida, use a saída para criar um caminho absoluto para passar ao componente reutilizá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.

Considerações para a instalação de bibliotecas em projetos

• As bibliotecas só podem ser instaladas em projetos que tenham a mesma compatibilidade.
• 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.
• Ao usar usar Importar Fluxos de Trabalho para adicionar um fluxo de trabalho que contém uma biblioteca em um projeto de biblioteca, as dependências referenciadas na biblioteca não são importadas.
• Ao importar duas versões da mesma biblioteca personalizada em um projeto, as atividades extra personalizadas na segunda biblioteca não ficam visíveis no painel Atividades, a menos que você remova a primeira biblioteca importada.