UiPath Remote Runtime

Sobre o Quipata Remo-te Rum time

O UiPath Remote Runtime é um componente que permite a comunicação entre um desktop ou aplicativos remotos, como Citrix Virtual Apps, e certas Extensões UiPath. Isso inclui a Extensão UiPath para Citrix, para Área de Trabalho Remota e Apps do Windows, para VMware Horizon e para Amazon WorkSpaces. Ele reúne informações sobre elementos da interface gráfica direcionados de aplicativos remotos e passa esses dados para a extensão correspondente. Isso permite a geração nativa de seletores no UI Explorer.

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.
• Em máquinas do Amazon WorkSpaces – comunica-se com a Extensão UiPath para Amazon WorkSpaces.

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.

Depois que o componente UiPath Remote Runtime estiver instalado, ele registra uma tarefa no Agendador de Tarefas para que o processo UiPathRemoteRuntime.exe seja iniciado em cada login de usuário, para cada 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.

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.

Instalar o UiPath Remote Runtime

No Instalador

1. Execute o arquivo UiPathRemoteRuntime.msi para instalar o UiPath Remote Runtime. Precisa ser instalado em todos os servidores de Aplicativos Citrix, máquinas virtuais VMware Horizon, máquinas de Área de Trabalho Remota do Windows ou nos desktops virtuais do Amazon WorkSpaces onde os aplicativos de destino para automação são executados.
2. Faça logoff da janela atual do Citrix, da janela VMware Horizon, da sessão RDP ou da área de trabalho virtual do Amazon WorkSpaces 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 UiPath para Citrix, para VMware Horizon, para Área de Trabalho Remota e Aplicativos do Windows ou para Amazon WorkSpaces na máquina cliente, dependendo da tecnologia na qual você deseja criar seus projetos de automação.

Você também pode optar por implantar a extensão para Java, Chrome, Microsoft Edge, Firefox, Microsoft Remote Desktop e Apps, VMware, Citrix e Amazon WorkSpaces no 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, da janela do VMware Horizon, da sessão RDP ou da área de trabalho virtual do Amazon WorkSpaces 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 UiPath para Citrix, para VMware Horizon, para Área de Trabalho Remota e Aplicativos do Windows ou para Amazon WorkSpaces na máquina cliente, dependendo da tecnologia na qual você deseja criar seus projetos de automação.

Além disso, é possível usar as seguintes opções para instalar extensões:

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask,JavaBridge,ChromeExtension,EdgeChromium,CitrixClient,FirefoxExtension,WindowsRdpExtension,VMwareExtension,AmazonWorkSpacesClient– instala o componente Remote Runtime, a entrada Agendador de Tarefas e as extensões para Java, para Chrome, para Microsoft Edge, para Citrix, para Firefox, para Microsoft Remote Desktop e Apps, para VMware Horizon e para Amazon WorkSpaces.

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 em Apps e Desktops Virtuais do Citrix, Apps VMware, desktops virtuais do Amazon WorkSpaces, bem como em conexões RDP exatamente como você faria em uma máquina padrão. Por causa das extensões correspondentes, as atividades de OCR e reconhecimento de imagena não são mais necessárias para identificar corretamente elementos da interface gráfica. Em vez disso, os elementos são reconhecidos nativamente e podem ser usados com qualquer atividade.

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.

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 do driver UiPath para o pacote UiPath.UIAutomation.Activities é exibida no Studio, na seção Dependências do projeto.

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
24.10.10	24.10.113.9929	24.10.113.9929	24.10.10 23.10.13 23.4.11 22.10.10 22.4.12 21.10.10 20.10.15
23.10.13	23.10.97.53968	23.10.97.53968	23.10.13 23.4.11 22.10.10 22.4.12 21.10.10 20.10.15
23.4.11	23.10.86.3201	23.4.81.50665	23.10.11 23.4.11 22.10.10 22.4.12 21.10.10 20.10.15
22.10.10	23.4.67.63183	22.10.67.59238	23.4.10 22.10.10 22.4.12 21.10.10 20.10.15
22.4.12	23.4.67.63183	22.4.67.58669	23.4.10 22.10.10 22.4.12 21.10.10 20.10.15
21.10.10	23.4.67.63183	21.10.67.58666	23.4.10 22.10.10 22.4.12 21.10.10 20.10.15
20.10.15	23.4.67.63183	20.10.8676.29744	23.4.10 22.10.10 22.4.12 21.10.10 20.10.15
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 que tem uma dependência da UiPath, que não faz parte do conjunto de dependências da UiPath instaladas na máquina remota, os seletores não são gerados, e a seguinte exceção é gerada: The UiPath.UIAutomation.Activities package is incompatible with the UiPath Remote Runtime running on the server.

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 o UiPath.UIAutomation.Activities corresponda à dependência do UiPath Remote Runtime no servidor Citrix, máquina virtual VMware, máquina de Área de Trabalho Remota ou a área de trabalho virtual do Amazon WorkSpaces.

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

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 Citrix, máquina virtual VMware, máquina de Área de Trabalho Remota ou área de trabalho virtual do Amazon WorkSpaces, 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. Essa informação de pacote também contém detalhes sobre a versão do pacote UIAutomation usado para compilar 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 remotas

Se você saltar por várias conexões remotas (RDP, Citrix ou VMware) para alcançar um computador remoto de destino, onde a automação é desenvolvida, você deve instalar o Remote Runtime em cada computador remoto intermediário, não apenas no de destino. Para obter mais detalhes, consulte a página Configurar uma conexão de vários saltos.