Arquivos de configuração

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

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

• Serviço de robôs
  • Instalação do Modo de Serviço
    1. Abra 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.
  • Instalação do Modo de usuário — Saia e depois reinicie o UiPath Assistant ou:
    1. Abra Gerenciador de tarefas > Detalhes.
    2. Selecione o processo UiPath.Service.UserHost.exe.
    3. Selecione Encerrar tarefa.
• Atualizar Serviço
  1. Abra 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 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, em seguida, Sair.
  2. Reinicie o UiPath Assistant.
• Widgets - Reiniciar o Assistant ou:
  1. Clique com o botão direito do mouse no ícone do UiPath Assistant na barra de tarefas.
  2. Selecionar 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, portanto, o UiPath permite que você aplique diferentes configurações com base no ambiente atual do robô, seja Desenvolvimento, Preparação ou Produção. Sempre tenha cuidado ao editar esse arquivo, pois a configuração imprecisa pode causar problemas de aplicativos.

Acessando o arquivo

Quando você instala seu robô, o sistema cria 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:

• Na seção de configuração connectionSettings
  • DefaultServiceUrl (string) - Define o endereço padrão que o Robô usa para se conectar ao Orchestrator. Exemplo:

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

  • AutoSignIn (bool) - Habilita a funcionalidade de login automático para o UiPath Assistant. O valor padrão é false. Exemplo:

    bool AutoSignIn = true.

  • EnforceDefaultServiceUrl (bool) - Impõe o endereço fornecido como DefaultServiceUrl para todos os usuários. O valor padrão é false. Exemplo:

    bool EnforceDefaultServiceUrl = true.

• Na seção de configuração communicationSettings
  • MaxMessageSizeInMegabytes (byte) - Define o tamanho máximo de uma mensagem que o sistema pode enviar ou receber, em MB. O valor padrão é 10.

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

    byte MaxMessageSizeInMegabytes = 10;

  • InstallPackageTimeout (TimeSpan) - Define o limite de tempo para instalações de pacotes. O valor padrão é 20 minutos.

    Se uma instalação de pacote levar mais tempo do que o tempo definido, o sistema aborta a instalação. Exemplo:

    TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);

  • RequestTimeout (TimeSpan) - Define por quanto tempo o sistema espera por uma resposta de comunicação. O valor padrão é de 40 segundos.

    Se o sistema não receber uma resposta no período definido, ele para e segue em frente. Isso impede travamentos do sistema. Exemplo:

    TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);

• Na seção de configuração packageSettings
  • PackagesInstallationFolder (string) — define o diretório padrão em que os pacotes são instalados. O valor padrão é C:\UiPath\Packages.
  • SkipHttpConfigurationSources (bool) - Permite que o sistema ignore origens de pacotes configuradas por HTTP, como feeds NuGet. O valor padrão é false.

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

  • DisableSecureXaml (bool) - Permite que o Robô execute fluxos de trabalho potencialmente inseguros. O valor padrão é false.
  • DirectDownload (bool) — permite o download direto de pacotes, sem solicitar ao usuário. O valor padrão é false.
  • PackageSaveWithoutNupkg (bool) — permite salvar os pacotes sem o arquivo .nupkg . O valor padrão é false.

    Isso é útil para reduzir o tamanho do download.

• Na seção de configuração analyticsSettings
  • Telemetry.Enabled (bool) - Permite que a UiPath colete e envie dados de uso para análise. O valor padrão é false.
• Na seção de configuração robotCacheSettings
  • SessionCacheDuration (TimeSpan) - define por quanto tempo os dados de uma sessão específica devem ser mantidos no cache antes de serem descartados. O valor padrão é 30 segundos.

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

    TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);

  • GetResourceUrlCacheDuration (TimeSpan) - define por quanto tempo os URLs para recursos, como APIs ou páginas da web, são armazenados no cache. O valor padrão é de uma (1) hora.

    Isso é útil para otimizar o desempenho em cenários em que seus robôs precisam acessar certos recursos regularmente. Exemplo:

    TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);

• Na seção de configuração robotJsSettings
  • ListenerPort (int) - Define o número da porta no qual o Robot.js escuta conexões de entrada. O valor padrão é 2323.

    Isso permite que o serviço de robôs da UiPath interaja com aplicativos web executados em servidores locais ou remotos. Exemplo:

    int ListenerPort = 2323;

  • TokenExpiryInDays (int) - Define o período de validade, em dias, de tokens de autenticação gerados pelo serviço de robôs. O valor padrão é de 30 dias.

    O serviço de robôs usa esses tokens para autenticar-se ao interagir com outros componentes ou serviços de software. Exemplo:

    int TokenExpiryInDays = 30;

  • AllowUrlList (string) - 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. Exemplo:

    string AllowUrlList = "https://cloud.uipath.com";

Importante:

• Sempre crie uma cópia de segurança do arquivo original UiPath.config 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 ao arquivo UiPath.config, reinicie o serviço UiPath ou o sistema.
• As configurações locais no arquivo UiPath.config têm precedência sobre as configurações definidas no Orchestrator.
• Os dados confidenciais no arquivo UiPath.config podem ser criptografados para segurança adicional.

Variáveis do sistema do UiPath Robot

