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.
• Se um arquivo de fluxo de trabalho colocado dentro de uma pasta em uma biblioteca for usado como um namespace em um projeto, alterar o nome da pasta, republicar e instalar a biblioteca atualizada no projeto resulta em atividades desconhecidas.

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.
• Se uma biblioteca multiplataforma contém um fluxo de trabalho com atividades de automação de IU, a adição da atividade gerada em um projeto multiplataforma resulta em um erro de validação quando o projeto é executado.
• 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.