- Introdução
- Compreensão do UiPath Robot
- Requisitos de instalação
- Instalação de Robôs para automações unattended
- Configuração de Robôs para automações unattended
- Implantação de automações unattended
- Conexão de Robôs para automações unattended ao Orchestrator
- Configurar o Windows Server para robôs de alta densidade
- Redirecionando Robôs por meio de um Servidor de Proxy
- Implementando autenticação com provedores de credenciais
- Configurando a Verificação de Assinatura de Pacote
- Configuração de pastas de pacote e caminhos de rede
- Configuração de feeds de atividades
- Uso de usuários EntraID com autenticação multifator (MFA) para robôs não assistidos
- Instalação de Robôs para automações attended
- Configuração de Robôs para automações attended
- Integrações
- Governança
- Solução de problemas
- Solução de problemas do Serviço de Robôs da UiPath
- Solução de problemas de execução
- Solução de problemas de gravação e controle remoto
- Solução de problemas de rede
- Solução de problemas de conexão
- Solução de problemas de licenciamento
- Solução de problemas de pacotes
- Solução de problemas do .NET
- Solução de problemas de registro em log
- Solução de problemas de sessão

Guia do admin do Robô
Description
As automações que processam grandes volumes de dados podem falhar devido ao seguinte erro: "Mensagem: não foi possível recuperar o resultado da execução da tarefa. Isso pode ser porque uma mensagem era muito grande para ser processada. Tipo de exceção: System.Exception".
Problema potencial
maxMessageSizeInMegabytes no arquivo uipath.config.
Solução
Configure a automação para salvar a saída em um bucket de armazenamento no Orchestrator ou no Data Service, em vez de usar um argumento de saída.
Description
As automações unattended que usam atividades UIAutomation não funcionam.
Problema potencial
Quando um programa como o Gerenciador do servidor, definido para iniciar automaticamente, mostra uma solicitação de Controle de Conta de Usuário do Windows (UAC), ele impede que o robô interaja com a interface do usuário.
Solução
Identifique o programa que aciona a solicitação de Controle de Conta de Usuário (UAC) e configure-o para que não seja iniciado automaticamente.
Description
O Robô falha ao iniciar a execução de uma automação e exibe a seguinte mensagem de erro: "O processo de início do executor falhou, motivo System.Runtime.InteropServices.COMException: uma sessão de logon especificada não existe. Ela pode já ter sido encerrada."
Problema potencial: a máquina do Robô não tem recursos suficientes
A máquina do robô não tem recursos suficientes (como CPU, RAM ou Espaço em Disco), logo, o Executor do Robô não pode iniciar a automação.
Solução:
- Certifique-se de que a máquina do robô tenha recursos suficientes (como CPU, RAM ou Espaço em Disco).
- Verifique o tempo de conexão usando a função de linha de comando
mstsc. Ele precisa ser maior do que 60 segundos, caso contrário, o erro é exibido.
Problema potencial: a sessão de login não pode ser criada no momento
A sessão de login não pode ser criada no momento. Isso pode acontecer nas seguintes situações:
- A propriedade Logon no Console é definida como True para robôs de Alta Densidade (HD). Nesse caso, o Serviço de Robôs da UiPath anexa-se à sessão de console atual. Isso não é recomendado para Robôs de Alta Densidade (HD), porque pode haver apenas uma sessão de console ativa por vez.
- Várias sessões de RDP em versões do Windows para desktop (não servidores). As versões do Windows para desktop podem suportar apenas uma sessão de RDP por vez por máquina, enquanto as versões do Windows Server podem suportar várias sessões de RDP.
Nesse caso, você precisa realizar uma das seguintes ações:
- Defina Login no Console como False. Isso significa que o Serviço de Robôs da UiPath iniciará uma conexão RDP a partir da máquina do Robô para si mesma e conecta-se a ela. Esse é o método recomendado para os Robôs HD.
- Verifique a versão do Windows, ela precisa ser o Windows Server.
- Verifique se as versões do Studio e Robô são superiores à 2018.1.3.
- Aumente o valor da variável de ambiente do
UIPATH_SESSION_TIMEOUTsistema em seu servidor. O valor padrão é de 60 segundos, que pode ser insuficiente devido ao lento desempenho em algumas máquinas.Reinicie o Serviço de Robôs da UiPath depois de modificar essa variável. - Verifique se sua Licença de Área de Trabalho Remota está ativa no servidor.
- Verifique se os Robôs estão nos grupos apropriados. Os usuários locais precisam estar no mesmo grupo de Área de Trabalho Remota.
- Verifique se o nome de usuário de sua conexão RDP com a máquina do Robô é o mesmo que o configurado. Para evitar esse erro, desligue todas as conexões RDP na máquina do Robô.
Description
O início de uma automação do Orchestrator ou UiPath Assistant exibe a seguinte mensagem de erro: "O processo de início do executor falhou, motivo System.UnauthorizedAccessException: o acesso é negado".
Problema potencial: a conta do Robô foi criada sem uma senha
Solução:
- Domínio\Nome de usuário* – O nome de usuário utilizado para se conectar à máquina onde o Robô está instalado. Se o usuário estiver sob um domínio, você será solicitado a também especificá-lo em um formato
DOMAIN\UserName. - Senha – A senha de login do Windows.
Problema potencial: o Serviço de Robôs da UiPath está inativo
Solução:
- Abra a janela Serviços.
- Selecione o serviço
UiPathRobotSvc. - Abra o painel de Propriedades para o serviço selecionado.
- Na guia Log On, selecione Conta do Sistema Local.
- Selecione Aplicar e OK para confirmar as alterações e, em seguida, feche a janela. Isso garante que o Serviço de Robôs da UiPath esteja em execução e tem todos os privilégios que ele precisa para executar automações
Problema potencial: a máquina do Robô não tem mais privilégios de administrador
Solução:
Faça login na máquina do Robô com o mesmo conjunto de credenciais com as quais você criou o Robô no Orchestrator.Se um processo falhar ao iniciar no UiPath Assistant, você precisa entrar em contato com seu administrador de rede para permitir direitos de administrador para essa conta de usuário.
Description
Ao usar uma Tabela de Dados em uma atividade Wait For Task and Resume, ela retorna o seguinte erro: "Exceção: o tipo 'System.Collections.IEnumerable' não pode ser serializado".
Problema potencial
O objeto LinhaDeDados da Tabela de dados não pode ser serializado, por isso não pode ser mantido, causando possíveis problemas ou erros.
Solução
Execute a atividade Create Form Task e crie a saída percorrendo as linhas de dados, para criar uma lista de objetos de tarefa. Em seguida, percorra a lista de saída de objetos de tarefa usando as atividades Parallel For Each ou For Each. Nesses loops, execute a atividade Wait for Task and Resume para cada objeto de tarefa.
Description
Sua execução do trabalho falha e a seguinte mensagem de erro é registrada no Orchestrator: "O trabalho parou com um código de saída inesperado: 0x40010004".
Problema potencial
Geralmente, esse erro ocorre quando:
-
A conta de usuário, usada pelo Robô, é desconectada de forma forçada durante a execução do processo.
-
A máquina na qual o Robô está sendo executado é desligada ou reiniciada manualmente durante a execução do processo.
Solução
Para evitar esse erro, certifique-se de que o Robô esteja instalado corretamente para o tipo de automação pretendido: attended ou unattended. O Robô instalado no Modo de usuário não pode executar automações unattended.
Além disso, configure a sessão do Robô para atender ao seu ambiente e necessidades de negócios.
Description
A mesma automação funciona conforme o esperado no modo Attended, com um usuário humano conectado e observando, mas no modo Unattended, ela falha.Outros problemas potenciais no modo Unattended incluem:
- O Robô clica em locais incorretos.
- Janelas aleatórias abrem inesperadamente.
- Os itens da barra de tarefas são ativados sem a entrada do usuário.
- O aplicativo de destino entra em um estado inesperado.
Problema potencial
Para automações Unattended, o Serviço de Robôs da UiPath inicializa a sessão do Windows por meio de uma conexão RDP e depende das configurações do sistema para a resolução da exibição e escalonamento ou das configurações do Robô. Portanto, a resolução e o escalonamento entre a sessão remota e a sessão local são diferentes.
Soluções
Antes de testar, certifique-se de que o usuário do Robô esteja desconectado da máquina do Robô. Dessa forma, o Robô opera em um ambiente limpo.
As diferenças de resolução são muitas vezes a distinção principal entre os modos Attended e Unattended.Consulte Corrigir problemas de resolução e Melhores práticas de resolução.
Solução 1: marcar as configurações de dimensionamento
- As configurações de dimensionamento podem afetar o modo como o Robô interage com a interface do usuário.
-
Se as correções de resolução não ajudarem com o problema, verifique as configurações de dimensionamento de sessão do Windows:
- Faça login na máquina como se estivesse executando uma automação Attended.
- Abra o PowerShell (use a caixa de diálogo Executar e digite "powershell").
- Executar este comando: Comando: Comando: . Comando. Comando.
(Get-ItemProperty 'HKCU:\Control Panel\Desktop\WindowMetrics' -Name AppliedDPI).AppliedDPI(Get-ItemProperty 'HKCU:\Control Panel\Desktop\WindowMetrics' -Name AppliedDPI).AppliedDPI - O valor retornado deve ser 96. Caso contrário, o Robô pode ter sido desenvolvido com escalonamento não padrão. Consulte Forçar o dimensionamento.
- Se a Solução 1 não ajudar, use as funcionalidades de Transmissão ao vivo e controle remoto para capturar o problema à medida que ele ocorrer. Essas ferramentas permitem que você observe o comportamento do Robô sem fazer o registro diretamente na máquina, ajudando a identificar problemas que podem não ser aparentes de outra forma.
- Se as etapas anteriores não ajudarem a identificar o problema, abra um chamado de suporte com a UiPath.
Melhores práticas de resolução
- Revise as diretrizes para Automações de IU.
- Torne a resolução um requisito de design importante
- Certifique-se de que a resolução e o escalonamento de seus ambientes de desenvolvimento e produção sejam idênticos.
- Esteja ciente de que, se você não especificar uma resolução, os padrões do sistema se aplicam.Isso pode levar a baixas resoluções que o aplicativo não suporta.Elementos de interface do usuário podem estar fora da tela ou visualmente distorcidos.
- Não negligencie as atividades dependentes da resolução:
- Atividades baseadas em imagem, como Localizar Imagem ou atividades de OCR.
- Atividades de Automação de interface gráfica com regiões de recorte habilitadas.
- Atividades de Automação de interface gráfica com a opção AguardarAtéEstarVisível habilitada.
- Clique em atividades que não usam os métodos de entrada Mensagens de Janela ou Simular. Para a propriedade PosiçãoDoCursor, consulte Robô clicando no local errado.
Robô clicando no local errado
Cliques incorretos do robô normalmente indicam que a opção PosiçãoDoCursor está habilitada na atividade Click.
A propriedade PosiçãoDoCursor às vezes é configurada sem intenção ao usar a funcionalidade Gravação no Studio. Identifique a atividade em que o clique ocorre no local errado, determine se a opção está habilitada intencionalmente. Na maioria dos casos, essa propriedade é desnecessária.
Corrigindo problemas de resolução.
- Faça login na máquina como se estivesse executando uma automação Attended.
- Abra o PowerShell (use a caixa de diálogo Executar e digite "powershell").
- Execute este comando:
[void][Reflection.Assembly]::LoadWithPartialName("System.Windows.Forms") [System.Windows.Forms.SystemInformation]::PrimaryMonitorSize[void][Reflection.Assembly]::LoadWithPartialName("System.Windows.Forms") [System.Windows.Forms.SystemInformation]::PrimaryMonitorSize - Anote os valores de Largura e Altura retornados, conforme você precisa deles na etapa 7b.
- Marcar a suavização de fontes:
- Abra Visualização de configurações avançadas do sistema no menu Iniciar.
- Na aba Avançado, selecione Configurações em Desempenho.
- Marcar se as bordas suaves das fontes de tela estão habilitadas.
- Se você precisar de profundidade de bits ou suavização de fontes, marque as configurações de exibição na máquina local que se conecta à máquina do Robô:
- Navegue até Configurações de exibição.
- Acesse Configurações avançadas de exibição para obter informações sobre a profundidade de bits.
- Acesse a seção Configurações do robô para a conta de robô que executa a automação (Orchestrator > Tenant > Gerenciar acesso > Regras de acesso > Contas de robôs).
- Defina a opção Login no console como Não.Isso instrui o Robô a usar sessões RDP para automações Unattended.
- Defina valores para Largura da resolução e Altura da resolução.Use os mesmos valores retornados na etapa 3.
- Defina 32 para Profundidade de resolução.
- Para automações baseadas em imagem, defina também Suavização de fontes como Sim.
- Selecione Atualizar.
Forçar o dimensionamento
De forma ideal, redesenhe a automação em um ambiente de desenvolvimento com o dimensionamento definido como 100%.As etapas a seguir destinam-se a ser uma solução temporária. Certifique-se de que o Robô seja executado em uma sessão RDP (a opção Login no Console é definida como Não).
- Abra o Editor de registro e navegue até
HKEY_CURRENT_USER\Control Panel\Desktop\LogPixels. - Pesquise o valor de registro
LogPixels. Se o valor não existir, crie-o como um valor32-DWORD.Consulte a seguinte lista para possíveis valores decimais:DPI (resolução)
Fator de escala, % (o valor de LogPixels)
96
100 (sem escala)
120
125 (tudo na tela é 25% maior)
144
150 (tudo na tela é 50% maior)
192
200 (tudo na tela é duas vezes maior)
- Em seguida, navegue para
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\. - Pesquise o valor de registro
IgnoreClientDesktopScaleFactor. Essa chave de registro informa à conexão remota se ignorar o dimensionamento na máquina do robô.Se o valor não existir, crie-o como um valor32-DWORD.Consulte a seguinte lista para possíveis valores decimais:- 1 - ignora o dimensionamento na máquina do robô
- 0 - leva em consideração o escalonamento na máquina do robô
- Mensagem muito grande para processar
- Description
- Problema potencial
- Solução
- As automações unattended que usam atividades UIAutomation não funcionam
- Description
- Problema potencial
- Solução
- O Robô falhou em Iniciar a Execução
- Description
- Problema potencial: a máquina do Robô não tem recursos suficientes
- Problema potencial: a sessão de login não pode ser criada no momento
- Senha Não Fornecida
- Description
- Problema potencial: a conta do Robô foi criada sem uma senha
- Problema potencial: o Serviço de Robôs da UiPath está inativo
- Problema potencial: a máquina do Robô não tem mais privilégios de administrador
- System.Collections.IEnumerable não pode ser serializado
- Description
- Problema potencial
- Solução
- O trabalho parou com um código de saída inesperado.
- Description
- Problema potencial
- Solução
- A automação funciona no modo Attended, mas não no modo Unattnded
- Description
- Problema potencial
- Soluções
- Melhores práticas de resolução
- Robô clicando no local errado
- Corrigindo problemas de resolução.
- Forçar o dimensionamento