Gerenciamento de pacotes de atividades

O Studio usa feeds do NuGet para instalar pacotes de atividades. É possível lidar com esses feeds de duas maneiras no Studio:

• nível de aplicativo - feeds são configurados a partir da aba Configurações > Gerenciar fontes;
• nível do projeto – os feeds são configurados no botão Gerenciar Pacotes na faixa de opções.

Para desabilitar um feed de atividades, você deve limpar sua caixa de seleção correspondente. Habilitar ou desabilitar um feed é aplicável no nível dos projetos e dos aplicativos.

Os seguintes feeds serã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 fica indicado se os pacotes foram criados pela UiPath e se são compatíveis de forma oficial com ela na janela Gerenciar Pacotes, na guia Informações do Pacote. Esse feed tem a seguinte origem: https://gallery.uipath.com/api/v3/index.json.

  Observe que a UiPath não tem controle dos pacotes não registrados criados por parceiros ou pela comunidade do UiPath Marketplace. No entanto, a UiPath mantém os pacotes ativos não registrado para garantir a compatibilidade retroativa para fins de tempo de execução.

  Todas as atividades do Marketplace são verificadas pela UiPath e devem passar na Certificação de Segurança do Marketplace.

  
  

  

  
  
  Observação: a configuração do feed é mantida após a atualização para uma versão mais recente do Studio.

Outros feeds podem ser adicionados separadamente, como:

• Setor público - Esse feed é específico para o Automation Cloud para Setor Público e é hospedado nos Estados Unidos. Esse feed tem a seguinte origem: https://govcloud.uipath.us/nuget/v3/_shared/libraries/index.json.

O gerenciamento e a configuração do feed estará disponível na janela Gerenciar Pacotes se uma política de governança não tiver sido aplicada. Se uma política desse tipo tiver sido aplicada e tiver os direitos restritos em relação ao gerenciamento de feeds, uma mensagem será exibida na janela. Leia mais sobre Governança.

Como adicionar feeds personalizados

Observação: 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, você deve adicionar o feed personalizado no arquivo UiPath.settings na propriedade ActivitiesFeed em vez de usar o método abaixo.

1. Na janela Gerenciar Pacotes, clique em Configurações. As origens dos pacotes serão exibidas.
   
   

   

   
   
2. Clique no botão para adicionar um feed à categoria Origens de pacotes definidas pelo usuário.
3. Preencha o nome da origem do pacote ou o nome do feed do NuGet.
4. No campo Origem, digite o caminho da pasta de unidade local, o caminho da pasta compartilhada ou a URL do feed do NuGet.
5. Clique em Adicionar. O novo feed será adicionado automaticamente entre as Origens de pacotes definidas pelo usuário e na categoria Todos os Pacotes da janela Gerenciar Pacotes. O feed fica habilitado por padrão.
6. Clique em Salvar para aplicar todas as alterações.

As origens de pacotes padrão e definidas pelo usuário podem ser habilitadas ou desabilitadas na janela Gerenciar Pacotes.

Os feeds serão adicionados imediatamente. Clicar no botão Fechar ou Cancelar depois de adicionar um feed não reverte as alterações.

Observação: se o feed personalizado contiver um pacote corrompido ou que esteja atualmente sendo modificado em um editor, o Gerenciador de Pacotes não poderá carregar nenhum pacote no feed.

Como adicionar feeds seguros

Se você quiser adicionar um feed NuGet personalizado que exija autenticação, siga as etapas explicadas aqui.

É preciso adicionar os valores de usuário e senha do feed do NuGet no arquivo NuGet.config, localizado no seguinte caminho: %AppData%\NuGet. Quando estiver concluído, o feed deve ficar visível na janela Gerenciar Pacotes.

<packageSources>
  <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  <add key="FeedName" value="https://FeedSource" />
  </packageSources>
  
 <packageSourceCredentials>
  <FeedName>
    <add key="Username" value="YourUsername" />
    <add key="Password" value="YourPassword" />
  </FeedName>
