> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/rdm/es/knowledge-base/knowledge-base-articles/protocol-handler.md).

# Controlador de protocolo

Se ha implementado un ***Controlador de protocolo*** en Remote Desktop Manager para poder iniciar una sesión directamente desde contenido HTML. Esto puede ser muy útil para llamar a Remote Desktop Manager desde una base de datos de gestión de configuración (CMDB) o incluso desde un sistema de gestión documental (DMS).

{% hint style="info" %}
Internet Explorer y Mozilla Firefox ejecutan la URL al hacer clic en ella o al pulsar <kbd>Enter</kbd>. Sin embargo, con algunos otros navegadores web como Google Chrome, ejecutar la URL normalmente da lugar a una búsqueda web. Estos navegadores pueden requerir hacer <kbd>Ctrl</kbd>+clic o <kbd>Ctrl</kbd>+<kbd>Enter</kbd> para ejecutar la URL.
{% endhint %}

### Escenarios

Hay dos formas de usar el controlador:

* Generar una URL para una sesión: básicamente cualquier tipo de entrada que se conecte a un dispositivo remoto mediante un protocolo.
* Generar una URL para una plantilla: le permite especificar el nombre de host del dispositivo al que desea conectarse, pero toma la configuración de la plantilla.

### Parámetros

Estos son los parámetros utilizados para construir una URL de controlador de protocolo para escenarios avanzados. ***DataSource*** y ***Session IDs*** son suficientes para abrir una conexión.

{% hint style="info" %}
El parámetro ***DataSource*** anula el espacio de trabajo al que la aplicación se conecta al iniciarse. Esto se aplica incluso si se solicita al usuario un espacio de trabajo al que conectarse..
{% endhint %}

<table><thead><tr><th width="123.5999755859375">PARÁMETRO</th><th>DESCRIPCIÓN</th></tr></thead><tbody><tr><td>DataSource</td><td>Indique el espacio de trabajo o el ID de la base de datos. Los encontrará en la sección <em><strong>IDs</strong></em> de las <em><strong>Propiedades avanzadas</strong></em> de una entrada.<br><br>Un ID de espacio de trabajo es único por instalación, lo que hace que la URL solo se pueda utilizar en la estación de trabajo donde se ha creado el espacio de trabajo. De forma predeterminada, Remote Desktop Manager genera la URL con el ID de la base de datos.</td></tr><tr><td>Session</td><td>Indique el ID de una sesión. Lo encontrará en el campo <em><strong>ID de sesión</strong></em> de las <em><strong>Propiedades avanzadas</strong></em> de una sesión.</td></tr><tr><td>Template</td><td>Indique el ID de la plantilla de una entrada. El parámetro template recupera algunas propiedades de una plantilla y las utiliza junto con el parámetro session. El parámetro host es obligatorio cuando se utiliza el parámetro template.</td></tr><tr><td>Host</td><td>Indique el nombre de host o la dirección IP del dispositivo remoto. Se utiliza junto con el parámetro template, o para anular la propiedad host del parámetro session.</td></tr><tr><td>Port</td><td>Indique el puerto que se debe utilizar. Se utiliza para anular la propiedad port del parámetro session o template.</td></tr><tr><td>Username</td><td>Indique el nombre de usuario que se debe utilizar. Se utiliza para anular la propiedad username del parámetro session o template.</td></tr><tr><td>Password</td><td>Indique la contraseña que se debe utilizar. Se utiliza para anular la propiedad password del parámetro session o template.</td></tr><tr><td>Domain</td><td>Indique el dominio que se debe utilizar. Se utiliza para anular la propiedad domain del parámetro session o template.</td></tr><tr><td>Title</td><td>Indique el título de la pestaña cuando se inicia una sesión utilizando el modo de visualización <em><strong>Embedded</strong></em> (con pestañas). Esto puede ser muy útil cuando se inician varias sesiones al mismo tiempo.</td></tr><tr><td>Filter</td><td>Rellene el campo <em><strong>Buscar</strong></em>.</td></tr><tr><td>Tabpage</td><td>Da el foco a una pestaña del dashboard después de que la aplicación haya completado el procedimiento de inicio. Disponible solo con la acción <em><strong>Select</strong></em>. Las pestañas posibles son:- <em><strong>Descripción general</strong></em></td></tr></tbody></table>

* ***Documentación***
* ***Macros/Scripts/Herramientas***
* ***Herramientas de gestión***
* ***Información***
* ***Adjuntos***
* ***Registros***
* ***Grabaciones*** |

### Acciones

* ***Open***: Abre la conexión especificada.
* ***Find***: Busca sesiones por host.
* ***Edit***: Edita la conexión especificada.
* ***View***: Muestra la contraseña de la entrada especificada.
* ***OpenWithMacro***: Abre la especificada con una macro.
* ***Select***: Selecciona una conexión en el ***panel de navegación*** (también permite seleccionar una pestaña del dashboard).

### Sintaxis

`rdm://<action>=<value>[&=<value>]`

La sintaxis básica del controlador de protocolo requiere el protocolo de aplicación, una acción y al menos un parámetro con el que trabajar.

Hay tres reglas que seguir al construir una URL para el controlador de protocolo:

* La acción se separa de los parámetros con un signo de interrogación (?).
* A cada parámetro se le asigna un valor mediante un signo igual (=).
* Los pares parámetro/valor se separan con un ampersand (&).

### Ejemplos

**Abrir Remote Desktop Manager con el campo de búsqueda/filtro rellenado y el foco en el Dashboard**

`rdm://open?Filter=RDP&Tabpage=Dashboard`

**Abrir una sesión RDP**

1. En la sección ***Información de la entrada*** de las propiedades de una entrada, haga clic en ***Crear URL web***.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2029_2024_1.png" alt=""><figcaption></figcaption></figure>
2. Seleccione ***Controlador de protocolo RDM (rdm://)***.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2030_2024_1.png" alt=""><figcaption></figcaption></figure>
3. La URL se ha copiado ahora en el portapapeles. Haga clic en ***OK*** para cerrar la ventana de confirmación.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2031_2024_1.png" alt=""><figcaption></figcaption></figure>
4. Pegue (<kbd>Ctrl</kbd>+<kbd>V</kbd>) esta URL en cualquier aplicación capaz de gestionar protocolos de aplicación. Puede ser en una página web, en la barra de direcciones de un navegador web o incluso en una aplicación de chat compatible. El controlador de protocolo inicia Remote Desktop Manager si está cerrado y, a continuación, realiza la acción solicitada con los parámetros proporcionados.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/rdm/es/knowledge-base/knowledge-base-articles/protocol-handler.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.