UiPath Remote Runtime

Sobre o Quipata Remo-te Rum time

O UiPath Remote Runtime é um componente que facilita a comunicação entre um aplicativo ou área de trabalho remotos, como o Citrix Virtual Apps e a extensão UiPath específica - a Extensão UiPath para Citrix, a Extensão UiPath para Área de Trabalho Remota e Aplicativos do Windows ou a Extensão UiPath para VMware Horizon. Ela reúne informações sobre os elementos-alvo da interface gráfica de aplicativos remotos e os envia para a extensão correspondente, de modo que os seletores sejam gerados nativamente no 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.

Observe que as extensões UiPath correspondentes precisam ser 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 registrará uma tarefa no TaskScheduler para que o processo UiPathRemoteRuntime.exe seja iniciado em cada login de usuário.

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 Agendamento de Tarefas do UiPath Remote Runtime pode ser adicionada ou removida por meio do instalador ou do prompt de comando, conforme mostrado nas seguintes seções.

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 ou nas máquinas com a Área de Trabalho Remota do Windows nas quais você deseja criar seus projetos de automação.
2. Faça logoff na janela do Citrix ou sessão RDP atuais na máquina do 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 ou a Extensão UiPath para a Área de Trabalho Remota e Aplicativos do Windows na máquina cliente, dependendo da tecnologia na qual você deseja criar seus projetos de automação.

Você também pode escolher implantar a extensão para Java, Chrome e Citrix no instalador, além da entrada Agendamento de Tarefas, selecionando as opções correspondentes, conforme 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 na janela do Citrix ou sessão RDP atuais na máquina do 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 ou a Extensão UiPath para a Área de Trabalho Remota e Aplicativos do Windows na máquina cliente, dependendo da tecnologia na qual você deseja 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 Citrix Virtual Apps and Desktops, além de conexões RDP da mesma forma que você 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ências do Driver

O UiPath Remote Runtime e a dependência do driver da UiPath para o pacote UiPath.UIAutomation.Activities devem possuir a mesma versão. No entanto, quando o UiPath Remote Runtime é atualizado para corresponder à dependência de um novo driver da UiPath para o pacote UiPath.UIAutomation.Activities, o UiPath Remote Runtime permanece retrocompatível com todas as versões anteriormente instaladas.

A versão do UiPath Remote Runtime é ditada pelo campo Comentários, localizado na guia Detalhes das propriedades UiPathRemoteRuntime.msi.

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

Você pode exibir as dependências enviadas com cada versão do pacote UiPath.UIAutomation.Activities nesta página.

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.

Suporte lado a lado

O componente UiPath Remote Runtime foi introduzido pela primeira vez na versão v2018.4. Para garantir a compatibilidade retroativa, as versões mais recentes do Robô (como um Robô v2019.10.1) podem ser criadas com o pacote UIAutomation versão 18.4.5 e posteriores sem problemas.

Ele é instalado no servidor do aplicativo Citrix ou na máquina da Á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. O driver é representado pela dependência da UiPath do pacote UiPath.UIAutomation.Activities.

Esta página exibe qual pacote UiPath.UIAutomation.Activities contém as versões compatíveis do driver do UiPath Remote Runtime.

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

Observe que, se você usar uma versão do pacote UiPath.UIAutomation.Activities que não contém uma das dependências da UiPath mencionadas acima, os seletores não serão gerados e uma exceção será exibida, conforme mostrado abaixo.

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 ou na máquina da Área de Trabalho Remota.

Por exemplo, se você quiser criar um projeto de automação usando o pacote UiPath.UIAutomation.Activities na versão 19.6.0, é preciso copiar a dependência da UiPath correspondente da máquina do cliente (na qual o Studio está instalado) no servidor do aplicativo Citrix 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 da UiPath instaladas ficam localizadas lá.
2. Copie a versão que corresponde ao pacote UiPath.UIAutomation.Activities que você deseja usar. Você pode exibir a lista das dependências enviadas do pacote UiPath.UIAutomation.Activities nesta página.
3. No servidor do aplicativo Citrix ou na máquina da Área de Trabalho Remota, navegue até a pasta %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath e cole a versão da dependência da UiPath copiada anteriormente aqui.

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.

Requisitos de hardware e software

O UiPath Remote Runtime tem os mesmos requisitos que o UiPath Robot. Consulte a lista completa dos requisitos aqui.