</packageSourceCredentials>

Por favor, leve em consideração que key="ClearTextPassword" deve substituir key="Password" quando as senhas não criptografadas forem usadas.

Como remover feeds personalizados

Observação: somente origens de pacote definidas pelo usuário podem ser removidas da janela Gerenciar Pacotes.

1. Na categoria Configurações, clique em qualquer um dos feeds na seção Origens de pacotes definidas pelo usuário.
2. Pressione o botão Remover . O feed é removido da categoria Todos os pacotes e da seção Fontes de pacotes definidas pelo usuário.
3. Clique em Salvar para aplicar as alterações.

Os feeds serão removidos imediatamente. Clicar no botão Fechar ou Cancelar depois de remover os feeds padrão ou personalizados não reverte as alterações.

Como se conectar aos feeds por meio de um servidor proxy

Se seu computador estiver atrás de um servidor proxy, é necessário configurar as definições de proxy do NuGet para ter acesso a feeds localizados fora da sua rede:

1. Baixe o instalador nuget.exe em https://www.nuget.org/downloads.
2. Abra uma janela de prompt de comando na pasta em que o instalador nuget.exe foi baixado e execute os seguintes comandos para configurar o endereço, o nome de usuário e a senha para o servidor proxy:

   nuget.exe config -set http_proxy=<http://proxy.server.address:port>

   nuget.exe config -set http_proxy.user=<mydomain\myUserName>

   nuget.exe config -set http_proxy.password=<myPassword>

3. Verifique se o arquivo NuGet.config localizado em %AppData%\NuGet foi atualizado com a nova configuração:

   <config>
       <add key="http_proxy" value="http://proxy.server.address:port" />
       <add key="http_proxy.user" value="mydomain\myUserName" />
       <add key="http_proxy.password" value="myEncryptedPassword" />
   </config>

4. Reinicie o Studio.

Gerenciamento de pacotes

A funcionalidade gerenciador de pacotes permite que você baixe pacotes de atividades, estruturas, wrappers e outros, veja o que já está instalado no seu projeto e faça atualizações, além de adicionar e remover suas próprias funcionalidades. É mostrada uma lista de pacotes disponíveis por feed e a lista de dependências por projeto atual. A janela Gerenciar Pacotes sempre será aberta com a lista Dependências do Projeto.

Um pacote de atividades pode ajudar a automatizar um determinado aplicativo (UiPath.Excel.Activities, UiPath.Word.Activities) ou uma categoria de aplicativos (UiPath.Mail.Activities, UiPath.Terminal.Activities), ou a usar determinadas tecnologias em suas automações (UiPath.OCR.Activities, UiPath.FTP.Activities).

Informações detalhadas sobre os pacotes e as bibliotecas serão exibidas no painel direito da janela Gerenciar Pacotes, conforme a captura de tela acima.

Observação: as notas de versão para pacotes de atividades não estão visíveis na janela Gerenciar Pacotes devido a uma limitação do NuGet v3.

A caixa de seleção Incluir pré-lançamento ao lado da barra Pesquisar, exibe as versões beta dos pacotes de bibliotecas, se disponíveis, quando selecionada. A visibilidade da caixa de seleção pode ser controlada usando políticas de governança.

Marque a caixa Incluir Pré-lançamento se as descrições para as dependências do projeto não estiverem visíveis na janela Gerenciar Pacotes.

Observação: Os pacotes UiPath.UIAutomation.Activities e UiPath.System.Activities são compatíveis com o Studio v2018.3 e versões posteriores.

Instalando Pacotes

Observação: é necessária uma conexão com a internet para baixar e instalar os pacotes de atividades.

Observação: se sua organização usa assinatura de pacote forçada, você precisa adicionar certificados confiáveis para a UiPath para poder instalar pacotes oficiais. Você pode ler mais sobre isso aqui.

