Arquivos de configuração

Descrição do arquivo UiPath.Settings

O arquivo UiPath.Settings contém todos os detalhes necessários sobre como o Robô executa processos. Você pode modificar essas configurações editando diretamente o arquivo e os campos correspondentes. Por outro lado, você pode modificá-los por meio do Orchestrator. Isso é feito a partir da aba Configurações.

Observação: note que os direitos de administrador e do sistema local são necessários para modificar essas configurações. Você deve reiniciar o serviço de Robôs da UiPath^® (são necessários direitos de administrador para fazer isso) e fechar a bandeja do Robô para que as alterações entrem em vigor.

O arquivo UiPath.Settings é armazenado na pasta %localappdata%\UiPath\ quando o Robô é implantado no modo de usuário e %programdata%\UiPath\ quando o Robô é implantado no modo de serviço. Ele é criado na primeira vez em que o serviço UiPath^® Robot é iniciado. Contém os seguintes parâmetros:

Parâmetro	Description
NuGetApiKey	A chave de API do feed do NuGet. Quando não estiver conectado ao Orchestrator, se você estiver usando um feed local, ele não requer uma chave de API.Se você usar um feed do MyGet privado, observe que este parâmetro é necessário. Quando conectado ao Orchestrator, esse valor não é considerado.
NuGetServerUrl	O local em que os projetos são enviados e de onde são recuperados. Pode ser um feed local, como um caminho de sistema de arquivos, ou um feed da Web que usa o protocolo NuGet (NuGet, MyGet etc.). Quando não estiver conectado ao Orchestrator, o valor padrão é %ProgramData%\UiPath\packages (modo de usuário) ou `%. Se você usar um feed do MyGet privado, use a URL fornecida em Sua URL do V2 pré-autenticada (sem autenticação básica). Observe que este não é um serviço gratuito do MyGet. Quando conectado ao Orchestrator, esse valor não é considerado.
Feed de Atividades	O endereço em que as atividades são armazenadas. Este campo é preenchido apenas se você não estiver conectado ao Orchestrator. Por padrão, o valor é ~/NuGetPackages/Activities. Se você se conectar ao Orchestrator, este campo não é considerado. Saiba mais sobre os feeds de atividades nesta página, bem como onde os pacotes são instalados com base no tipo de implantação do Robô.
UiPathServerUrl	O endereço da sua instância do Orchestrator. Quando não estiver conectado ao Orchestrator, este parâmetro está vazio. Quando conectado ao Orchestrator, ele é preenchido automaticamente com a URL que você forneceu na janela Configurações do Orchestrator.
Nível de rastreamento	O nível no qual o Robô deve registrar informações. As seguintes opções estão disponíveis: Verboso, Rastreamento, Informação, Aviso, Erro, Crítico e Desligado. Isso também pode ser alterado a partir da janela de Configurações do Orchestrator, a partir da lista suspensa Nível.
Rastreamento de baixo nível	Indica se as informações devem ser registradas em um nível de rastreamento para ajudar você a solucionar falhas e erros. Por padrão, este parâmetro é definido como false. Para iniciar rastreamento de baixo nível, defina o valor deste parâmetro como true. Você também pode alterar este valor a partir da linha de comando.
SecureLicenseKey	A Chave de Máquina que é usada para se conectar ao Orchestrator.A chave é criptografada no arquivo da UiPath.settings usando DPAPI. Esse valor também pode ser preenchido e modificado a partir da janela de Configurações do Orchestrator. Se não estiver conectado ao Orchestrator, esse parâmetro deve estar vazio.
LogonNoConsole	Permite que o Robô se conecte à sessão de console da máquina em que está instalado. Além disso, indica se você pode conectar vários Robôs ao Orchestrator usando muitos usuários (Robôs de Alta Densidade) ou não. Por padrão, o valor é true. Para habilitar Robôs de Alta Densidade, defina o valor como false.
Largura da Resolução	A largura de resolução de exibição da máquina. Esta opção é definida como 0 por padrão, o que significa que ela recupera e usa automaticamente a largura de resolução detectada. Você pode usar um valor personalizado, desde que ele seja compatível com a estação de trabalho.
Altura da Resolução	A altura de resolução de exibição da máquina. Esta opção é definida como 0 por padrão, o que significa que ela recupera e usa automaticamente a altura de resolução detectada. Você pode usar um valor personalizado, desde que ele seja compatível com a estação de trabalho.
Intensidade da Resolução	A profundidade de resolução de exibição da máquina. Esta opção é definida como 0 por padrão, o que significa que ela recupera e usa automaticamente a profundidade de resolução detectada. Você pode usar um valor personalizado, desde que ele seja compatível com a estação de trabalho.
Fonte Suavizada	Aumenta o reconhecimento de texto. Se estiver definido como True, a opção de Suavização de Fonte em conexões RDP é ativada. Isso significa que a máquina de destino terá o ClearType habilitado.
ConnectionString	Uma string gerada a partir do Orchestrator que permite que você registre seu Robô sem fornecer o Nome da Máquina e a Chave da Máquina.
DisableWorkflowExecution	Desabilita a possibilidade de executar processos a partir da linha de comando quando habilitado. Por padrão, essa funcionalidade está oculta e desabilitada.
webProxySettings	Parâmetro usado para configurar as Configurações de Proxy para o Robô. Saiba mais no documento Redirecionando Robôs por meio de um Proxy.

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 criar 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 iniciar um processo em uma sessão de 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 da interface gráfica atual do thread
  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 é iniciado 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 o diálogo de 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 do 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 as pastas de pacotes 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 (domínio\nome de usuário).

  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

Reinicialização de componentes dos Robots

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 Usuário - Encerre, depois reinicie o 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. Selecione Recarregar Widgets