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.

If a feed lacks signed packages and dependencies, the automation might fail. This is because the Robot expects all packages and dependencies to be signed. To prevent this, ensure that all configured feeds contain only signed packages and dependencies.

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.