# Trabajo con RDP

La plataforma Sherpa RPA permite automatizar aplicaciones que funcionan en entornos de virtualización y ventanas de acceso remoto RDP (Remote Desktop Protocol), tanto en modo de pantalla completa como en modo ventana (modo de aplicación única en ventana).

## Instalación de Sherpa RPA Runtime

En el servidor RDP al que se va a conectar, es necesario instalar SherpaRPARuntime.exe en modo Attended siguiendo las siguientes instrucciones:

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

Después de completar la instalación, se recomienda reiniciar el servidor.

## Instalación del plugin Native RDP

En el ordenador cliente desde el que se realizará la conexión a RDP, es necesario instalar el plugin Sherpa Native RDP Plugin siguiendo las siguientes instrucciones:

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

## Conexión y trabajo con RDP

Después de instalar los componentes necesarios, se puede comenzar a trabajar con las aplicaciones que se ejecutan a través de RDP. Para ello:

* En el ordenador local, inicie Sherpa Robot.
* Utilice la herramienta de grabación de acciones para trabajar con las ventanas de RDP. Todos los elementos de la interfaz se resaltarán y los selectores se grabarán como de costumbre.
* El selector grabado contendrá el parámetro RDP en la primera línea, lo que permite identificarlo como un elemento que se encuentra en el entorno RDP.

## Uso de bloques de Sherpa Designer para trabajar con RDP

En la paleta de bloques "Escritorio remoto RDP/Citrix" de Sherpa Designer, hay bloques especiales para trabajar con RDP / Citrix.

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

Estos bloques permiten realizar acciones dentro de las ventanas de aplicaciones que se ejecutan a través de RDP.

Dependiendo de la configuración de RDP, algunos bloques universales, como "Crear conexión" o "Conectarse a la sesión", pueden funcionar con la conexión RDP, pero no funcionar con la conexión Citrix. En este caso, para iniciar una sesión RDP personalizada, realice con el Robot la simulación de una de las acciones típicas del Usuario, de acuerdo con las instrucciones de operación de RDP desplegadas en el entorno específico:

* acción para iniciar la sesión RDP;
* acción para iniciar la aplicación objetivo dentro de la sesión RDP.

Una vez que la conexión con la aplicación RDP se haya establecido de manera estándar, el Robot podrá realizar automáticamente acciones en las ventanas RDP que están en la pantalla.

## Licenciamiento de componentes

El plugin Sherpa RPA Runtime, ejecutado en el lado de RDP, no se considera un Robot independiente y no requiere una Licencia separada para su ejecución. Para la automatización exitosa de aplicaciones a través de RDP, se requiere una Licencia válida de Sherpa RPA solo en el lado del Robot cliente.

## Ejemplos de uso

Los Robots Sherpa pueden realizar diversas tareas en el entorno RDP, tales como:

* Automatización de la entrada de datos en aplicaciones;
* Procesamiento de documentos y archivos;
* Ejecución de operaciones rutinarias, como hacer clic en elementos de la interfaz e introducir texto.

Trabajar con Sherpa RPA en el entorno RDP requiere seguir ciertos pasos de instalación y configuración, sin embargo, después de esto, el proceso de automatización se vuelve simple y efectivo.

En el ordenador local se puede instalar cualquier tipo de Robot:

* Sherpa Designer + Attended Robot,
* Sherpa Attended Robot,
* Sherpa Unattended Robot.

Es desde el ordenador local donde se ejecutará y llevará a cabo el script del Robot.

> Se recomienda realizar la instalación de plugins con privilegios de administrador (después de lo cual el trabajo posterior no requiere derechos de administrador).

Después de la configuración, el Robot en el lado del cliente es capaz de grabar y reproducir acciones utilizando selectores en las ventanas abiertas a través de RDP.

Más información sobre el trabajo con selectores:

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

## Características del trabajo con sesiones RDP

Cuando se desconecta la sesión RDP utilizando la cruz, el contexto gráfico de Windows, junto con la interfaz del Usuario, deja de existir. Como resultado, los Robots basados en scripts visuales y elementos GUI dejan de funcionar.

Una alternativa es:

* Desconectar RDP utilizando un archivo especial que se puede ejecutar con privilegios de administrador y salir de RDP sin desconectar completamente la sesión. Para ello, en la máquina remota es necesario ejecutar el archivo que se encuentra en el distribuidor del Robot: `closerdpsession.exe`. Sin embargo, esto es solo un "parche", y se debe probar el funcionamiento de los robots en tales condiciones con antelación, ya que no hay garantías.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeT09qKrboPscjub0O7eid0oPD0Lhf37S_CVtGPR-CDE78rVgLiq5GWRhuoqZz--qxjo6f8USa33BsZ03V5WPoeZDsG24IF8C8Vvlecl9_2AuiqkuFWsSRfVnxJM8cL1hpuSbUEPw?key=o_zVuYPLecebuklluw-DjQ" alt=""><figcaption></figcaption></figure>

* Configuración del registro de Windows, que permite que al minimizar la ventana de la sesión de trabajo no se desconecte el contexto visual. Para ello, es necesario encontrar y verificar manualmente el parámetro: `RemoteDesktop_SuppressWhenMinimized` en el registro de Windows.\
  El instalador crea automáticamente este parámetro y le asigna el valor `2`. Sin embargo, a veces el acceso al registro puede estar bloqueado por políticas de grupo y entonces es necesario crear este parámetro manualmente en las claves: `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Terminal Server Client` y `HKEY_CURRENT_USER\SOFTWARE\Microsoft\Terminal Server Client`\
  Parámetro: `[DWORD] RemoteDesktop_SuppressWhenMinimized = 2`
* Desconectar RDP utilizando la combinación de teclas SHIFT+F4.
* Utilizar la opción del menú del Robot "Desconectarse de la sesión RDP actual".

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdGQtdGd1kXpxj0aOvhg8wdfjsijSEoImVHRuqgMemiktxSvHfB7_BUfYDtv0k2pl1rSzut3Aey7Xxm0UESXEdh8B5eDztk8fBpUhRtxywprHau3--BlFK1W79qyIjBaADE5Ri93A?key=o_zVuYPLecebuklluw-DjQ" alt=""><figcaption></figcaption></figure>

Además, al ocurrir errores de conexión, es importante verificar la configuración de direcciones IP, inicios de sesión, contraseñas y la posibilidad de establecer una conexión estable con las máquinas objetivo.

El número de sesiones RDP paralelas en el sistema está limitado por las capacidades del sistema operativo. Sin la instalación del rol RDS (Remote Desktop Services), el máximo son dos sesiones simultáneas.

Es importante tener en cuenta que los Robots que se ejecutan fuera de los contornos del cliente o en el servidor deben tener los derechos y configuraciones adecuadas. También es posible instalar varios Robots bajo diferentes cuentas en un mismo servidor.

Además, en el Orquestador se ha implementado la posibilidad de gestionar el estado de los Robots, por ejemplo, desactivarlos temporalmente durante el mantenimiento técnico. En la sección "Robots" hay interruptores para activar/desactivar Robots durante el mantenimiento o actualizaciones. Al desconectar a través del Orquestador, el Robot no recibirá nuevas Tareas, pero la sesión RDP en el sistema se mantendrá, lo que permitirá volver a conectarse y verificar el estado del Robot.

## Video

Un ejemplo de ejecución remota del script del Robot y transferencia de archivos se presenta en el siguiente video:

{% embed url="<https://sherparpa.ru/ucontent/?8fxu>" %}


---

# 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/es/sherpa-rpa/rabota-s-rdp.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.
