Sobre Bibliotecas

A library is a project which contains one or more workflows that can be reused as activities in other projects. Libraries are saved as NUPKG files when published and can be installed as dependencies from the Package Manager.

For example, you could create a library that collects data from an Excel spreadsheet and appends it to another, as explained in the Creating a Basic Library page. Next, the library can be packaged and used in other processes as an activity.

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 tempo de execução 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. No painel Projeto, clique com o botão direito do mouse no nó do processo e, então, selecione Extrair como biblioteca.

   

3. Configure as seguintes Opções de extração:

   • Include Test Cases: By default, this option is enabled for a Process project and disabled for a Test Automation project. You should enable this option if you want to include test cases as part of the extracted library.
   • Publish and install the library: Automatically selected to publish the package to a shared feed and install the library as a project dependency. You can disable this option if you want to create the library without publishing it. If disabled, the remainder options are not available for configuration.
   • 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 trocar as atividades Invoke Workflow por atividades da biblioteca extraída.

       • Não selecione essa 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.

   • Set Execution Templates from library: Add execution templates to the library.

4. Clique em OK para confirmar as opções da biblioteca.

   

5. Clique em Criar para concluir a criação da biblioteca.

   

6. (Optional) Publish the library if you've selected Publish and install the library in step 3, and then click Publish.

   

   Observação:

   In case you didn't enable the Publish and install the library option, you'll be prompted to open the library or continue with the current project.

   

   Importante:

   Replacing workflows or invoked activities from the extracted library will not take place for workflows where mock testing is used.

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. O nome de exibição não deve ser alterado ao usar a biblioteca em um projeto.
• Tooltip - The tooltip that is visible when you hover over the activity in the Activities and Designer panels in projects where the library is installed.
• Help Link - The help link that opens when you select the activity in the Designer panel and press F1 on your keyboard.
• SVG Icon - The SVG icon to display next to the activity name.
• Color - The highlight color displayed for the activity in the Designer panel.

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.
  • Tooltip - The tooltip that is visible when you hover over the activity property.
  • Input Type - The type of input for the property. You can use the default input for the property type or select an input option depending on the type:
    • Booleano - Alternar (padrão), Condition Builder, Botão de opção.
    • Numérico (int, duplo, decimal, longo, curto, sbyte, byte, ulong, ushort, unidade, flutuante) - Editor de números.
    • String - Compositor de texto (padrão), compositor do rich text.
    • String[] - Matriz de strings.
    • Data - hora - Seletor de data - hora.
    • Período de tempo - Seletor de duração.
    • Dicionário - Construtor de dicionários.
    • Todos os outros tipos - Entrada (Expression Editor).
  • Placeholder - THE Placeholder text to display for the input when no value is selected.
  • 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

Select Activity Properties in the left-side menu and enter the following:

• Tooltip - The tooltip that is visible when you hover over the activity in the Activities and Designer panels in projects where the library is installed.
• Help Link - The help link that opens when you select the activity in the Designer panel and press F1 on your keyboard.

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.
  • Tooltip - The tooltip that is visible when you hover over the activity property.
  • 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.

• Automation Hub URL - URL of an Automation Hub idea linked to the project. For more information, see Linking a Project to an Idea in 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.

  After the project is published, the icon is displayed next to the package in the Manage Packages window in 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.

• Modern Design Experience - set to Yes to enable a modern experience of working with UI Automation, including new and improved activities, recorders, and wizards, as well as the Object Repository.

Como Publicar uma Biblioteca

Publishing libraries is similar to publishing processes. For more information, see About Publishing Automation Projects.

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 a compatibilidade 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.

• O uso de Invoke Workflow File dentro de uma biblioteca para fazer referência à própria biblioteca não é compatível.

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

• Libraries with the cross-platform compatibility can be installed in cross-platform and Windows projects. Windows - Legacy and Windows libraries can only be installed in processes that have the same compatibility.

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