1. Na janela Gerenciar Pacotes, selecione a categoria Todos os Pacotes. Isso abre uma lista de todos os pacotes coletados de seus feeds.
   
   

   

   
   
2. Localize o pacote que você deseja instalar. Observe que os pacotes e versões das atividades que ficam disponíveis dependem da compatibilidade selecionada para o projeto.

   Você pode:

   • Rolar para baixo na lista para localizar o pacote.
   • Pesquisar o pacote, digitando parte do nome ou da descrição na barra de pesquisa.

   • Filtrar a lista, clicando no ícone Filtrar ao lado da barra de pesquisa e selecionando apenas as opções que você deseja exibir:

     • Incluir Pré-lançamento – Inclui as versões beta dos pacotes, quando disponíveis.
     • Apenas StudioX - Lista somente pacotes criados para o StudioX. (essa opção está disponível apenas no perfil do StudioX)
     • Somente UiPath – Lista apenas os pacotes publicados pela UiPath.
     • Somente atividades – Lista apenas os pacotes de atividades.
     • Apenas bibliotecas – Lista apenas as bibliotecas.
     • Somente bibliotecas de interface gráfica – Lista apenas as bibliotecas de interface gráfica publicadas do Repositório de Objetos.
     • Apenas Compatível — lista apenas pacotes cuja versão mais recente é compatível com a compatibilidade do projeto. Não selecione essa opção se quiser ver pacotes com versões mais antigas que também são compatíveis com a compatibilidade do projeto.
3. Selecione um pacote de atividades para ver sua descrição, versão, dependências, a URL do projeto e a data quando foi publicado.
4. Clique na lista suspensa ao lado de Versão para escolher uma versão do pacote e, em seguida, defina uma Regra de tempo de execução. Para ler mais sobre regras de runtime para dependências do projeto, consulte a página Gerenciando dependências.
5. Clique no botão Instalar. Como alternativa, clique no ícone ao lado do nome do pacote para marcá-lo com o ícone , deixando-o pronto para a instalação.
6. A janela Aceitação da Licença exibe os termos da licença para cada pacote de terceiros que você deseja instalar. Clique em Exibir Licença para ler os termos da licença.
   • Clique em Aceito para concordar com os termos da licença e instalar os pacotes.

   • Clique em Não concordo para cancelar a instalação e retornar para a janela Gerenciar Pacotes.

     Observação: os termos e condições dos pacotes da UiPath e suas dependências são aceitos implicitamente ao instalar o Studio. Leia os Termos de uso e a Política de privacidade da UiPath.
7. Clique em Salvar para instalar os pacotes ou atualizar as versões.
   Observação: se durante a instalação de um pacote de atividades o caminho for corrompido, a instalação não será concluída. É recomendável realizar o backup e limpar o conteúdo das seguintes pastas locais %userprofile%\.nuget\packages e %userprofile%\AppData\Local\UiPath\.cache.

Como desinstalar os pacotes

Para desinstalar pacotes, acesse a categoria Dependências do projeto e clique no botão Desinstalar ao lado do pacote que você não deseja mais usar. O pacote será removido apenas após você clicar em Salvar.

Ao executar um projeto de automação, o botão Gerenciar Pacotes será desabilitado, o que significa que os pacotes de atividades não podem ser instalados ou removidos até que a execução seja interrompida.

Downgrade de pacotes

O downgrade de pacotes de atividades não é recomendado. O principal motivo são os efeitos negativos que issso pode ter nas dependências. As dependências entre diferentes pacotes de atividades são gerenciadas criteriosamente em cada versão. Portanto, o downgrade pode causar inconsistências ou até mesmo fluxos de trabalho disfuncionais. Além disso, os pacotes de atividades mais recentes oferecem recursos e funcionalidades aprimoradas que podem não estar disponíveis em versões mais antigas. Assim, para garantir um desempenho ideal e evitar possíveis erros, é aconselhável manter pacotes de atividades em suas versões atuais ou fazer upgrade para as versões mais recentes.

