robot
2024.10
true
UiPath logo, featuring letters U and I in white

Guia do administrador do robô

Última atualização 18 de dez de 2024

Arquivos de configuração

Após editar os arquivos de configuração, você precisa reiniciar os componentes do Robô relevantes para que as alterações entrem em vigor. A tabela a seguir resume como reiniciar vários componentes, com base no modo de instalação do Robô.

Lembre-se de salvar qualquer trabalho em andamento antes de reiniciar para evitar perder qualquer progresso não salvo.

Component

Instalação do Modo de Serviço

Instalação do Modo de Usuário

Serviço de robôs

  1. Abra o Gerenciador de Tarefas > Serviços.

  2. Procure o serviço UiPathRobotSvc .
  3. Clique com o botão direito do mouse no serviço e selecione Reiniciar.

  1. Sair e reiniciar o UiPath Assistant

ou

  1. Abra o Gerenciador de Tarefas > Detalhes.

  2. Selecione o processo UiPath.Service.UserHost.exe .
  3. Selecione Finalizar tarefa.

Atualizar Serviço

  1. Abra o Gerenciador de Tarefas > Serviços.

  2. Procure o serviço UiPath.UpdateService.Agent .
  3. Clique com o botão direito do mouse no serviço e selecione Reiniciar.

UiPath RobotJS ServiceHost

  1. Abra o Gerenciador de Tarefas > Serviços.

  2. Procure o serviço UiPath.RobotJS.ServiceHost .
  3. Clique com o botão direito do mouse no serviço e selecione Reiniciar.

UiPath Assistant

  1. No UiPath Assistant, selecione Preferências e, depois, Sair.

  2. Reinicie o UiPath Assistant.

Widgets

  1. Reiniciar o UiPath Assistant.

ou

  1. Clique com o botão direito do mouse no ícone do UiPath Assistant na barra de tarefas.

  2. Selecione Recarregar widgets.

uipath.config

O arquivo UiPath.config contém parâmetros de configuração essenciais para o Robô. Como administrador, você pode personalizar o comportamento de seus robôs editando a lista de parâmetros no arquivo de configuração.
Observação:

Cada ambiente pode precisar de avisos específicos e, por isso, a UiPath permite que você aplique diferentes configurações com base no ambiente atual do robô, seja Desenvolvimento, Preparação ou Produção. Tenha sempre cuidado ao editar esse arquivo, pois uma configuração imprecisa pode causar problemas no aplicativo.

Acesso ao arquivo

Quando você instalar seu Robô, o sistema criará o arquivo UiPath.config .
Para acessá-lo, navegue até C:\Program Files\UiPath\Studio\UiPath.config.

Configurações personalizáveis

O arquivo UiPath.config consiste nos seguintes parâmetros:

Seção de configuração

Tipo de dados + nome do parâmetro

Description

Padrão

Exemplo

connectionSettings

cadeia de caracteres DefaultServiceUrl

Define o endereço padrão que o Robô usa para se conectar ao Orchestrator.

NA

string DefaultServiceUrl = "https://cloud.uipath.com"string DefaultServiceUrl = "https://cloud.uipath.com"
Bool AutoSignIn

Habilita a funcionalidade de login automático para o Assistant.

falso

bool AutoSignIn = true.bool AutoSignIn = true.
Bool EnforceDefaultServiceUrl

Impõe o endereço fornecido como DefaultServiceUrl para todos os usuários.

falso

bool EnforceDefaultServiceUrl = true.bool EnforceDefaultServiceUrl = true.
communicationSettingsbyte MaxMessageSizeInMegabytes

Define o tamanho máximo de uma mensagem que o sistema pode enviar ou receber, em MB.

Isso é usado para evitar sobrecarga ou falhas de processo devido ao processamento de mensagens muito grandes.

10 MB

byte MaxMessageSizeInMegabytes = 10;byte MaxMessageSizeInMegabytes = 10;
Intervalo de Tempo InstallPackageTimeout

Define o limite de tempo para instalações de pacotes.

Se uma instalação de pacote levar mais tempo do que o tempo definido, o sistema anulará a instalação.

Expresso como TimeSpan.

20 minutos

TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
Intervalo de Tempo RequestTimeout

Define por quanto tempo o sistema aguarda uma resposta de comunicação.

Se o sistema não receber uma resposta no período definido, ele para e avança.

Isso evita travamentos do sistema.

