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 Atividades.
• 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.
• 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.

  
  

  

  
  

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.
• 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.

• 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. 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.