Extensão para Citrino

Ao instalar a Extensão da UiPath para Citrix, você é capaz de automatizar Aplicativos Citrix de forma nativa. Ela pode ser instalada a partir do Studio ou do Prompt de Comando.

Observação: você precisa instalar o cliente Citrix (Citrix Receiver ou Citrix Workspace) por máquina para poder instalar a extensão UiPath para Citrix.

A partir do UiPath Studio

1. Abra o Studio.
2. Navegue até Início > Ferramentas > Extensões da UiPath.
3. Selecione Citrix > Instalar. Uma caixa de diálogo de confirmação é exibida.
4. Reinicie todos os seus aplicativos Citrino para que as alterações entrem em vigor.

A extensão da UiPath para Citrix agora está instalada no diretório de instalação do Citrix.

A partir do Prompt de Comando

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 de instalação da UiPath (cd C:\Program Files\UiPath\Studio\UiPath para as instalações por máquina, cd %localappdata%\Programs\UiPath\Studio\UiPath para as instalações por usuário).
4. Use o comando SetupExtensions /CitrixClient para instalar a extensão. Uma caixa de diálogo de confirmação é exibida.
5. Reinicie todos os seus aplicativos Citrix para que as alterações entrem em vigor. A Extensão da UiPath para Citrix está agora instalada.
   Observação: para gerar seletores nativos para a tecnologia Citrix, você também precisa implantar o componente UiPath Remote Runtime em todos os seus servidores de aplicativo Citrix, conforme explicado nesta página. O instalador UiPathRemoteRuntime.msi é obtido solicitando-o aqui.

Desinstalando a Extensão da UiPath para Citrix

Do Studio

1. Abra o Studio.
2. Navegue até Início > Ferramentas > Extensões da UiPath.
3. Selecione Citrix > Desinstalar e confirme sua escolha.

A Extensão da UiPath para Citrix está agora desinstalada.

A partir da Linha de comando

1. Feche todos os seus aplicativos Citrix em execução.
2. Clique no botão Iniciar do Windows e digite cmd no campo de pesquisa.
3. Clique com o botão direito do mouse no Prompt de Comando e execute-o como administrador.
4. Altere o diretório para a pasta de instalação da UiPath (cd C:\Program Files\UiPath\Studio\UiPath para as instalações por máquina, cd %localappdata%\Programs\UiPath\Studio\UiPath para as instalações por usuário).
5. Use o comando SetupExtensions /CitrixClient /uninstall para desinstalar a extensão. Uma caixa de diálogo de confirmação é exibida.

A Extensão da UiPath para Citrix está agora desinstalada.

Solução de problemas da extensão Citrix

Esta página explica como corrigir problemas que você pode encontrar ao executar automação em ambientes Citrix.

Seleção Interativa em Aplicativos Citrix Congela e Nada é Selecionado

Comportamento Observado

Após instalar a Extensão da UiPath para Citrix e tentar selecionar elementos de interface gráfica a partir de um Aplicativo Citrix, a seleção interativa congela por um minuto e depois nada é selecionado.

Causa

Isso acontece se o UiPath Remote Runtime não estiver em execução na sessão do Aplicativo Citrix.

Solução

• Verifique se o UiPathRemoteRuntime.msi está instalado no servidor do Aplicativo Citrix a partir do qual o Aplicativo Citrix é aberto.

• No servidor do aplicativo Citrix, verifique se o processo da UiPathRemoteRuntime.exe está em execução. Se a UiPathRemoteRuntime.msi estiver instalada, o processo será iniciado automaticamente no logon de sessão do Aplicativo Citrix.

  
  

  

  
  
  Observação: se você não conseguir instalar o UiPathRemoteRuntime.msi nos servidores de aplicativos Citrix, é recomendável desinstalar a extensão UiPath para o Citrix da máquina cliente, conforme descrito aqui.

Não foi possível copiar o arquivo “C:\Arquivos de Programa (x86)\Citrix\ICA Client\UIPathPluginCitrix.dll". Ele está sendo usado por outro processo.

Comportamento Observado

Quando você tentar instalar a Extensão da UiPath para Citrix, o seguinte erro é exibido:

Causa

Isso ocorre quando a Extensão da UiPath para Citrix já está instalada e um Aplicativo Citrix aberto a está utilizando.

Solução

Feche todas as suas sessões ativas do Aplicativo Citrix conforme descrito aqui e tente instalar a Extensão da UiPath para Citrix novamente.

Não foi possível ler a chave de registro Citrix: 'SOFTWARECitrixInstallICA Client' Value: 'InstallFolder'

Comportamento Observado

Quando você tentar instalar a Extensão da UiPath para Citrix, o seguinte erro é exibido:

Causa

Esta mensagem de erro é exibida quando o Receptor Citrix não estiver instalado. Ela também é exibida se o Receptor Citrix para a Plataforma Universal do Windows estiver instalado.

Solução

Faça o download e instale o Citrix Receiver ou Citrix Workspace.

Exceção Não Técnica em wfica32.exe 0xC00094: Divisão de Inteiros por Zero

Comportamento Observado

Aplicativo Citrix de destino não pode ser iniciado e o cliente Citrix ICA falha.

Causa

Atividades que usam a função GetWindowText (como Element Exists) são executadas antes que o Aplicativo Citrix possa ser carregado.

Solução

Reserve um tempo para que o Aplicativo Citrix seja carregado adicionando um atraso antes da atividade.