- Notas de Versão
- Introdução
- UiPath Assistant
- Instalação e atualização
- Tipos de Robô
- Componentes do Robô
- Licenciamento
- Conectar Robôs ao Orchestrator
- Processos e Atividades
- Geração de logs
- Robot JavaScript SDK
- Cenários Específicos
- Sessões do Windows
- Login usando o Sistema de Credenciais Thales Luna
- Login usando o Provedor de Armazenamento de Chaves nShield
- Redirecionando Robôs por meio de um Servidor de Proxy
- Executando tarefas em uma Janela RDP Minimizada
- Usando Unidades de Rede Mapeadas
- Interrompendo um Processo
- Desabilitar o Botão Parar
- Pastas de Pacote Personalizados e Caminhos de Rede
- Solução de problemas
Nesta seção, você pode encontrar mais detalhes sobre os erros mais frequentes dos Robots e como resolvê-los.
Dependências do Projeto para Instalações EXE
Comportamento Observado
O Robô é incapaz de baixar ou executar processos criados no Studio v2019.2 ou anterior, que tenha dependências dos feeds Oficial ou Go! e que não são encontrados localmente ou no Orchestrator.
Causa
Quando o Studio é implantado por meio do instalador UiPathStudioSetup.exe (geralmente a configuração da Community Edition), o Robô é instalado no Modo de Usuário. Assim, o Robô pode apenas baixar e instalar dependências do projeto, caso eles sejam encontrados localmente ou na instância do Orchestrator em que ele estiver conectado.
Solução A
Todas as dependências do projeto precisam ser baixadas manualmente do feed Oficial e carregadas para a instância do Orchestrator à qual está conectada.
Solução B
Habilite o feed Oficial do Studio e reinicie o Serviço do Robô (UiPath.Service.UserHost). Abra o agente do Robô (bandeja) e inicie o processo a partir dele. As dependências correspondentes agora serão baixadas corretamente.
O Robô falhou em Iniciar a Execução
Comportamento Observado
Neste cenário, o Robô falha ao iniciar a execução de um processo, gerando o seguinte erro:
Executor start process failed, reason System.Runtime.InteropServices.COMException: A specified logon session does not exist. It may already have been terminated.
Causa A
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 um processo.
Solução A
Verifique ou execute o seguinte:
- A máquina do Robô tem recursos suficientes (como CPU, RAM ou Espaço em Disco).
- 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.
Causa B
A sessão de login não pode ser criada no momento. Isso pode acontecer nas seguintes situações:
- Login no Console está definido como verdadeiro para os Robôs HD. Neste caso, o Serviço de Robôs da UiPath se conecta à Sessão de Console atual. Isso não é recomendado para os Robôs HD, porque só pode haver uma Sessão de Console ativa por vez.
- Várias sessões RDP em versões Independentes do Windows (não Servidores). As versões independentes do Windows podem lidar apenas com uma sessão RDP por vez em uma máquina, enquanto as versões do Windows Server podem lidar com várias sessões RDP.
Solução B
Nesse caso, você precisa realizar uma das seguintes ações:
- Defina Login no Console como falso. 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.
- Check the Windows version, it needs to be Windows Server. Read more about Setting up Windows Server for HD Robots.
- Check if the Studio/Robot version you are using is greater than 2018.1.3, which fixed an issue caused by the KB4088876 (Windows 8.1 or Windows Server 2012 R2 Standard), KB4088875 (Windows Server 2008 R2 SP1, Windows 7 SP1), KB4088787 (Windows Server 2016, Windows 10 Version 1607), and KB4088776 (Windows 10 version 1709) Windows updates. Read more about Software Requirements.
- Aumente a variável de ambiente
UiPath_Session_Timeoutna máquina do Robô. O valor padrão é de 60 segundos, que pode ser insuficiente devido ao lento desempenho em algumas máquinas. Observe que a variável de ambiente é definida em Segundos e o Serviço de Robôs da UiPath precisa ser reiniciado após a modificação desta variável. - Check if your Remote Desktop License is active on the Robot machine. You can find out more on this page).
- Verifique se os Robôs estão nos grupos corretos. Os usuários locais precisam estar no mesmo grupo de Área de Trabalho Remota.
- Verifique se o nome de usuário da sua conexão RDP com a máquina do Robô não é diferente da configurada. Para evitar esse erro, desligue todas as conexões RDP na máquina do Robô.
Senha Não Fornecida
Comportamento Observado
Criar um robô no Orchestrator, sem preencher o campo de senha, torna-o incapaz de iniciar a execução do processo. As alterações feitas em privilégios na máquina do Robô também podem desencadear esse problema.
Iniciar um processo a partir do Orchestrator ou do Agente do Robô (bandeja) exibe a seguinte mensagem de erro:
Executor start process failed, reason System.UnauthorizedAccessException: Access is denied.
Causa A
O Robô foi criado sem uma senha.
Solução A
Edite o Robô conforme explicado aqui e certifique-se de que os seguintes campos estejam devidamente preenchidos:
- Domínio\Nome do Usuário - O nome de usuário usado para conectar à máquina na qual 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. Use o comandoWhoamino Prompt de Comando para encontrá-lo facilmente. - Senha - A senha da máquina do Windows. Não é necessário para os Robôs Assistidos.
Causa B
The SCM-managed Robot Service is not running. Find out more about Robot deployment types.
Solução B
Certifique-se de que o Serviço de Robôs da UiPath esteja executando:
- Clique no botão Iniciar do Windows, depois pesquise por
Services.msce abra-o. A janela Serviços é exibida. - Encontre o serviço do UiPath Robot e dê um duplo clique nele. O painel de Propriedades do UiPath Robot é exibido.
- Na aba Logon, selecione a opção de conta do Sistema Local.
- Clique no botão Aplicar e feche a janela para confirmar as alterações. 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 os processos.
Causa C
A máquina do Robô não tem mais os privilégios de administrador.
Solução C
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 a partir do agente do Robô (Bandeja), você precisará entrar em contato com o seu administrador de rede para conceder direitos de administrador para essa conta de usuário.
Sem Conexão com o Serviço de Robôs da UiPath
Comportamento Observado
Em algumas situações, você não poderá iniciar a execução do processo. Isso pode acontecer independentemente de o Serviço de Robôs da UiPath estar ou não em execução.
Iniciar um processo a partir do Orchestrator ou do Agente do Robô (bandeja) exibe a seguinte mensagem de erro:
Get settings from service failed, reason System.Exception: Could not connect to UiPath Robot Service.
Causa A
O Serviço de Robôs da UiPath não está em execução.
Solução A
Neste caso, você precisará iniciar manualmente o Serviço de Robôs da UiPath, da seguinte maneira:
- Clique no botão Iniciar do Windows, depois pesquise por
Services.msce abra-o. A janela Serviços é exibida. - Encontre o serviço do UiPath Robot e clique com o botão direito do mouse nele. O menu de contexto é exibido.
- Clique em Iniciar para ativar o Serviço de Robôs da UiPath. Isso faz com que o Serviço de Robôs da UiPath inicie no login do Windows.
Se essas etapas precisarem ser repetidas toda vez que a máquina do Robô inicia, você precisa aumentar o valor do tempo limite de serviços no Windows, conforme explicado a seguir.
Causa B
O Serviço de Robôs da UiPath demora muito para iniciar.
Solução B
O Windows reporta serviços que não carregam em um tempo especificado. Por padrão, esse valor de tempo limite é de 30 segundos, o que pode ser insuficiente para o Serviço de Robôs da UiPath. Para aumentar esse valor, você precisa:
-
Abrir o Editor de Registro do Windows.
-
Navegue até a
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Controlchave de registro, e selecione a subchave
Control. -
Se o valor
ServicesPipeTimeoutNÃO estiver disponível, então crie-o da seguinte maneira:3.1. Clique com o botão direito na subchave
Controle selecione o valor DWORD (32 bits) no menu Novo. Um novo valor de DWORD em branco é criado.3.2. Digite ServicesPipeTimeout como o nome do novo valor.
-
Dê um duplo clique no Valor DWORD
ServicesPipeTimeout. A janela Editar Valor DWORD (32 bits) é exibida. -
Na seção Base, selecione a opção Decimal.
-
No campo Dados do valor:, digite 180000. Isso ajusta o padrão
ServicesPipeTimeout3 minutos. Ele deve ser suficiente para que todos os serviços do Windows sejam carregados corretamente. -
Feche o Editor de Registro do Windows e reinicie o computador para que as alterações entrem em vigor.
Causa C
A máquina do Robô tem permissões incorretas. Neste caso, o Serviço de Robôs da UiPath também pode aparecer como em execução.
Solução C
As permissões para os serviços são concedidas a partir do Editor de Registro do Windows, da seguinte maneira:
-
Abrir o Editor de Registro do Windows.
-
Navegue até a
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSetchave de registro. -
Clique com o botão direito na subchave
Controle clique em Permissões. A janela Permissões para Controle é exibida. -
Selecione o usuário no qual você está conectado, na seção Grupo ou nomes de usuários.
-
Habilite a opção Permitir para Controle Completo na seção Permissões. Isso concede as permissões necessárias para o Robô.
-
Clique em Aplicar e em OK para confirmar as alterações e fechar a janela.
-
Reinicie o computador para que as alterações entrem em vigor.
Caso você não possa fazer as alterações acima, entre em contato com o administrador da rede.
O Robô falha ao Baixar o Pacote
Comportamento Observado
O Robô falha ao baixar uma nova versão do pacote, caso a pasta %UserProfile%\.nuget\Packages já tenha uma versão de pacote com o arquivo .nupkg do projeto correspondente nele e um sem ele.
Causa
Esse problema ocorre em um cenário específico:
-
Ter Studio/Robot v2019.4 ou posterior instalado. Baixar e executar um pacote a partir do Orchestrator. O pacote é instalado na pasta
%UserProfile%\.nuget\Packagese contém o arquivo.nupkgcorrespondente. -
Desinstale a versão atual do Studio/Robot.
-
Instale uma versão do Studio/Robot anterior à 2019.4. Baixe e execute o pacote anterior a partir do Orchestrator. O pacote anterior não é removido e o novo não contém o arquivo
.nupkgcorrespondente. -
Atualize Studio/Robot para v2019.4 ou posterior. Fazer o download do pacote novamente falha com o seguinte erro:
O Robô falha ao baixar o pacote devido ao arquivo .nupkg ausente correspondente ao projeto.
Solução
Exclua os pacotes instalados anteriormente da pasta %UserProfile%\.nuget\Packages e baixe-os novamente.
A Sessão não é Desconectada
Após um fluxo de trabalho iniciado pela atividade Launch Workflow Interactive ser executado, a sessão não é desconectada. Isso ocorre se o robô estiver sendo executado em um ambiente de VDI, e as opções LoginToConsole e KeepSessionConnected estiverem habilitadas. Observe que, a partir do v2018.2, a atividade Launch Workflow Interactive tornou-se obsoleta.
"System.Collections.IEnumerable" não pode ser serializado
Comportamento Observado
Ao usar uma Tabela de Dados em "Wait For Task and Resume", retorna o seguinte erro: "Exception: Type 'System.Collections.IEnumerable' cannot be serialized."
Causa
DataRow não é serializável, portanto, ele não é capaz de serializar DataRows, enquanto persistir o fluxo de trabalho. Isso também pode ser visto se criarmos uma variável do DataRow e tentar esperar (persistir) após isso.
Solução
Execute a atividade "Create Form Task" e crie uma lista de objetos de tarefa (saída), enquanto faz loops através do DataRows(System.Data.DataRow).
Após isso, podemos fazer o loop por meio da lista de objetos de tarefa (saída), usando "Parallel For Each" ou "For Each", e executar "Wait For Task and Resume".
- Dependências do Projeto para Instalações EXE
- Comportamento Observado
- Causa
- Solução A
- Solução B
- O Robô falhou em Iniciar a Execução
- Comportamento Observado
- Causa A
- Solução A
- Causa B
- Solução B
- Senha Não Fornecida
- Comportamento Observado
- Causa A
- Solução A
- Causa B
- Solução B
- Causa C
- Solução C
- Sem Conexão com o Serviço de Robôs da UiPath
- Comportamento Observado
- Causa A
- Solução A
- Causa B
- Solução B
- Causa C
- Solução C
- O Robô falha ao Baixar o Pacote
- Comportamento Observado
- Causa
- Solução
- A Sessão não é Desconectada
- "System.Collections.IEnumerable" não pode ser serializado
- Comportamento Observado
- Causa
- Solução