Arquivos de configuração

Once you edit configuration files, you need to restart the relevant Robot components for changes to take effect. The following list summarizes how to restart several components, based on the Robot installation mode.

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.
  • User Mode installation - Quit, then relaunch the Assistant, or:
    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 - Restart the Assistant, or:
  1. Clique com o botão direito do mouse no ícone do UiPath Assistant na barra de tarefas.
  2. Select Reload 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:

• In the connectionSettings config section
  • DefaultServiceUrl (string) - Sets the default address the Robot uses to connect to Orchestrator. Example:

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

  • AutoSignIn (bool) - Enables the auto sign-in feature for Assistant. Default value is false. Example:

    bool AutoSignIn = true.

  • EnforceDefaultServiceUrl (bool) - Enforces the address provided as DefaultServiceUrl to all users. Default value is false. Example:

    bool EnforceDefaultServiceUrl = true.

• In the communicationSettings config section
  • MaxMessageSizeInMegabytes (byte) - Sets the maximum size of a message the system can send or receive, in MB. Default value is 10.

    This is used to prevent overload or process crashes due to handling messages too large. Example:

    byte MaxMessageSizeInMegabytes = 10;

  • InstallPackageTimeout (TimeSpan) - Sets the time limit for package installations. Default value is 20 minutes.

    If a package installation takes longer than the defined time, the system aborts the installation. Example:

    TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);

  • RequestTimeout (TimeSpan) - Defines how long the system waits for a communication response. Default value is 40 seconds.

    If the system does not receive a response in the set period, it stops and moves forward. This prevents system hang-ups. Example:

    TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);

• In the packageSettings config section
  • PackagesInstallationFolder (string) - Sets the default directory where packages are installed. Default value is C:\UiPath\Packages.
  • SkipHttpConfigurationSources (bool) - Enables the system to ignore package sources configured over HTTP, such as NuGet feeds. Default value is 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) - Allows the Robot to run potentially unsafe workflows. Default value is false.
  • DirectDownload (bool) - Allows direct download of packages, without prompting the user. Default value is false.
  • PackageSaveWithoutNupkg (bool) - Allows saving the packages without the .nupkg file. Default value is false.

    Isso é útil para reduzir o tamanho do download.

• In the analyticsSettings config section
  • Telemetry.Enabled (bool) - Allows UiPath to collect and send usage data for analysis. Default value is false.
• In the robotCacheSettings config section
  • SessionCacheDuration (TimeSpan) - Defines how long the data from a specific session should be retained in the cache before being discarded. Default value is 30 seconds.

    This is useful for reusing data such as variable values or details of operations, instead of recreating or refetching it. Example:

    TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);

  • GetResourceUrlCacheDuration (TimeSpan) - Defines how long the URLs for resources, such as APIs or webpages, are stored in cache. Default value is one (1) hour.

    This is useful for optimizing performance in scenarios where your robots need to access certain resources regularly. Example:

    TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);

• In the robotJsSettings config section
  • ListenerPort (int) - Sets the port number on which the Robot.js listens for incoming connections. Default value is 2323.

    This allows the robot service to interact with web applications running on local or remote servers. Example:

    int ListenerPort = 2323;

  • TokenExpiryInDays (int) - Sets the validity period, in days, of authentication tokens generated by the robot service. Default value is 30 days.

    The robot service uses these tokens to authenticate itself when interacting with other software components or services. Example:

    int TokenExpiryInDays = 30;

  • AllowUrlList (string) - Sets the list of URLS that the robot service can access. This helps ensure your robot service only interacts with approved services. Example:

    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 - Changes the default 60-second timeout for creating an interactive session. Adjust this value to adapt the Robot behavior based on the performance and load times of the system it interacts with.

  Exemplo:

  UIPATH_SESSION_TIMEOUT=75

• UIPATH_PIP_SESSION_TIMEOUT - Changes the default 180-second timeout for starting a process in a Robot session.

  Exemplo:

  UIPATH_PIP_SESSION_TIMEOUT=60

• UIPATH_LANGUAGE - Sets the language the Robot operates in. The order of precedence is:
  1. Valor UIPATH_LANGUAGE
  2. Machine environment variable
  3. Current thread UI culture
  4. Idioma padrão do UiPath (inglês)

  Exemplo:

  UIPATH_LANGUAGE=French

• UIPATH_HEADLESS_WITH_USER - Uses the credentials of a specific user, which was previously configured in Orchestrator.

  Exemplo:

  UIPATH_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.

  Exemplo:

  UIPATH_PRE_LOADED_EXECUTOR=None

• UIPATH_DISABLE_PRE_LOADED_EXECUTOR - Disables the preloaded executor feature.

  Exemplo:

  UIPATH_PRE_LOADED_EXECUTOR=None

• UIPATH_ROBOTJS_ALLOWLIST - Automatically accepts the robot consent dialog, when establishing the connection between the Robot JS SDK and the Robot Executor.

  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 - Allows using the DNS host name for Localhost when creating RDP sessions. To execute unattended jobs in environments with Kerberos authentication for RDP, set this value to True.

  Exemplo:

  UIPATH_DNS_MACHINENAME=True

• NUGET_FALLBACK_PACKAGES - Configures the paths to fallback packages folders. Use semicolons to separate multiple paths.
  Na ausência dessa variável, o Robô pesquisa por pastas de 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 da pasta de instalação do Nuget e atua como uma pasta temporária para o NuGet.

  Note: Only the NUGET_SCRATCH variable should use the configured temporary folder.

  Exemplo:

  NUGET_SCRATCH=C:\NuGetTempFolder

• UIPATH_PRESERVE_CREDENTIALS_CASE - Preserves the original casing of logging credentials (domain\username).

  Exemplo:

  UIPATH_PRESERVE_CREDENTIALS_CASE = True

• UIPATH_SESSION_BEHAVIOR - Configures the way the session restore behaves after a job completes. The following options are available:
  • 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