Pacotes e bibliotecas

Pacotes e bibliotecas usados pelo UiPath Robot: como são estruturados, onde são armazenados e como configurar feeds e locais de fallback.

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 sã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\Package 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 encontrar os pacotes de atividades que são 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.

  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, the custom feed must be added to the Orchestrator feed configuration.

Importante:

For custom feeds to work, the Robot requires access to the custom location.

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ô 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" >

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