UiPath Remote Runtime

Sobre o Quipata Remo-te Rum time

UiPath^® Remote Runtime is a component which facilitates the communication between a remote application or desktop, such as Citrix Virtual Apps, and the dedicated UiPath extension – the UiPath Extension for Citrix, the UiPath Extension for Windows Remote Desktop and Apps, or the UiPath Extension for VMware Horizon. It gathers info about targeted UI elements of remote applications and sends them to the corresponding extension, so that selectors are natively generated in UIExplorer.

Observação:

A partir do Citrix Virtual Apps and Desktops 7 2109, todos os canais virtuais personalizados são bloqueados por padrão. Isso impede que o UiPath Remote Runtime funcione corretamente. Para resolver esse problema o canal virtual da UiPath deve ser adicionado à política permitir listar política:

UIPCTX,C:\Program Files (x86)\UiPath\RemoteRuntime\UiPathRemoteRuntime.exe

O componente Remote Runtime recebeu uma certificação Citrix Ready, reconhecendo-o como uma solução eficaz e confiável para trabalhar com as tecnologias da Citrix.

Dependendo do tipo de ambiente no qual você deseja criar seus projetos de automação, o componente UiPath Remote Runtime pode ser instalado da seguinte maneira:

• Nos servidores do aplicativo Citrix – Comunica-se com a extensão UiPath para Citrix.
• Em máquinas virtuais VMware Horizon - comunica-se com a extensão UiPath para VMware Horizon.
• Nas máquinas da Área de Trabalho Remota do Windows – comunica-se com a Extensão UiPath para a Área de Trabalho Remota e Aplicativos do Windows.

As extensões da UiPath correspondentes devem estar instaladas na máquina do cliente.

O instalador UiPathRemoteRuntime.msi pode ser baixado em:

• Downloads de produtos no UiPath Customer Portal
• Central de Recursos na UiPath Automation Cloud. Para acessar a Central de Recursos, faça login em sua Organização do Automation Cloud e clique no botão Ajuda na barra de navegação.

Após o componente UiPath Remote Runtime ser instalado, ele registra uma tarefa no Agendador de Tarefas para que o processo UiPathRemoteRuntime.exe seja iniciado em todo login de usuário, para todo usuário conectado ao servidor remoto.

O componente UiPath Remote Runtime é necessário para estabelecer a conexão entre um aplicativo ou servidor de área de trabalho e uma extensão UiPath correspondente instalada em uma máquina do cliente. Dessa maneira, os seletores serão gerados nativamente na máquina do cliente na qual o Studio estiver instalado, sem depender das atividades de reconhecimento de imagem e OCR.

Agendador de Tarefas

Por padrão, o componente UiPath Remote Runtime cria uma entrada no Agendador de Tarefas do Windows para iniciar automaticamente cada vez que o usuário correspondente fizer login. Essa funcionalidade é representada pela opção Criar tarefa Iniciar UiPathRemoteRuntime no instalador UiPathRemoteRuntime.msi, que você pode optar por desabilitar, se necessário.

A entrada Agendador de Tarefas do Remote Runtime pode ser adicionada ou removida por meio do instalador ou do prompt de comando, conforme mostrado nas próximas seções. Se a entrada for removida, você deve iniciar o processo UiPathRemoteRuntime.exe usando outro método, como o script de inicialização.

A entrada Agendador de Tarefas do Remote Runtime também pode ser editada para iniciar apenas para um usuário específico, clicando no botão Editar na guia Disparadores. Várias tarefas podem ser criadas para vários usuários.

Instalar o UiPath Remote Runtime

No Instalador

