# Trabalho com Citrix

A plataforma Sherpa RPA permite automatizar aplicativos que operam em ambientes de virtualização e janelas de acesso remoto Citrix – tanto em modo de tela cheia quanto em modo de janela (modo de aplicativo único em uma janela).

## Instalação do Sherpa RPA Runtime

No servidor Citrix ao qual será feita a conexão, é necessário instalar o SherpaRPARuntime.exe em modo Attended seguindo as instruções abaixo:

{% embed url="<https://docs.sherparpa.ru/sherpa-orchestrator/razvertyvanie-platformy-pod-upravleniem-orkestratora/ustanovka-sherpa-rpa-runtime>" %}

Após a conclusão da instalação, recomenda-se reiniciar o servidor.

## Instalação do plugin Native Citrix

No computador cliente, de onde será feita a conexão com o Citrix, é necessário instalar o plugin Sherpa Native Citrix Plugin seguindo as instruções abaixo:

{% embed url="<https://docs.sherparpa.ru/sherpa-robot-i-sherpa-assistant/rabota-v-sherpa-assistant/kontekstnoe-menyu-sherpa-assistant/plaginy/ustanovka-plagina-native-citrix>" %}

## Conexão e trabalho com Citrix

Após a instalação dos componentes necessários, você pode começar a trabalhar com os aplicativos iniciados através do Citrix. Para isso:

* No computador local, inicie o Sherpa Robot.
* Use a ferramenta de gravação de ações para trabalhar com as janelas do Citrix. Todos os elementos da interface serão destacados, e os seletores serão gravados como de costume.
* O seletor gravado conterá o parâmetro Citrix na primeira linha, o que permite identificá-lo como um elemento que está no ambiente Citrix.

## Uso de blocos do Sherpa Designer para trabalhar com Citrix

Na paleta de blocos "Área de Trabalho Remota RDP/Citrix", o Sherpa Designer disponibiliza blocos especiais para trabalhar com RDP/Citrix.

{% embed url="<https://docs.sherparpa.ru/sherpa-designer/spravochnik-blokov/udalennyi-rabochii-stol-rdp-citrix>" %}

Esses blocos permitem executar ações dentro das janelas dos aplicativos iniciados através do Citrix.

Dependendo da configuração do Citrix, alguns blocos universais, como "Criar Conexão" ou "Conectar ao Sessão", podem funcionar com a conexão RDP, mas não funcionar com a conexão Citrix. Nesse caso, para iniciar uma sessão Citrix personalizada, execute com o Robô a simulação de uma das ações típicas do Usuário, de acordo com as instruções de operação do Citrix implantado no ambiente específico:

* ação para iniciar a sessão Citrix;
* ação para iniciar o aplicativo de destino dentro da sessão Citrix.

Depois que a conexão com o aplicativo Citrix for estabelecida de maneira padrão, o Robô poderá automaticamente executar ações nas janelas Citrix que estão na tela.

## Arquitetura de interação

Ao trabalhar com Citrix, o Sherpa RPA utiliza canais nomeados de transmissão de dados (ICA), que garantem a comunicação entre o Robô cliente e o runtime remoto, transmitindo comandos para as interfaces de usuário dos aplicativos-alvo a serem automatizados, executados dentro das sessões Citrix.

A tecnologia ICA é fornecida pelo próprio Citrix. Com essa tecnologia, o próprio Citrix transmite imagens, som e dados. Esse esquema permite transmitir comandos e dados entre o cliente e o servidor sem a necessidade de abrir portas adicionais, uma vez que toda a interação ocorre através da conexão Citrix existente.

O esquema de interação dos componentes para automação de aplicativos Citrix com\
o auxílio dos Robôs Sherpa RPA:

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-9223ede9482c81410bf2455f39e01b491ceb41b6%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(65).png?alt=media" alt=""><figcaption></figcaption></figure>

Em boa qualidade, o esquema pode ser visualizado aqui:

{% file src="<https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-683cddf25afd3a4413c4ef5b70209590b031e348%2F%D0%94%D0%B8%D0%B0%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%20%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20Sherpa%20RPA%20%D1%81%20Citrix.pdf?alt=media>" %}

O fluxo de dados é o seguinte:

```
Robô (PC Cliente)
     ↓
[Chamada RPC]
     ↓
Plugin Sherpa Citrix Plugin, instalado no aplicativo cliente Citrix
     ↓
[Canais nomeados virtuais ICA]
     ↓
Ambiente servidor Citrix
     ↓
SherpaRPARemote.exe
     ↓
[Canais nomeados]
     ↓
Robô Attended (Servidor Citrix)
     ↓
UI do aplicativo de destino
```

Descrição da tecnologia Citrix ICA Virtual Channels:

{% embed url="<https://support.citrix.com/s/article/CTX116890-citrix-ica-virtual-channels-overview?language=en_US>" %}

## Licenciamento de componentes

O SherpaRPARuntime.exe, executado no lado da fazenda Citrix, não é considerado um Robô autônomo e, portanto, não requer Licença para sua execução. Para a automação bem-sucedida de aplicativos Citrix, uma Licença válida para o Sherpa RPA é necessária apenas no lado do Robô cliente.

## Exemplos de uso

Os Robôs Sherpa podem realizar várias tarefas no ambiente Citrix, como:

* Automação da entrada de dados em aplicativos;
* Processamento de documentos e arquivos;
* Execução de operações rotineiras, como clicar em elementos da interface e inserir texto.

Trabalhar com o Sherpa RPA no ambiente Citrix requer a execução de certos passos de instalação e configuração, no entanto, após isso, o processo de automação se torna simples e eficaz. O uso do plugin Native Citrix e a configuração correta dos componentes do sistema permitem que os robôs Sherpa interajam com aplicativos remotos como se estivessem operando em um computador local.

No computador local, qualquer tipo de Robô pode ser instalado:

* Sherpa Designer + Robô Attended,
* Sherpa Robô Attended,
* Sherpa Robô Unattended.

É a partir do computador local que o script de trabalho do Robô será iniciado e executado.

> A instalação do plugin deve ser realizada com privilégios de administrador (para o funcionamento posterior, os direitos de administrador não são necessários).

Após isso, o Robô do lado cliente pode gravar e reproduzir ações usando seletores nas janelas do Citrix.

Mais detalhes sobre o trabalho com seletores:

{% embed url="<https://docs.sherparpa.ru/sherpa-designer/rabota-v-sherpa-designer/paneli-svoistv-i-peremennykh-i-rabota-s-nimi/panel-svoistv/nastroika-selektorov>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/pt/sherpa-rpa/rabota-s-citrix.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.