Pacotes e bibliotecas

Pacotes NuGet usados pelo UiPath Robot: feeds padrão, feeds locais e do Orchestrator, comportamento do cache do pacote e configuração de feed no Studio.

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 - The feed for the packages installed locally with Studio. When Studio of the same version is installed side by side with the Robot, the feed is the Packages folder of Studio, %ProgramFiles%\UiPathPlatform\Studio\<version>\Packages for per-machine installations or %LocalAppData%\Programs\UiPathPlatform\Studio\<version>\Packages for per-user installations. Otherwise, it's the Packages folder in the Robot installation folder, which might not exist.

  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.uipath.com/official/index.json.

• Marketplace - Esse feed público contém todas as atividades publicadas no UiPath Marketplace.

  Observação:

  Se os pacotes são ou não criados e oficialmente compatíveis com a UiPath é declarado especificamente na janela Gerenciar Pacotes, guia Informações do pacote.

  Esse feed tem a seguinte origem: https://gallery.uipath.com/api/v3/index.json.

Feeds personalizados

In Enterprise installations, a custom activity feed can only be used in workflows started from Studio on that user. Starting a job on the same machine from Orchestrator or the Assistant results in the Robot not being able to retrieve the appropriate package. To avoid such scenarios, add the custom feed to the NuGet.config file of the Robot. For the steps, refer to Configuring activity feeds.

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 antiga aplicável, o robô procura 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" />
  

The UiPath Platform Installer adds two feeds to the NuGet.config file in the Robot installation folder: the Local feed, and the Executors feed, which holds the executor packages for agents, functions, and API workflows. Both are enabled by default.

Quando você conecta o Robô ao Orchestrator, um feed do NuGet é fornecido pelo Orchestrator. Ele contém os pacotes de atividades que são 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 encontra as atividades necessárias no feed local, ele usa o seguinte feed:

  https://pkgs.uipath.com/official/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.