O comportamento personalizado adicional pode ser configurado por meio de variáveis de ambiente do sistema.

Importante:

Depois de modificar qualquer uma das variáveis do sistema, reinicie o Serviço de Robôs da UiPath.

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

• UIPATH_SESSION_TIMEOUT - Altera o tempo limite padrão de 60 segundos para a criação de uma sessão interativa. Ajuste esse valor para adaptar o comportamento do Robô com base no desempenho e nos tempos de carregamento do sistema com o qual ele interage.

  Exemplo:

  UIPATH_SESSION_TIMEOUT=75

• UIPATH_PIP_SESSION_TIMEOUT - Altera o tempo limite padrão de 180 segundos para o início de um processo em uma sessão do Robô.

  Exemplo:

  UIPATH_PIP_SESSION_TIMEOUT=60

• UIPATH_LANGUAGE - Define o idioma em que o Robô opera. A ordem de precedência é:
  1. Valor UIPATH_LANGUAGE
  2. Variável de ambiente da máquina
  3. cultura de interface do usuário do tópico atual
  4. Idioma padrão do UiPath (inglês)

  Exemplo:

  UIPATH_LANGUAGE=French

• UIPATH_HEADLESS_WITH_USER - Usa as credenciais de um usuário específico, que foi configurado anteriormente no Orchestrator.

  Exemplo:

  UIPATH_HEADLESS_WITH_USER=True

• UIPATH_PRE_LOADED_EXECUTOR - Por padrão, um executor pré-carregado é lançado quando o robô é iniciado. Para alterar esse comportamento e lançar o executor pré-carregado apenas quando o primeiro processo for executado, defina essa variável como None.

  Exemplo:

  UIPATH_PRE_LOADED_EXECUTOR=None

• UIPATH_DISABLE_PRE_LOADED_EXECUTOR - Desabilita a funcionalidade de executor pré-carregado.

  Exemplo:

  UIPATH_PRE_LOADED_EXECUTOR=None

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

  A variável aceita URLs de aplicativos personalizados, separados por ponto e vírgula. Inclua o número da porta na URL se ele diferir das portas padrão (80 ou 443).

  Exemplo:

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

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

  Exemplo:

  UIPATH_DNS_MACHINENAME=True

• NUGET_FALLBACK_PACKAGES - Configura os caminhos para pastas de pacotes de fallback. Use ponto e vírgula para separar vários caminhos.
  Na ausência dessa variável, o Robô pesquisa por pastas de pacotes de fallback no arquivo Nuget.config.
• NUGET_SCRATCH - Permite que vários robôs no Modo de Usuário na mesma máquina compartilhem um caminho local para armazenar pacotes.

  O valor deve ser um caminho diferente da pasta de instalação do Nuget e atua como uma pasta temporária para o NuGet.

  Observação: apenas a variável NUGET_SCRATCH deve usar a pasta temporária configurada.

  Exemplo:

  NUGET_SCRATCH=C:\NuGetTempFolder

• UIPATH_PRESERVE_CREDENTIALS_CASE - Preserva o uso original de maiúsculas/minúsculas das credenciais de registro em log (domínio\username).

  Exemplo:

  UIPATH_PRESERVE_CREDENTIALS_CASE = True

• UIPATH_SESSION_BEHAVIOR - Configura a maneira como a restauração da sessão se comporta após a conclusão de um trabalho. As seguintes opções estão disponíveis:
  • TryReuseAndRestoreSession—Opção padrão. Tenta reutilizar a sessão e restaurá-la para o estado anterior após a conclusão da tarefa. Se não houver uma sessão inicial para reutilizar, ela será desconectada na restauração.
  • ForceNew—Cria uma sessão completamente nova, independentemente do estado da sessão anterior. Sempre desconecta ao restaurar.
  • LeaveSessionActive—Impede a restauração do estado da sessão inicial.
  • LeaveSessionDisconnected—Sempre desconecta a sessão ao restaurar.

  Exemplo:

  UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected

• UIPATH_HTTP_CONNECTION_LIFETIME - Define por quanto tempo a conexão com o Orchestrator permanece aberta antes de ser fechada e atualizada. A duração padrão é de 30 minutos, mas para ajustar esse valor, use o valor especificado em segundos.

  Exemplo:

  // to set 10 minutes                          
  UIPATH_HTTP_CONNECTION_LIFETIME = 600

• UIPATH_FILE_LOG_LEVEL - Define o nível de log de execução usado no arquivo local. Isso é diferente do nível de log usado para o Orchestrator. As seguintes opções estão disponíveis:
  • Verbose
  • Trace
  • Information
  • Aviso
  • Erro
  • Crítica
  • Desativado

  Exemplo:

  // to set verbose level locally
  UIPATH_FILE_LOG_LEVEL = Verbose

• UIPATH_EXECUTOR_STARTUP_DELAY - Define o tempo em segundos de espera entre a criação da sessão e a inicialização do Executor. Isso é usado quando sua infraestrutura precisa carregar alguns serviços (VPN, segurança) antes de iniciar a execução da sua automação.

  Exemplo:

  // to set the delay to 5 seconds
  UIPATH_EXECUTOR_STARTUP_DELAY = 5