1. Execute o arquivo UiPathRemoteRuntime.msi para instalar o UiPath Remote Runtime.Ele precisa ser instalado em todos os servidores do aplicativo Citrix, máquinas virtuais VMware Horizon ou nas máquinas da Área de Trabalho Remota do Windows nas quais deseja criar seus projetos de automação.
2. Faça logoff da janela atual do Citrix, janela do VMware Horizon ou sessão RDP na máquina cliente e faça login novamente.Isso é necessário para que suas alterações entrem em vigor.
3. Instale a extensão da UiPath para Citrix, a extensão da UiPath para VMware Horizon ou a extensão da UiPath para Área de Trabalho Remota e Apps do Windows na máquina do cliente, dependendo da tecnologia que deseja usar para criar seus projetos de automação.

Você também pode optar por implantar a extensão para Java, Chrome, Microsoft Edge e Citrix do instalador, bem como a entrada Agendador de Tarefas, selecionando as opções correspondentes, conforme descrito abaixo:

A entrada do Agendador de Tarefas para o UiPath Remote Runtime pode ser adicionada ou removida em qualquer momento. Execute o instalador UiPathRemoteRuntime.msi e escolha a opção correspondente.

A partir do Prompt de Comando

Observação: a instalação do UiPathRemoteRuntime.msi requer direitos de administrador.

1. Clique no botão Iniciar do Windows e digite cmd no campo de pesquisa.
2. Clique com o botão direito do mouse no Prompt de Comando e execute-o como administrador.
3. Altere o diretório para a pasta UiPathRemoteRuntime.msi (por exemplo: cd C:\Tools\Studio).
4. Use o comando UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask para instalar o componente UiPath Remote Runtime.
5. Faça logoff da janela atual do Citrix, janela do VMware Horizon ou sessão RDP na máquina cliente e faça login novamente.Isso é necessário para que suas alterações entrem em vigor.
6. Instale a extensão da UiPath para Citrix, a extensão da UiPath para VMware Horizon ou a extensão da UiPath para Área de Trabalho Remota e Apps do Windows na máquina do cliente, dependendo da tecnologia que deseja usar para criar seus projetos de automação.

Além disso, você pode usar os argumentos RemoteRuntimeTask, JavaBridge, ChromeExtension, EdgeChromium ou CitrixClient para instalar a extensão para a entrada do Agendador de Tarefas, extensão para Java, Chrome, Microsoft Edge ou Citrix conforme exemplificado abaixo:

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask,JavaBridge,ChromeExtension,EdgeChromium,CitrixClient - instala o componente Remote Runtime, a entrada Task Scheduler, a extensão para Java, a extensão para Chrome, a extensão para Microsoft Edge e a extensão para Citrix.

Você também pode executar uma instalação silenciosa usando o parâmetro /quiet:

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet - instala silenciosamente o componente Remote Runtime e a entrada Task Scheduler.

Você pode instalar o UiPath Remote Runtime em qualquer local usando a opção APPLICATIONFOLDER:

• UiPathRemoteRuntime.msi APPLICATIONFOLDER="D:\UiPathRemoteRuntime" ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet — instala silenciosamente o componente Remote Runtime em D:\UiPathRemoteRuntime e adiciona a entrada do Agendador de Tarefas.

Agora você pode criar processos para automatizar no aplicativos virtuais e desktops Citrix, aplicativos VMware, bem como em conexões RDP, exatamente como faria em uma máquina padrão.Devido às extensões correspondentes, as atividades de reconhecimento de imagem e OCR não são mais necessárias para identificar adequadamente os elementos de interface gráfica. Em vez disso, os elementos são reconhecidos nativamente e podem ser usados com qualquer atividade.

Dependência UIAutomation

O UiPath Remote Runtime é uma dependência da versão do pacote UiPath.UIAutomation.Activities, não da versão do UiPath Studio/Robot.

O Remote Runtime instalado em uma máquina remota deve ter a versão do pacote UIAutomation mais recente que você deseja usar em seus projetos e também é compatível com as versões anteriores do UIAutomation (é retrocompatível).

