- 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
- Reinicialização de componentes dos Robots
- 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
- Integração do CrowdStrike
- Virtualização de aplicativos Robot Citrix
- Solução de problemas
- Robô sem resposta sobre RDP
- Logs de Execução Duplicados
- Erros de Robô Frequentemente Encontrados
- Aumento da Duração da Execução do Processo
- Verificação Forçada de Assinatura do Pacote
- Mensagem muito grande para processar
- Erros ao Executar como Administrador
- Pacotes do NuGet não acessíveis após a migração
- Prompt de Controle de Acesso do Usuário e de Automação de Atividades da Interface Gráfica
- .NET necessário durante a instalação
- Montagem não pode ser carregada da rede ou do Azure File Share
- As atividades não podem encontrar o .NET Runtime
Guia do usuário do robô
Erros de Robô Frequentemente Encontrados
Nesta seção, você pode encontrar mais detalhes sobre os erros mais frequentes dos Robots e como resolvê-los.
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
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
UiPath.Service.UserHost
). Abra o UiPath® Assistant e inicie o processo a partir daí. As dependências correspondentes agora serão baixadas corretamente.
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.
- Cheque a versão do Windows, ela precisa ser o Windows Server. Leia mais sobre Configurando o Windows Server para Robôs HD.
- Verifique se a versão do Studio/Robot que você está usando é posterior à 2018.1.3, que corrigiu um problema causado pelas atualizações do Windows KB408876 (Windows 8.1 ou Windows Server 2012 R2 Standard), KB408875 (Windows 2008 R2 SP1, Windows 7 SP1), KB408787 (Windows (Windows 10 Versão 1607), e KB408776 (Windows 10 versão 1709). Leia mais sobre Requisitos de Software.
- Incremente a variável de ambiente do sistema
UIPATH_SESSION_TIMEOUT
no seu servidor. 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. - Verifique se sua Licença de Área de Trabalho Remota está ativa no servidor. Você pode encontrar mais nesta página.
- 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ô.
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 UiPath Assistant exibe a seguinte mensagem de erro:
Executor start process failed, reason System.UnauthorizedAccessException: Access is denied.
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 comandoWhoami
no Prompt de Comando para encontrá-lo facilmente. - Senha - A senha da máquina do Windows. Não é necessário para os Robôs Assistidos.
O Serviço de Robôs da UiPath gerenciado por SCM não está em execução. Saiba mais sobre os tipos de implantação do Robô.
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.msc
e 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.
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 UiPath Assistant, você precisará entrar em contato com o administrador da rede para permitir direitos de administrador para essa conta de usuário.
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.
O início de um processo a partir do Orchestrator ou do UiPath® Assistant 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.msc
e 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 chave de registro
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control
e selecione a subchaveControl
. - Se o valor
ServicesPipeTimeout
NÃO estiver disponível, então crie-o da seguinte maneira:- Clique com o botão direito na subchave
Control
e selecione o valor DWORD (32 bits) no menu Novo . Um novo valor de DWORD em branco será criado. - Digite ServicesPipeTimeout como o nome do novo valor.
- Clique com o botão direito na subchave
- 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
ServicesPipeTimeout
3 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 chave de registro
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet
. - Clique com o botão direito na subchave
Control
e 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.
Comportamento Observado
%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\Packages
e contém o arquivo.nupkg
correspondente. - 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
.nupkg
correspondente. - Atualize Studio/Robot para v2019.4 ou posterior. Fazer o download do pacote novamente falha com o seguinte erro:
.nupkg
ausente correspondente ao projeto.
Solução
%UserProfile%\.nuget\Packages
e baixe-os novamente.
Após um fluxo de trabalho iniciado pela atividade Launch Workflow Interactive ser executado, a sessão não é desconectada. Isso ocorre se o Robot 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.
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
- O Robô falhou em Iniciar a Execução
- 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
- O Robô falha ao Baixar o Pacote
- A Sessão não é Desconectada
- "System.Collections.IEnumerable" não pode ser serializado