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:

   UiPath.Mail.ActivitiesUiPath.System.ActivitiesUiPath.UIAutomation.ActivitiesPor 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, e , com a regra de Runtime da Versão Mais Antiga 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.

Arguments you define in the library become activity properties in the projects where the library is installed as a dependency. Arguments that are marked as required are available in the body of the activity in the Designer panel. Annotations you add to an argument in the library are displayed as a tooltip for the property in the resulting activity's Properties panel. For more information about arguments, see Arguments Panel.

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.

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

• 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 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 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.
• If a library contains an activity that accepts a file path as input, when the component is used in a project, paths that include environment variables are interpreted as paths relative to the library folder. As a workaround, use either the Environment.GetEnvironmentVariable method or a Get Environment Folder activity to retrieve the folder path, and then use the output to construct an absolute path to pass to the reusable component.
• 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

• Libraries can only be installed in projects that have the same compatibility.

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

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