O pacote UiPath.UIAutomation.Activities e o UiPath Remote Runtime têm a mesma dependência de drivers UiPath. Para cada versão do pacote UIAutomation lançada, é fornecido um link de download para o componente UiPath Remote Runtime com o mesmo número de versão.

Por exemplo, para a versão 23.10.8 do pacote UiPath.UIAutomation.Activities, o instalador necessário do UiPath Remote Runtime pode ser baixado em https://download.uipath.com/versions/23.10.8/UiPathRemoteRuntime.msi.

Você pode baixar o instalador UiPathRemoteRuntime.msi em:

• Downloads de produtos no UiPath Customer Portal.
• Central de Recursos na UiPath Automation Cloud. Para acessar a Central de Recursos, faça login na sua organização da Automation Cloud, clique no botão Ajuda da barra de ferramentas e escolha Recursos > Downloads.
• Ou você pode solicitar na página Entrar em contato com o suporte técnico.

Suporte lado a lado

O componente UiPath Remote Runtime é instalado no servidor do aplicativo Citrix, máquina virtual VMware ou máquina de Área de Trabalho Remota na pasta %ProgramFiles(x86)\UiPath. Todas as versões instaladas ficam visíveis na pasta %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath.

Quando você cria ou executa um processo, é necessário usar um pacote UiPath.UIAutomation.Activities que seja compatível com a versão do driver implantada do UiPath Remote Runtime.

A versão da dependência de drivers UiPath para o pacote UiPath.UIAutomation.Activities é exibida no Studio na seção de informações do Gerenciador de Pacotes.

A mesma versão da UiPath deve estar presente na máquina remota e na pasta %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath.

Cada instalador UiPathRemoteRuntime.msi contém a dependência mais recente da UiPath, além das dependências compatíveis mais recentes de Suporte em Longo Prazo (Long Term Support, LTS) da UiPath.

A tabela abaixo lista as dependências entre o pacote UiPath.UIAutomation.Activities e o UiPath Remote Runtime:

Versão do pacote UIAutomation	Número de versão do UiPathRemoteRuntime	Dependência de drivers UiPath	Versões compatíveis do UIAutomation para o UiPathRemoteRuntime
23.4.11	23.10.86.3201	23.4.81.50665	23.10.11 23.4.11 22.10.8 22.4.10 21.10.9 20.10.14
22.10.8	23.4.62.63969	22.10.60.25726	23.4.8 22.10.8 22.4.10 21.10.9 20.10.14
22.4.10	23.4.62.63969	22.4.62.58438	23.4.8 22.10.8 22.4.10 21.10.9 20.10.14
21.10.9	23.4.60.36194	21.10.60.24919	23.4.7 22.10.7 22.4.9 21.10.9 20.10.14
20.10.14	23.4.60.36194	20.10.8558.20688	23.4.7 22.10.7 22.4.9 21.10.9 20.10.14
19.11.5	22.4.43.27553	19.10.7601.15369	22.4.7 21.10.7 20.10.12 19.11.5 18.4.8
18.4.8	22.4.43.27553	10.0.7772.19184	22.4.7 21.10.7 20.10.12 19.11.5 18.4.8

Você pode verificar o número de versão do Remote Runtime nas Propriedades do arquivo UiPathRemoteRuntime.msi, na guia Detalhes, no campo Comentários.

Se você usar uma versão do pacote UiPath.UIAutomation.Activities com uma dependência UiPath que não faz parte do conjunto de dependências UiPath instaladas na máquina remota, os seletores não serão gerados e a seguinte exceção será emitida: O pacote UiPath.UIAutomation.Activities não é compatível com o UiPath Remote Runtime executado no servidor.

Como adicionar as dependências do UiPath Remote Runtime

A seleção interativa no aplicativo de destino não cria seletores corretos, a menos que a UiPath.UIAutomation.Activities corresponda à dependência do UiPath Remote Runtime no servidor do aplicativo Citrix, máquina virtual VMware ou na máquina da Área de Trabalho Remota.