Expresso como TimeSpan.

40 segundos

TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
packageSettingscadeia de caracteres PackagesInstallationFolder

Define o diretório padrão em que os pacotes são instalados.

C:\UiPath\Packages 
Bool SkipHttpConfigurationSources

Permite que o sistema ignore origens de pacote configuradas em HTTP, como feeds do NuGet.

Isso significa que o sistema não recupera pacotes dessas origens, o que é útil quando as origens não são confiáveis ou seguras.

falso

 
Bool DisableSecureXaml

Permite que o Robô execute fluxos de trabalho potencialmente inseguros.

falso

 
Bool DirectDownload

Permite o download direto de pacotes, sem solicitar o usuário.

falso

 
Bool PackageSaveWithoutNupkg
Permite salvar os pacotes sem o arquivo .nupkg .

Isso é útil para reduzir o tamanho do download.

falso

 
analyticsSettingsBool Telemetry.Enabled

Permite que o UiPath colete e envie dados de uso para análise.

falso

 
webProxySettingscadeia de caracteres ScriptAddress

Define o endereço do script que determina como e quando usar o proxy.

  
cadeia de caracteres ProxyAddress

Define o endereço do servidor de proxy, seja o IP ou o nome do domínio.

  
cadeia de caracteres BypassList

Contém a lista de endereços que se conectam diretamente à Internet, ignorando o servidor de proxy.

  
Bool BypassLocalAddresses

Permite conexão direta para endereços locais, ignorando o Servidor do Proxy.

falso

 
cadeia de caracteres UserName

Define a credencial de nome de usuário para autenticação do servidor proxy.

  
cadeia de caracteres PasswordDefine a senha associada ao nome de usuário para a autenticação do servidor proxy.  
cadeia de caracteres DomainDefine o domínio no qual o servidor de proxy reside, necessário para a autenticação.  
robotCacheSettingsIntervalo de Tempo SessionCacheDuration

Define por quanto tempo os dados de uma sessão específica devem ser retidos no cache antes de serem descartados.

Isso é útil para reutilizar dados como valores de variáveis ou detalhes de operações, em vez de recriá-los ou recuperá-los.

Expresso como TimeSpan.

30 segundos

TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
Intervalo de Tempo GetResourceUrlCacheDuration

Define por quanto tempo as URLs para recursos, como APIs ou páginas da web, são armazenadas em cache.

Isso é útil para otimizar o desempenho em cenários nos quais seus robôs precisam acessar determinados recursos regularmente.

Expresso como TimeSpan.

1 hora

TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
robotJsSettingsListenerPort

Define o número da porta na qual o Robot.js escuta as conexões de entrada.

Isso permite que o Serviço de Robôs da UiPath interaja com aplicativos da Web em execução em servidores locais ou remotos.

2323

int ListenerPort = 2323;int ListenerPort = 2323;
TokenExpiryInDays

Define o período de validade, em dias, dos tokens de autenticação gerados pelo serviço de robôs.

O Serviço de Robôs da UiPath usa esses tokens para se autenticar ao interagir com outros componentes de software ou serviços.

30 dias

int TokenExpiryInDays = 30;int TokenExpiryInDays = 30;
cadeia de caracteres AllowUrlList

Define a lista de URLs que o Serviço de Robôs da UiPath pode acessar.

Isso ajuda a garantir que seu Serviço de Robôs da UiPath interaja apenas com serviços aprovados.

 
string AllowUrlList = "https://cloud.uipath.com";string AllowUrlList = "https://cloud.uipath.com";
Importante:
  • Sempre crie um backup do arquivo UiPath.config original antes de fazer qualquer alteração. Isso pode ajudar a restaurar as configurações originais se algo der errado.
  • Para aplicar as atualizações feitas no arquivo UiPath.config , reinicie o serviço da UiPath ou o sistema.
  • As configurações locais no arquivo UiPath.config têm precedência sobre as configurações configuradas no Orchestrator.
  • Dados confidenciais no arquivo UiPath.config podem ser criptografados para segurança adicional.

Variáveis do sistema do UiPath Robot

Outros comportamentos personalizados podem ser configurados por meio das variáveis de ambiente do sistema.

Após modificar qualquer uma das variáveis do sistema, reinicie o Serviço do Robô.

A lista a seguir resume os casos de uso mais comuns:

Variável do sistema

Uso

Exemplo

