- 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ô
Sessões do Windows
O UiPath Robot executa processos em uma sessão interativa do Windows. Há dois tipos de sessões do Windows que o Robô pode iniciar:
- Sessão de Console
- Sessão FreeRDP
O tipo de sessão que o Robô inicia é determinado pela opção LoginToConsole. Por padrão, essa opção está habilitada.
Todos os tipos de Robô, independentemente da licença ou da implantação, podem se conectar a ambos os tipos de sessão. Observe que Robôs de Alta Densidade se conectam apenas a uma sessão FreeRDP.
UiPath.settings
.
Uma sessão do Windows é sempre criada na máquina do Robô, independentemente do tipo de sessão. Em outras palavras, uma sessão é criada a partir da máquina do Robô para a mesma máquina, e não do Orchestrator para a máquina do Robô.
Quando um processo é iniciado a partir do Orchestrator, uma sessão do Windows é criada da seguinte maneira:
- O Orchestrator envia uma mensagem com os detalhes do processo para o Serviço de Robôs da UiPath.
- O Serviço de Robôs da UiPath cria uma sessão interativa do Windows na máquina.
- O Serviço de Robôs da UiPath inicia o Executor do Robô naquela sessão.
- O Executor do Robô inicia a execução do processo.
O processo é o mesmo para sessões de console e de FreeRDP.
UiPath.settings
.
Por padrão, o Robô se conecta a uma sessão de Console. Apenas uma sessão de Console pode estar ativa por vez em uma máquina. Se definido de outra forma anteriormente, você pode fazer com que o Robô se conecte a uma sessão de Console habilitando a opção LoginToConsole, por meio de um dos métodos a seguir:
- No arquivo
UiPath.settings
, defina o parâmetroLoginToConsole
comotrue
. - Ao criar ou atualizar um Robô no Orchestrator, defina o valor do LoginToConsole como
Yes
a partir da aba Configurações. Por padrão, a opção LoginToConsole está desabilitada. Isso significa que é usada a configuração a partir do arquivoUiPath.settings
. Para definir o valor desejado a partir do Orchestrator, você deve primeiro habilitar a opção LoginToConsole.
Observação: é recomendável usar esse tipo de conexão para processos que não requerem uma resolução personalizada.
Pode haver somente uma sessão de console ativa por vez na máquina. Isso significa que somente um Robô pode executar processos por vez nessa máquina. Quando a execução for concluída, a sessão será desconectada e outro Robô poderá iniciar uma sessão e executar processos nessa máquina.
Se houver uma sessão ativa de RDP quando um trabalho for iniciado a partir do Orchestrator, a sessão ativa de RDP será encerrada.
Uma sessão de Console usa a resolução especificada pelas configurações padrão da placa de vídeo na máquina. Com VDIs (como Citrix, Hyper-V, VMware), a resolução é geralmente especificada pelo hipervisor que gerencia o VDI. Observe que você não pode definir uma resolução personalizada.
Em uma sessão FreeRDP, o Robô cria uma sessão de Área de Trabalho Remota virtual na máquina em que ele estiver sendo executado. Você pode fazer com que o Robô se conecte a uma sessão FreeRDP desabilitando a opção LoginToConsole usando um dos métodos abaixo:
- No arquivo
UiPath.settings
, defina o parâmetroLoginToConsole
comofalse
. - Ao criar ou atualizar um Robô no Orchestrator, defina o valor do LoginToConsole como
No
a partir da aba Configurações. Por padrão, a opção LoginToConsole está desabilitada. Isso significa que é usada a configuração a partir do arquivoUiPath.settings
. Para definir o valor desejado a partir do Orchestrator, você deve primeiro habilitar a opção LoginToConsole.
Observação: Robôs de Alta Densidade exigem uma conexão por meio de uma sessão FreeRDP.
Em uma estação de trabalho do Windows só pode haver uma sessão FreeRDP ativa. Isso significa que somente um Robô pode executar processos por vez nessa máquina. Quando a execução for concluída, a sessão será desconectada e outro Robô poderá iniciar uma sessão e executar processos nessa máquina.
Em um Windows Server, contudo, pode haver uma sessão de FreeRDP ativa para cada usuário da máquina, ou até várias sessões para o mesmo usuário. Isso significa que vários Robôs podem executar simultaneamente processos nessa máquina, cada um para seu usuário designado. Nesse cenário, os Robôs também podem executar processos para um usuário em várias sessões, mas não precisam depender de eventos de Hardware (como as atividades do UIAutomation).
Se um trabalho for iniciado a partir do Orchestrator e uma sessão FreeRDP já estiver ativa, o processo será executado naquela sessão.
ResolutionWidth
, ResolutionHeight
e ResolutionDepth
em um dos seguintes locais:
- A partir do arquivo UiPath.settings.
- Na guia Configurações, ao criar ou atualizar um Robot no Orchestrator.
O principal meio de comunicação entre um comando de execução e a execução real do processo é o Serviço do Robot. Se não for necessário executar nenhum processo, o Serviço do Robot aguarda ocioso na máquina do Windows e não requer uma sessão do Windows ativa. Isso é feito para assegurar uma comunicação aberta constante com o Orchestrator e para poder iniciar imediatamente um processo se for recebido um comando. A comunicação é feita por meio do HTTPS, mais especificamente por meio do WebSockets (SignalR).
UIPATH_DNS_MACHINENAME
na máquina com o valor True
. Isso alternará o uso do nome do host DNS para localhost ao criar sessões de RDP.
false
.
Quando um comando iniciar processo é enviado ao Serviço de Robô, ele cria uma sessão do Windows naquela máquina por meio de RDP para o usuário do Robô. Depois disso, o Serviço de Robôs da UiPath gera um Executor do Robô dentro da sessão recém-criada. O Executor e o Serviço então se comunicam por meio de Pipes Nomeados, e o Executor sabe exatamente o que executar. O processo é então executado dentro da sessão do Windows.
Quando um trabalho é iniciado a partir do Orchestrator, o Robô se conecta à sessão do Windows WinSta0 com base na sua configuração de conexão de sessão. Uma sessão do WinSta0 (sessão interativa) pode ter apenas uma área de trabalho ativa por vez.
Um processo é associado à área de trabalho interativa na qual é iniciado e não pode acessar outras áreas de trabalho durante a execução. Uma área de trabalho ativa garante o seguinte:
- Os processos podem receber a entrada do usuário por meio de eventos de Hardware
- Os processos podem receber entrada do usuário por meio de eventos de Software
- A exibição da máquina é renderizada e continuamente atualizada
Uma sessão de usuário desconectada não pode ter uma área de trabalho ativa. Se uma área de trabalho não estiver ativa em uma sessão interativa, ocorre o seguinte:
- Os processos não podem receber entrada do usuário por meio de eventos de Hardware
- Os processos podem receber entrada do usuário por meio de eventos de Software
- A exibição da máquina não é renderizada