> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/es/sonar/administration/settings/url-actions.md). # Acciones de URL Settings › URL Actions define enlaces con variables, como la página de un cliente en la mesa de ayuda o en la documentación, que se abren desde el árbol de clientes y sitios con Run URL Action. ## Qué es y cuándo usarlo Una acción de URL es un enlace con variables. Se define una vez en **Admin Center › Settings › URL Actions** y luego se abre para un cliente o un sitio desde el árbol de clientes: SONAR rellena las variables con los valores de ese cliente o sitio y abre el resultado en una nueva pestaña del navegador. Use las acciones de URL para pasar de SONAR a otra herramienta con el registro correcto ya seleccionado: la página del cliente en su mesa de ayuda, la carpeta del sitio en su sistema de documentación, una búsqueda en su herramienta de inventario. Las acciones de URL y los webhooks se definen de la misma manera, pero hacen cosas distintas: | | Acciones de URL | Webhooks | | ------------- | ------------------------------ | --------------------------------------------------------- | | Pestaña | **URL Actions** | **Web Hooks** | | Quién la abre | Su navegador, cuando hace clic | SONAR, cuando se genera o se resuelve una alerta | | Qué es | Un enlace | Una solicitud HTTP con un método, encabezados y un cuerpo | | Página | Esta página | [Webhooks](/es/sonar/administration/settings/webhooks.md) | Como es su navegador el que abre el enlace, una acción de URL puede apuntar a un sistema al que solo llega su propia red. ## Antes de empezar * Para listar las acciones de URL y ejecutarlas, su rol necesita **Run URL Actions** (grupo **System** en **Admin Center › Roles**). * Para añadirlas, editarlas o eliminarlas, su rol también necesita **View Core Settings** y **Edit Core Settings** (grupo **Settings**). * Para ejecutar una en un cliente o un sitio, el rol debe darle acceso a ese cliente o sitio. ## Pasos ### Añadir una acción de URL 1. Abra **Admin Center › Settings** y la pestaña **URL Actions**. 2. Haga clic en **Add URL Action**. 3. Escriba un **Name**. Es la etiqueta que se muestra en el menú **Run URL Action**. 4. Si lo desea, escriba una **Description**. 5. Escriba el **URL Pattern**, con variables donde deben ir los valores, por ejemplo `https://helpdesk.example.com/customers?search={{client.name}}`. 6. Haga clic en **Submit**. ### Ejecutar una acción de URL 1. Abra **Dashboard › Sysadmin**. 2. En la barra lateral, en **Clients**, haga clic con el botón derecho en un cliente o un sitio. 3. Sitúe el puntero sobre **Run URL Action** y haga clic en la acción. SONAR construye la URL para ese cliente o sitio y la abre en una nueva pestaña. ### Editar o eliminar una acción de URL 1. En la pestaña **URL Actions**, haga doble clic en la acción para abrir **Edit URL Action**, cámbiela y haga clic en **Submit**. 2. Para eliminarla, haga clic con el botón derecho en la acción, elija **Delete** y confirme con **Delete**. ## Variables | Variable | Se sustituye por | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `{{client.name}}` | El nombre del cliente. En un sitio, el nombre del cliente del sitio | | `{{client.id}}` | El ID del cliente, que se muestra en la información emergente del cliente en el árbol | | `{{site.name}}` | El nombre del sitio, cuando la acción se ejecuta en un sitio | | `{{site.id}}` | El ID del sitio, cuando la acción se ejecuta en un sitio | | `{{client.FIELD}}`, `{{site.FIELD}}` | El valor del campo personalizado llamado `FIELD` en el cliente o el sitio, o su valor predeterminado. Vea [Campos personalizados](/es/sonar/administration/settings/custom-fields.md) | | `{{global.NAME}}` | El valor de la clave `NAME` en el almacén de claves. Vea [Almacén de claves](/es/sonar/administration/settings/key-store.md) | La URL final se codifica para el navegador, de modo que los espacios del nombre de un cliente se convierten en `%20`. La lista completa de variables está en [Variables de script](/es/sonar/reference/script-variables.md). ## Qué debe ver El recuadro **URL Actions** lista cada acción con su **Name**, su **Description** y su **URL Pattern**; si no hay ninguna, indica **No URL Actions added yet.** En el árbol de clientes, **Run URL Action** abre un submenú con las acciones de URL en orden alfabético. Al hacer clic en una, se abre una nueva pestaña del navegador en la URL final. Si no hay ninguna acción de URL definida, un aviso indica que no hay ninguna configurada. ## Cómo verificar que funcionó 1. Ejecute la acción en un cliente de prueba. La nueva pestaña debe abrirse en la URL con los valores del cliente en lugar de las variables. 2. Abra **Reports & Audits › Audits** y elija **URL Action** en **Action**. Una entrada registra quién ejecutó qué patrón en qué cliente o sitio. Vea [Registro de auditoría](/es/sonar/administration/audit/audit-trail.md). ## Errores comunes | Síntoma | Causa | Solución | | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | La URL contiene `None` | No se pudo resolver una variable: está mal escrita, o es un campo personalizado o una clave que no existe | Compare la variable con la tabla anterior, y revise los nombres en **Custom Fields** y **Key Store** | | Una variable de sitio muestra el valor del cliente | La acción se ejecutó en un cliente, que no tiene sitio | Ejecute en un sitio las acciones que usan variables de sitio | | **Failed to save** con un mensaje sobre un campo en blanco | **Name** o **URL Pattern** está vacío | Rellene ambos | | **Run URL Action** aparece atenuado, con **You don't have permission for this action** | El rol no tiene **Run URL Actions** | Conceda ese permiso en **Admin Center › Roles** | | **Failed to load actions** en la pestaña **URL Actions** | El rol no tiene **Run URL Actions** | Conceda ese permiso, o recurra a un usuario que lo tenga | | No se abre nada | El navegador bloqueó la nueva pestaña | Permita las ventanas emergentes para la consola | | La nueva pestaña se abre pero no se encuentra la página | El patrón de URL no corresponde al sistema de destino | Pruebe la URL final a mano y corrija el patrón | ## Referencia de campos | Campo | Qué hace | Valores aceptados | Valor por defecto | | --------------- | --------------------------------------------------------------- | --------------------------------------------------------------------- | ----------------- | | **Name** | Etiqueta en el menú **Run URL Action** y en la lista | Texto. Obligatorio | Vacío | | **Description** | Nota para los demás administradores, que se muestra en la lista | Texto | Vacío | | **URL Pattern** | El enlace, con las variables entre llaves dobles | Una URL completa, que empiece por `https://` o `http://`. Obligatorio | Vacío | ## Páginas relacionadas * [Webhooks](/es/sonar/administration/settings/webhooks.md): solicitudes que SONAR envía con las alertas * [Clientes y sitios](/es/sonar/administration/devices/clients-and-sites.md): el árbol donde se ejecutan las acciones de URL * [Campos personalizados](/es/sonar/administration/settings/custom-fields.md): valores que puede poner en una URL * [Almacén de claves](/es/sonar/administration/settings/key-store.md): valores globales que puede poner en una URL * [Variables de script](/es/sonar/reference/script-variables.md): la lista completa de variables