Por exemplo, se você quiser criar um projeto de automação usando o UiPath.UIAutomation.Activities o pacote na versão 23.10.8, é preciso copiar a dependência da UiPath correspondente da máquina cliente (na qual o Studio/Robot está instalado) no servidor do aplicativo Citrix, máquina virtual VMware ou na máquina da Área de Trabalho Remota.

Isso é feito da seguinte maneira:

1. Na máquina do cliente (na qual o Studio está instalado), navegue até a pasta %UserProfile%\.nuget\packages\uipath. Todas as dependências UiPath instaladas estão localizadas aqui.
2. Copie a pasta com a versão que corresponde ao pacote UiPath.UIAutomation.Activities que você deseja usar. Você pode visualizar a lista de dependências enviadas com o pacote UiPath.UIAutomation.Activities na página Sobre atividades do UIAutomation ou verificar as dependências do pacote conforme descrito em Suporte lado a lado.
   
   

   

   
   
3. No servidor do aplicativo Citrix, máquina virtual VMware ou na máquina de Área de Trabalho Remota, navegue até a pasta %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath e cole a versão de dependência da UiPath copiada anteriormente aqui.
   • Por exemplo, para o UiPath.UIAutomation.Activities versão 23.10.8, a dependência do UiPath correspondente é 23.10.71.64399. Este é o nome da pasta que você precisa copiar da máquina do Studio/Robot para a máquina remota.
   
   

   

   
   

Os seletores agora são gerados corretamente com a sua versão atual do UiPath.UIAutomation.Activities. As alterações entram em vigor assim que a dependência for copiada.

As dependências do Remote Runtime descritas acima são necessárias tanto para as etapas de projeto quando de execução.

Arquitetura do UiPath Remote Runtime

Quando você inicia o processo, o Robô envia os comandos necessários para a extensão para Citrix ou Área de Trabalho Remota do Windows por meio de um canal RPC. Esse pacote de informações também contém detalhes sobre a versão do pacote UIAutomation usado para criar o processo.

A extensão correspondente encaminha o pacote de informações por meio de um canal virtual do ICA para o componente do UiPath Remote Runtime, que fica nos servidores do aplicativo Citrix ou na máquina da Área de Trabalho Remota.

Dependendo da versão do pacote UIAutomation com o qual o processo foi criado, o componente UiPath Remote Runtime instrui o Executor do Robô qual driver usar.

Vários canais do ICA

A comunicação entre o componente UiPath Remote Runtime e a extensão correspondente é feita por meio de um canal do ICA desenvolvido internamente. Vários canais do ICA podem ser usados, mas o Citrix Receiver, por exemplo, já usa vários canais para a área de transferência, áudio e mais.

Considerações da transferência de dados e largura de banda

Após o componente UiPath Remote Runtime ser instalado, você poderá criar seus projetos de automação sem precisar criar regras de firewall.

A transferência de dados entre o UiPath Remote Runtime e a extensão requer pouco uso de largura de banda. Por exemplo, cada ação que o Robô executa (como uma atividade Click) transfere cerca de 3 KB de dados.

Várias conexões RDP

Se você passar por várias conexões RDP para alcançar um computador remoto de destino, onde a automação é desenvolvida, você deve instalar Remote Runtime em cada computador remoto intermediário, não apenas no de destino.

Considere o seguinte cenário: Máquina A (com robô) conecta-se por meio de RDP com a Máquina B e na Máquina B outra conexão RDP é aberta para a Máquina C, onde a automação deve ser executada. Neste exemplo, a seguinte configuração é necessária:

1. Máquina A – instalar a extensão RDP.

2. Máquina B – instalar a extensão RDP e RemoteRuntime.msi.
3. Máquina C – instalar RemoteRuntime.msi.

Requisitos de hardware e software

O UiPath Remote Runtime tem os mesmos requisitos que o UiPath Robot. Veja a lista completa de requisitos em Requisitos de hardware e software.