Pacotes e bibliotecas

Um pacote é um conjunto que compreende todos os elementos de automação, como atividades, fluxos de trabalho, arquivos e fontes de dados. Quando cria um projeto no Studio, você o publica como um pacote em um local ou feed específico. A partir daí, o Robô pode baixá-lo e usá-lo para executar a automação.

Importante:

Use caminhos absolutos para indicar a localização dos pacotes.

Feeds padrão

Os seguintes locais e feeds são configurados por padrão no Studio:

• Tenant do Orchestrator e Host do Orchestrator – Esses feeds de atividades serão adicionados por padrão se seu Robô estiver conectado ao Orchestrator e eles não podem ser desabilitados.A opção Tenant do Orchestrator estará disponível apenas se o feed das bibliotecas de tenant estiver habilitado no Orchestrator.Os feeds têm a seguinte origem: https://[Orchestrator_host]/nuget/activities.
• Local - o feed para os pacotes instalados localmente com o Studio. O feed tem a origem: %ProgramFiles%\UiPath\Studio\Packages para instalações por máquina ou %localappdata%\Programs\UiPath\Studio\Packages para instalações por usuário.
  Observação:

  A data de publicação exibida na janela Gerenciar pacotes para pacotes do feed local é a data em que o instalador do Studio foi criado, não a data em que os pacotes foram publicados.

• Oficial - o feed oficial da UiPath online, onde você pode localizar os pacotes de atividades oficialmente compatíveis conosco. Esse feed tem a seguinte origem: https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json.
• Marketplace - esse feed público contém todas as atividades publicadas no UiPath Marketplace. Observe que o fato de os pacotes serem ou não criados e oficialmente compatíveis com a UiPath é informado especificamente na janela Gerenciar pacotes, na guia Informações dos pacotes. Esse feed tem a seguinte origem:https://gallery.uipath.com/api/v3/index.json.

Feeds personalizados

Em instalações Enterprise, um feed de atividades personalizado só pode ser usado em fluxos de trabalho iniciados no Studio desse usuário. Iniciar um trabalho na mesma máquina a partir do Orchestrator ou do Uipath Assistant faz com que o Robô não consiga recuperar o pacote apropriado. Para evitar esses cenários, adicione o feed personalizado

Importante:

Para usar feeds personalizados, certifique-se de que o Robô tenha acesso ao local personalizado.

Feeds de atividades

Quando vários feeds são usados, o NuGet seleciona aquele que responde mais rapidamente. Como os pacotes de atividades podem ter várias versões, o Robô pesquisa uma versão com base nas regras de runtime no Studio, da seguinte forma:

• Para a regra de runtime Restrita, o Robô procura apenas a versão especificada do pacote. Por exemplo, se você selecionar a Versão 2.5.0 e definir a Regra de runtime como Restrita, o Robô procurará apenas a versão 2.5.0. Se não for localizada, ele gerará um erro.

• Para a regra de runtime Versão mais baixa aplicável, o Robô procurará a versão especificada do pacote ou superior. Por exemplo, se você selecionar a Versão 2.5.0 e definir a Regra de Runtime como Versão mais baixa aplicável, o Robô procurará versões que comecem com a versão 2.5.0 (2.5.0, 2.5.1, 2.5.2 e assim por diante). Se não for localizada, ele gerará um erro.

Se um feed não tiver pacotes e dependências assinados, a automação pode falhar. Isso ocorre porque o Robô espera que todos os pacotes e dependências sejam assinados. Para evitar isso, certifique-se de que todos os feeds configurados contenham apenas pacotes e dependências assinados.

Importante:

• Sempre que modificar arquivos de configuração, você precisa reiniciar o Serviço de Robôs da UiPath para que as alterações entrem em vigor.

• Para ignorar feeds HTTPS de NuGet.config, adicione a seguinte linha em UiPath.config, em <packageSettings>:

  <add key="skipHttpConfigurationSources" value="true" />

A lista a seguir resume os feeds que o Robô usa, dependendo de como o feed está configurado:

• Se você escolher instalar o feed local, a pasta %ProgramFiles%\UiPath\Studio\Packages será criada. Ela contém os pacotes de atividades que são suportados oficialmente pela UiPath, no momento da instalação. O feed está habilitado por padrão.
• Se você optar por não instalar o feed local, a pasta %ProgramFiles%\UiPath\Studio\Packages é criada, mas ela contém apenas os pacotes que são adicionados como dependências padrão a um novo projeto:

  • UiPath.UIAutomation.Activities

  • UiPath.System.Activities

  • UiPath.Excel.Activities

  • UiPath.Mail.Activities

Quando você conecta o Robô ao Orchestrator, um feed do NuGet é fornecido pelo Orchestrator. Ele contém os pacotes de atividades oficialmente compatíveis com a UiPath. Esse feed é habilitado por padrão e depende de suas configurações de armazenamento.

A lista a seguir resume os feeds que o Robô usa, dependendo da conexão do Robô com o Orchestrator:

Robô conectado ao Orchestrator

Se NuGet.Repository.Type estiver definido como Legacy, as atividades são salvas na localização ~/NuGetPackages/Activities por padrão. Esse valor é personalizável e mantido na máquina do Orchestrator, no parâmetro NuGet.Activities.Path do arquivo web.config. Se NuGet.Repository.Type estiver configurado como Composite, as atividades são salvas no local especificado por meio dos parâmetros Storage.Type e Storage.Location. Importante: A opção Composite restringe o uso de comandos de copiar e colar no diretório de pacotes.

Robô não conectado ao Orchestrator

Quando o Robô não está conectado ao Orchestrator ou não localiza as atividades necessárias no feed local, ele usa o seguinte feed: https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json Esse é o feed oficial da UiPath online, que é a origem de onde o Gerenciador de pacotes no Studio obtém suas atividades. Por padrão, esse feed não está ativo. Para habilitá-lo, no Studio, acesse Configurações > Gerenciar oirigens e selecione a opção correspondente.

Pastas dos pacotes de fallback

Uma pasta de pacotes de fallback é uma pasta de backup da qual o Robô pode recuperar os pacotes necessários se a origem primária falhar.

Para configurar essa pasta, adicione a variável de ambiente NUGET_FALLBACK_PACKAGES na máquina do Robô. A variável deve conter a lista de caminhos completos, cada um separado por ponto e vírgula, para essas pastas de backup. Se a variável de ambiente não existir, o Robô tentará ler as pastas de pacotes NuGet de fallback do arquivo Nuget.config.

Importante:

Você não pode usar pastas de fallback para armazenar e executar automações ou fluxos de trabalho inteiros.

Os processos implantados em pastas de fallback não são compatíveis, apenas as dependências.