robot
latest
false
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Guia do admin do Robô

Última atualização 29 de mai de 2025

Solução de problemas de execução

Mensagem muito grande para processar

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

Os dados produzidos pela automação excedem o valor do parâmetro 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.

As automações unattended que usam atividades UIAutomation não funcionam

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.

O Robô falhou em Iniciar a Execução

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

As tabelas a seguir resumem vários problemas e suas soluções.

Problema potencial

Solução

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.

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

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

Senha Não Fornecida

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

A tabela a seguir resume os problemas em potencial e suas soluções:

Problema potencial

Solução

A conta do robô foi criada sem uma senha.

Edite a conta do robô no Orchestrator e forneça os seguintes valores:
  • 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.

O Serviço de Robôs da UiPath está inativo.

  1. Abra a janela Serviços.

  2. Selecione o serviço UiPathRobotSvc.
  3. Abra o painel de Propriedades para o serviço selecionado.

  4. Na guia Log On, selecione Conta do Sistema Local.

  5. Selecione Aplicar e OK para confirmar as alterações e, em seguida, feche a janela. Isso garante que o Serviço de Robô esteja em execução e tenha todos os privilégios de que precisa para executar automações.

A máquina do Robô não tem mais os privilégios de administrador.

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.

System.Collections.IEnumerable não pode ser serializado

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.

O trabalho parou com um código de saída inesperado.

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.

A automação funciona no modo Attended, mas não no modo Unattnded

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

Importante:

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.

Possível solução

Procedimento

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:

  1. Faça login na máquina como se estivesse executando uma automação Attended.
  2. Abra o PowerShell (use a caixa de diálogo Executar e digite "powershell").
  3. Execute este comando:
    (Get-ItemProperty 'HKCU:\Control Panel\Desktop\WindowMetrics' -Name AppliedDPI).AppliedDPI(Get-ItemProperty 'HKCU:\Control Panel\Desktop\WindowMetrics' -Name AppliedDPI).AppliedDPI
  4. 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.

Solução 2: captura de problemas em tempo real

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.

Solução 3: Suporte à UiPath

Se as etapas acima 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.

  1. Faça login na máquina como se estivesse executando uma automação Attended.
  2. Abra o PowerShell (use a caixa de diálogo Executar e digite "powershell").
  3. 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
  4. Anote os valores de Largura e Altura retornados, conforme você precisa deles na etapa 7b.
  5. 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.
  6. 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.
  7. 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).
    1. Defina a opção Login no console como Não.Isso instrui o Robô a usar sessões RDP para automações Unattended.
    2. Defina valores para Largura da resolução e Altura da resolução.Use os mesmos valores retornados na etapa 3.
    3. Defina 32 para Profundidade de resolução.
    4. Para automações baseadas em imagem, defina também Suavização de fontes como Sim.
  8. 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).

  1. Abra o Editor de registro e navegue até HKEY_CURRENT_USER\Control Panel\Desktop\LogPixels.
  2. Pesquise o valor de registro LogPixels. Se o valor não existir, crie-o como um valor 32-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)

  3. Em seguida, navegue para HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\.
  4. 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 valor 32-DWORD.Consulte a seguinte lista para possíveis valores decimais:
    1. 1 - ignora o dimensionamento na máquina do robô
    2. 0 - leva em consideração o escalonamento na máquina do robô

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