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 novas bibliotecas são as mesmas que as para novos projetos com a regra de runtime Versão mais baixa aplicável.

Extração de um projeto como biblioteca

Você pode extrair qualquer processo ou projeto de teste de automação como uma biblioteca para reutilizá-la em outros projetos. Por exemplo, você pode converter um projeto de automação de testes para usar seus modelos em outros projetos de automação.

1. Abra um projeto no Studio.
2. Na faixa de opções Design, selecione Exportar como e Biblioteca.
   
3. Selecionar os fluxos de trabalho que você deseja exportar como biblioteca.Por padrão, todo o projeto é desmarcado, juntamente com os pontos de entrada (Fluxo de trabalho principal e Casos de teste).
   
4. Configure as seguintes Opções de extração:
   • Incluir casos de teste: por padrão, essa opção é habilitada para um projeto de processo e desabilitada para um projeto de automação de testes. Você deve habilitar essa opção se quiser incluir casos de teste como parte da biblioteca extraída.
   • Publicar e instalar a biblioteca: selecionada automaticamente para publicar o pacote em um feed compartilhado e instalar a biblioteca como uma dependência do projeto. Você pode desabilitar essa opção se quiser criar a biblioteca sem publicá-la. Se estiver desabilitada, as opções restantes não estarão disponíveis para configuração.

   • Alterar seus fluxos de trabalho após a instalação do pacote: escolha modificar os fluxos de trabalho com atividades que foram compiladas a partir da biblioteca.

   • Modo de substituição: escolha o método de substituição do fluxo de trabalho.
     • Selecione Substituir conteúdo de fluxos de trabalho invocados para alterar os fluxos de trabalho invocados a partir do ponto de entrada ou casos de teste com atividades correspondentes da biblioteca extraída.
     • Use essa opção se você usar as propriedades Isolada e Sessões de destino para que as atividades Invoke Workflow sejam executadas em um processo do Windows separado e comecem em uma sessão diferente, respectivamente.
     • Selecione Substituir atividades "Invoke Workflow" para alterar as atividades Invoke Workflow por atividades da biblioteca extraída.
       Aviso: não selecione esta opção se você estiver usando as propriedades Isolada e Sessões de destino para atividades Invoke Workflow.
   • Excluir fluxos de trabalho substituídos: exclua os fluxos de trabalho que foram substituídos pelas atividades da biblioteca extraída.
   • Definir modelos de execução da biblioteca: adicione modelos de execução à biblioteca.
5. Clique em Exportar para confirmar as opções de biblioteca.
   
6. Clique em Criar para concluir a criação da biblioteca.
   
   

   

   
   
7. (Opcional) Publique a biblioteca se você selecionou Publicar e instalar a biblioteca na etapa 3 e, então, clique em Publicar.
   
   

   

   
   

   Observação: caso você não tenha habilitado a opção Publicar e instalar a biblioteca, será solicitado que você abra a biblioteca ou continue o projeto atual.

   
   

   

   
   

   Importante: a substituição de fluxos de trabalho ou atividades invocadas da biblioteca extraída não ocorrerá para fluxos de trabalho em que·teste simulado é usado.

Configuração do layout de uma atividade

Argumentos definidos por você na biblioteca se tornam propriedades de atividade nos projetos em que a biblioteca está instalada como dependência.

Para configurar a aparência e o comportamento de uma atividade quando ela é usada em um projeto, clique com o botão direito do mouse no arquivo do fluxo de trabalho no painel Projeto da biblioteca e, então, selecione Layout da atividade. A janela Propriedades da atividade é exibida com diferentes opções, dependendo da compatibilidade da biblioteca (Windows - Legado, Windows ou multiplataforma).

Opções para bibliotecas do Windows e multiplataforma

Selecione Propriedades da atividade no menu do lado esquerdo e digite o seguinte:

• Nome de exibição - O nome da atividade exibido no Painel de Atividades. O nome de exibição não deve ser alterado ao usar a biblioteca em um projeto.
• Dica de ferramentas - A dica de ferramentas que é visível quando você passa o mouse sobre a atividade nos painéis Atividades e Designer em projetos onde a biblioteca está instalada.
• Link de ajuda — o link de ajuda que aparece quando você seleciona a atividade no painel Designer e pressiona F1 no teclado.
• Ícone SVG - o ícone SVG a ser exibido ao lado do nome da atividade.
  Observação: o ícone não é visível no Gerenciar Pacotes se um arquivo local for usado para uma biblioteca publicada no Orchestrator ou para um feed que não é compatível com ícones incorporados. Neste caso, especifique o ícone usando uma URL.