UIPATH_SESSION_TIMEOUTAltera o tempo limite padrão de 60 segundos para criar uma sessão interativa.

Ajuste esse valor para adaptar o comportamento do Robô com base no desempenho e tempos de carregamento do sistema com o qual ele interage.

UIPATH_SESSION_TIMEOUT=75UIPATH_SESSION_TIMEOUT=75
UIPATH_PIP_SESSION_TIMEOUT

Altera o tempo limite padrão de 180 segundos para iniciar um processo em uma sessão do UiPath Robot.

UIPATH_PIP_SESSION_TIMEOUT=60UIPATH_PIP_SESSION_TIMEOUT=60
UIPATH_USER_SERVICE_PATHDefine o caminho de instalação do serviço de usuário.
UIPATH_USER_SERVICE_PATH=C://installation/folder/UiPath.Service.UserHost.exeUIPATH_USER_SERVICE_PATH=C://installation/folder/UiPath.Service.UserHost.exe
UIPATH_LANGUAGE

Define o idioma em que o Robô opera.

A ordem para determinar o idioma é:

  1. Valor UIPATH_LANGUAGE
  2. A variável de ambiente da máquina

  3. A cultura de interface gráfica do thread atual

  4. Idioma padrão da UiPath (inglês)

UIPATH_LANGUAGE=FrenchUIPATH_LANGUAGE=French
UIPATH_HEADLESS_WITH_USER

Usa as credenciais de um usuário específico, que foram configuradas anteriormente no Orchestrator.

UIPATH_HEADLESS_WITH_USER=TrueUIPATH_HEADLESS_WITH_USER=True
UIPATH_PRE_LOADED_EXECUTOR

By default, a preloaded executor is launched when the Robot starts.

To change this behavior and launch the preloaded executor only when the first process runs, set this variable to None.
UIPATH_PRE_LOADED_EXECUTOR=NoneUIPATH_PRE_LOADED_EXECUTOR=None
UIPATH_DISABLE_PRE_LOADED_EXECUTOR

Desabilita a funcionalidade do executor pré-carregado.

UIPATH_DISABLED_PRE_LOADED_EXECUTOR=TrueUIPATH_DISABLED_PRE_LOADED_EXECUTOR=True
UIPATH_ROBOTJS_ALLOWLIST

Aceita automaticamente a caixa de diálogo consentimento do robô, ao estabelecer a conexão entre o Robot JS SDK e o Executor do Robô.

The variable accepts custom application URLs, separated by semicolons. Include the port number in the URL if it differs from the standard ports (80 or 443).

UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;
UIPATH_DNS_MACHINENAME

Permite usar o nome do host do DNS para o Localhost ao criar sessões de RDP. Para executar trabalhos Unattended em ambientes com autenticação Kerberos para RDP, defina esse valor como True.

UIPATH_DNS_MACHINENAME=TrueUIPATH_DNS_MACHINENAME=True
UIPATH_PROXY_USE_DEFAULT_CREDENTIALS

Permite que o Robô lide com configurações de proxy que usam as Credenciais do Windows para a autenticação.

UIPATH_PROXY_USE_DEFAULT_CREDENTIALS=TrueUIPATH_PROXY_USE_DEFAULT_CREDENTIALS=True
NUGET_FALLBACK_PACKAGES

Configura os caminhos para as pastas dos pacotes de fallback. Use ponto e vírgula para separar vários caminhos.

Na ausência dessa variável, o Robô procura as pastas dos pacotes de fallback no arquivo Nuget.config .
 
NUGET_SCRATCH

Allows multiple User Mode robots on the same machine to share a local path for storing packages.

O valor deve ser um caminho diferente para a pasta de instalação do NuGet e ele funciona como uma pasta temporária para o NuGet.

Observação:
Apenas a variável NUGET_SCRATCH deve usar a pasta temporária configurada.
NUGET_SCRATCH=C:\NuGetTempFolderNUGET_SCRATCH=C:\NuGetTempFolder
UIPATH_PRESERVE_CREDENTIALS_CASE

Preserva o uso original de maiúsculas e minúsculas das credenciais de log (domínio/nome de usuário).

UIPATH_PRESERVE_CREDENTIALS_CASE = TrueUIPATH_PRESERVE_CREDENTIALS_CASE = True
  • uipath.config
  • Acesso ao arquivo
  • Configurações personalizáveis
  • Variáveis do sistema do UiPath Robot

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.