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:
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
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
Abra Admin Center › Settings y la pestaña URL Actions.
Haga clic en Add URL Action.
Escriba un Name. Es la etiqueta que se muestra en el menú Run URL Action.
Si lo desea, escriba una Description.
Escriba el URL Pattern, con variables donde deben ir los valores, por ejemplo
https://helpdesk.example.com/customers?search={{client.name}}.Haga clic en Submit.
Ejecutar una acción de URL
Abra Dashboard › Sysadmin.
En la barra lateral, en Clients, haga clic con el botón derecho en un cliente o un sitio.
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
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.
Para eliminarla, haga clic con el botón derecho en la acción, elija Delete y confirme con Delete.
Variables
{{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
{{global.NAME}}
El valor de la clave NAME en el almacén de claves. Vea Almacén de claves
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.
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ó
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.
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.
Errores comunes
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
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: solicitudes que SONAR envía con las alertas
Clientes y sitios: el árbol donde se ejecutan las acciones de URL
Campos personalizados: valores que puede poner en una URL
Almacén de claves: valores globales que puede poner en una URL
Variables de script: la lista completa de variables
Atualizado
Isto foi útil?