- Notas de Versão
- Introdução
- Configuração e Instalação
- Projetos de automação
- Sobre a publicação de projetos de automação
- Projetando automações
- Gerenciamento de pacotes de atividades
- Como definir as configurações do projeto de atividades
- Como assinar pacotes
- Governança
- Como importar entidades
- Experiência de Criação Moderna
- Vincular um projeto a uma ideia no Automation Hub
- Usando o Gerenciador de dados
- Dependências
- Tipos de fluxos de trabalho
- Comparação de arquivos
- Melhores Práticas de Automação
- Integração de controle de origem
- Depuração
- A ferramenta de diagnóstico
- Variáveis
- Argumentos
- Namespaces Importados
- Automação assistida baseada em gatilho
- Gravação
- Elementos de Interface Gráfica
- Fluxo de controle
- Seletores
- Repo. de Objetos
- Extração de Dados
- Automação de imagem e texto
- Citrix Technologies Automation
- Automação RDP
- Automação da Salesforce
- Automação SAP
- Automação do Varear Horizonte
- Geração de logs
- A ferramenta ScreenScrapeJavaSupport
- O protocolo Servodrive
- Test Suite — Studio
- Extensões
- Solução de problemas
- Sobre a solução de problemas
- Suporte e limitações do Microsoft Apo-V
- Solução de problemas do Internet Explorer x64
- Problemas do Microsoft Office
- Como identificar elementos de EU em PDF com opções de acessibilidade
- Reparando o suporte da Active Accessibility
- Automação de aplicativos em execução com um usuário diferente do Windows
- Validation of large Windows-legacy projects takes longer than expected
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 oficial da UiPath® online, onde você pode encontrar os pacotes de atividades que são oficialmente aceitos 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.
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.
UiPath.settings
na propriedade ActivitiesFeed em vez de usar o método abaixo.
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.
Se você quiser adicionar um feed NuGet personalizado que exija autenticação, siga as etapas explicadas aqui.
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>
<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>
key="ClearTextPassword"
deve substituir key="Password"
quando as senhas não criptografadas forem usadas.
- Na categoria Configurações, clique em qualquer um dos feeds na seção Origens de pacotes definidas pelo usuário.
- Pressione o botão Remover . O feed é removido da categoria Todos os pacotes e da seção Fontes de pacotes definidas pelo usuário.
- 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.
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:
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.
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.
A caixa de seleção Incluir Pré-lançamento ao lado da barra Pesquisar exibirá as versões beta dos pacotes de biblioteca, se disponíveis, quando selecionada.
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.
UiPath.UIAutomation.Activities
e UiPath.System.Activities
são compatíveis com o Studio v2018.3 e versões posteriores.
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.
%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
:- Abra o arquivo
uipath.config
em um editor de texto. Por padrão, o arquivo fica localizado emC:\Program Files\UiPath\Studio
. - No nó
packageSettings
, adicione a chavepackagesInstallationFolder
com o caminho para a nova pasta como seu valor. -
Salve as alterações e, se o Robô estiver instalado como um serviço, reinicie o serviço.
Por exemplo, adicione o seguinte auipath.config
para alterar o local de download paraC:\nuget
.<packageSettings> <add key="packagesInstallationFolder" value="C:\Nuget" /> </packageSettings>
<packageSettings> <add key="packagesInstallationFolder" value="C:\Nuget" /> </packageSettings>
- Abra o arquivo
.nuget
causa conflitos de dependência ao abrir um projeto no Studio.
Para instalar um pacote em uma máquina do Studio offline:
- Em um computador com acesso à internet, baixe e instale o NuGet Package Explorer.
- Abra o NuGet Package Explorer e selecione Abrir um pacote a partir de um feed online.
-
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
. - Localize o pacote no feed e baixe-o.
-
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.
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:
- Baixe o arquivo ZIP do UiPath Customer Portal.
- Coloque o arquivo em um local acessível a partir do Studio ou máquina do robô.
-
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.
- Como adicionar feeds personalizados
- Como adicionar feeds seguros
- Como remover feeds personalizados
- Como se conectar aos feeds por meio de um servidor proxy
- Gerenciamento de pacotes
- Instalando Pacotes
- Como alterar a pasta de download para os pacotes
- Gerenciamento de pacotes em ambientes offline
- Uso do Arquivo com pacotes opcionais