Como alterar a pasta de download para os pacotes

Por padrão, os pacotes de atividades serão baixados e instalados na pasta %userprofile%\.nuget\packages. Você pode definir uma pasta diferente de uma das seguintes maneiras:

• Durante a instalação, instalando da linha de comando com a opção PACKAGES_FOLDER.
• Após a instalação, editando manualmente o arquivo uipath.config:
  1. Abra o arquivo uipath.config em um editor de texto. Por padrão, o arquivo fica localizado em C:\Program Files\UiPath\Studio.
  2. No nó packageSettings, adicione a chave packagesInstallationFolder com o caminho para a nova pasta como seu valor.

  3. Salve as alterações e, se o Robô estiver instalado como um serviço, reinicie o serviço.

     Por exemplo, adicione o seguinte a uipath.config para alterar o local de download para C:\nuget.

     <packageSettings>
       <add key="packagesInstallationFolder" value="C:\Nuget" />
     </packageSettings>

Observação: a exclusão do conteúdo da pasta .nuget causa conflitos de dependência ao abrir um projeto no Studio.

Gerenciamento de pacotes em ambientes offline

Quando você está usando o Studio em um computador que não está conectado à internet, você pode baixar pacotes em outro computador e transferi-los manualmente para o computador no qual o Studio está instalado. Isso só é necessário se a conectividade do Orchestrator não estiver disponível. Quando o Studio está conectado ao Orchestrator, os pacotes podem ser instalados a partir de feeds do Orchestrator.

Observação: para evitar que o Studio tente baixar pacotes de feeds online, desabilite todos os feeds online em máquinas offline.

Para instalar um pacote em uma máquina do Studio offline:

1. Em um computador com acesso à internet, baixe e instale o NuGet Package Explorer.
2. Abra o NuGet Package Explorer e selecione Abrir um pacote a partir de um feed online.
3. No campo Origem do pacote, digite a URL do feed a partir do qual baixar o pacote. O feed oficial de pacotes do UiPath é https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json.
4. Localize o pacote no feed e baixe-o.
5. Transfira o arquivo NUPKG para o computador do Studio em uma pasta definida como uma origem de pacotes no Studio. Para adicionar o pacote ao feed local padrão, copie o arquivo para %ProgramFiles%\UiPath\Studio\Packages para instalações por máquina ou %localappdata%\Programs\UiPath\Studio\Packages para instalações por usuário.

Uso do Arquivo com pacotes opcionais

Para reduzir o tamanho do instalador do Studio, vários pacotes de atividade não estão mais incluídos no arquivo UiPathStudio.msi a partir da versão 2022.10. Para facilitar a tarefa dos usuários que estão trabalhando em ambientes isolados ou sempre mantêm os pacotes de que precisam no armazenamento local, um arquivo ZIP com os pacotes que não estão mais incluídos no instalador e suas dependências está disponível para download a partir do Customer Portal, permitindo que você coloque os pacotes no Studio ou máquinas do UiPath Robot.

O arquivo contém as versões mais recentes dos seguintes pacotes:

• UiPath.MobileAutomation.Activities
• UiPath.Terminal.Activities
• UiPath.Persistence.Activities
• UiPath.PDF.Activities

Para adicionar os pacotes à pasta de feed local:

1. Baixe o arquivo ZIP do UiPath Customer Portal.
2. Coloque o arquivo em um local acessível a partir do Studio ou máquina do robô.

3. Adicione os pacotes de uma das seguintes maneiras:

• Durante a instalação - antes de iniciar a instalação, coloque o arquivo na mesma pasta raiz que o instalador do Studio MSI. Os pacotes são adicionados à pasta de feed local pelo instalador.
• Após a instalação - extraia o conteúdo do arquivo para a pasta de pacotes locais, por padrão:
  • %localappdata%\Programs\UiPath\Studio\Packages para instalações por usuário.
  • %ProgramFiles%\UiPath\Studio\Packages para instalações por máquina.