• Cor A cor de destaque exibida para a atividade no painel Designer.

Os argumentos definidos no arquivo do fluxo de trabalho são listados em Propriedades da atividade, no menu do lado esquerdo.

• Para personalizar a propriedade gerada, selecione-a e configure o seguinte:

  • Nome da exibição - O rótulo que aparece na atividade para a propriedade.
  • Dica de ferramentas - A dica de ferramentas que é visível quando você passa o mouse sobre a propriedade da atividade.

  • Tipo de entrada - O tipo de entrada para a propriedade. Você pode usar a entrada padrão para o tipo de propriedade ou selecionar uma opção de entrada que depende do tipo:

    • Booleano - Usar padrão, Alternar (padrão), Construtor de condição, Botão de rádio.
    • Numérico (int, duplo, decimal, longo, curto, sbyte, byte, ulong, ushort, unidade, flutuante) - Usar padrão, Editor de Número, Lista suspensa. Para lista suspensa, no campo Valores, insira cada valor separado pressionando Enter no seu teclado.
    • String - Usar padrão, Compositor de texto (padrão) (Compositor de rich text, Lista suspensa, Autocomplete, Botão de rádio.Para Lista suspensa, Autocomplete e Botão de rádio, no campo Valores, insira cada valor separado pressionando Enter no seu teclado.
    • String[] - Usar padrão, Matriz string.
    • Data e hora - Usar padrão, Data e hora.
    • Período de tempo - Usar padrão, Período de tempo.
    • Dicionário - Usar padrão, dicionário.
    • Todos os outros tipos - Usar padrão, Entrada
  • Placeholder - O texto de placeholder a ser exibido para a entrada quando nenhum valor é selecionado.
  • Necessário - Se a propriedade é necessária.
  • Apenas avançado - Se a propriedade deve ser exibida apenas na seção de opções avançadas da atividade. As propriedades da seção de opções avançadas também podem ser organizadas em categorias.
• Para adicionar uma categoria sob a qual agrupar várias propriedades relacionadas, selecione Nova categoria no lado inferior esquerdo da janela. As categorias estão disponíveis apenas na seção de opções avançadas da atividade gerada e podem ser expandidas ou recolhidas. Se uma categoria estiver vazia, ela será removida quando você clicar em Salvar para fechar a janela.

• Para alterar a ordem das propriedades e categorias ou para adicionar propriedades a categorias, arraste e solte os itens na lista.

  
  

  

  
  
• Se sua biblioteca incluir atividades do Integration Service ou invocar fluxos de trabalho que contenham atividades do Integration Service, as conexões usadas nessas atividades, bem como outras propriedades da atividade, aparecerão como entidades separadas ao configurar o layout da atividade. Você pode reordenar e categorizar conexões e propriedades do Integration Service, bem como editar o Nome de exibição e a Dica de ferramenta de uma propriedade.
  Observação:

  • A configuração de conexões e propriedades pode não funcionar ao invocar fluxos de trabalho que invocam fluxos de trabalho codificados.

  • Em processos que incluem uma atividade de biblioteca que usa conexões, se uma atividade que não faz parte dessa biblioteca e que utiliza a mesma conexão for adicionada ao processo, a segunda atividade substituirá as configurações da atividade da biblioteca.

Opções para bibliotecas do Windows - Legado

Selecione Propriedades da atividade no menu do lado esquerdo e digite o seguinte:

• Dica de ferramentas - A dica de ferramentas que é visível quando você passa o mouse sobre a atividade nos painéis Atividades e Designer em projetos onde a biblioteca está instalada.
• Link de ajuda — o link de ajuda que aparece quando você seleciona a atividade no painel Designer e pressiona F1 no teclado.

Os argumentos definidos no arquivo do fluxo de trabalho são exibidos em Propriedades da atividade, no menu do lado esquerdo.

• Para personalizar a propriedade gerada, selecione-a e configure o seguinte:

  • Nome da exibição - O rótulo que aparece na atividade para a propriedade.
  • Dica de ferramentas - A dica de ferramentas que é visível quando você passa o mouse sobre a propriedade da atividade.
  • Necessário - Se a propriedade é necessária.
  • Apenas avançado - Se a propriedade deve ser exibida apenas no painel Propriedades. Se estiver selecionada, a propriedade não é exibida no painel do Designer para a atividade gerada.

• Para alterar a ordem na qual as propriedades são exibidas na atividade, arraste-as e solte-as na lista.

  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.
• Tags do projeto - Você pode adicionar uma ou mais tags ao projeto, seja criando novas ou reutilizando tags já definidas no Orchestrator. Existem dois tipos de tags: rótulos e propriedades (pares de chave-valor). As tags são incluídas no pacote publicado e ajudam a descrever e categorizar projetos. Para obter mais informações, consulte Sobre projetos de automação.
• 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 pacote - 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.

• 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.
• Dependências de runtime separadas - Para aumentar o desempenho do robô e reduzir o tamanho dos pacotes publicados, as bibliotecas são separadas em pacotes de design e runtime. O pacote de design é usado pelo Studio e o pacote de execução mais leve é usado pelo UiPath Robot.
• Incluir fontes - Defina como Sim para empacotar todas as fontes .xaml dentro do pacote publicado, incluindo fluxos de trabalho que foram anteriormente tornados privados. Para bibliotecas Windows - Legado, os arquivos são salvos no arquivo de assembly gerado e na pasta lib\net45 no arquivo .nupkg. Para Windows e bibliotecas e processos multiplataforma, os arquivos são salvos na pasta content no arquivo .nupkg.

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. Diferentemente dos processos, a publicação de uma biblioteca cria dois arquivos NUPKG – um pacote de tempo de design e um pacote de runtime. Isso se aplica apenas a bibliotecas do Windows e multiplataforma se a opção Configurações do projeto de dependências de runtime separadas estiver habilitada.

Observação:

• Por causa da separação entre tempo de design e pacotes de runtime, bibliotecas personalizadas publicadas no Studio 2023.4 não têm a garantia de serem compatíveis com versões anteriores do Studio.
• Você pode instalar apenas o pacote de tempo de design em um projeto, pois ele é substituído pelo pacote de runtime ao publicar. A instalação apenas do pacote de runtime causará problemas inesperados no Studio.
• A partir do Studio 2023.10.0, a separação entre tempo de design e pacotes de runtime ocorre apenas se:
  • Um arquivo ViewModels.dll é gerado durante o processo de compilação. O arquivo ViewModels.dll é gerado para bibliotecas do Windows e multiplataforma ao configurar propriedades de atividade viewmodel para pelo menos um arquivo de fluxo de trabalho dentro da biblioteca.
  • A opção Dependências de runtime separadas está habilitada.

Limitações ao usar bibliotecas

Ao usar bibliotecas, leve em consideração 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 contiver uma atividade que aceita um caminho de arquivo como entrada, para garantir que o caminho seja resolvido corretamente em projetos onde a biblioteca está instalada, adicione a constante global UiPath.Constants.Project.Location ao fazer referência ao caminho (use essa capitalização exata). Isso desabilita a alteração da Environment.CurrentDirectory para a pasta da biblioteca no início da execução para uma atividade da biblioteca e, ao invés disso, usa a constante.

  Por exemplo, se um arquivo chamado Employee.txt localizado na subpasta InputData no projeto da biblioteca for usado dentro de uma atividade Read File, forneça o caminho da seguinte forma:

  UiPath.Constants.Project.Location+"InputData\Employee.txt"

  Observação: a constante não deve ser usada em atividades Invoke Workflow File dentro das bibliotecas.
• Para fazer referência a um local da pasta do projeto onde uma biblioteca está instalada, cole o caminho para a biblioteca como um argumento.

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 com a compatibilidade multiplataforma podem ser instaladas em projetos multiplataforma e do Windows. As bibliotecas do Windows - Legado e do Windows só podem ser instaladas em processos que têm 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.
• Usar pontos (.) no nome da biblioteca separa a biblioteca em grupos aninhados ao visualizá-la no painel Atividades.
• Ao usar atividades personalizadas de uma biblioteca, quaisquer valores padrão definidos para argumentos são automaticamente preenchidos no painel Propriedades da atividade quando a atividade é adicionada ao fluxo de trabalho. Se você limpar o valor de um campo de propriedade no fluxo de trabalho, o valor padrão correspondente não é usado em tempo de execução. Nesse caso, um valor vazio é passado explicitamente.

  Por outro lado, ao usar a atividade Invocar fluxo de trabalho, deixar uma entrada em branco no painel Importar argumentos resulta no valor padrão definido no fluxo de trabalho chamado a ser usado em tempo de execução.