Pacotes e bibliotecas

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

Importante:

Use caminhos absolutos para indicar o local 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 na qual o instalador do Studio foi criado, não a data na qual os pacotes foram publicados.

• Oficial – O feed online oficial da UiPath, no qual você pode encontrar os pacotes de atividades que são suportadas oficialmente por nós. Esse feed tem a seguinte origem: https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json.
• Marketplace – Este feed público contém todas as atividades publicadas no UiPath Marketplace. Observe que se os pacotes são ou não compilados e oficialmente suportados pela UiPath é indicado 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

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 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 Estrita , o Robô procura apenas a versão do pacote especificada. Por exemplo, se você selecionar a Versão 2.5.0 e definir a Regra de Runtime como Estrita, o Robô buscará apenas a versão 2.5.0. Se não for encontrado, ele gerará um erro.

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

Se um feed não tiver pacotes e dependências assinados, a automação poderá 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.

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 será criada, mas ela conterá 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 definido como Composite, as atividades serão salvas no local especificado, por meio dos parâmetrosStorage.Type e Storage.Location . Importante: A opção Composite restringe o uso de comandos copiar-colar no diretório de pacotes.

O Robot não está conectado ao Orchestrator

Quando o Robot não está conectado ao Orchestrator ou não encontra 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 online oficial da UiPath, que é a origem de onde o Gerenciador de pacotes no Studio recupera suas atividades. Por padrão, esse feed não está ativo. Para habilitá-lo, no Studio, acesse Configurações > Gerenciar Origens e selecione a opção correspondente.

Pastas dos pacotes de fallback

Uma pasta do pacote de fallback é uma pasta de backup a partir da qual o Robot pode recuperar 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 um ponto e vírgula, para essas pastas de backup. Se a variável de ambiente não existir, o Robot tentará ler as pastas de fallback dos pacotes do NuGet a partir 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.