Conectar un widget a una fuente externa (vista Panel de control)
Comprender cómo utilizar una fuente de datos externa en un panel de control.
·
12 min de lectura
La vista Tablero se construye a partir de una anidación de widgets en la página. Presentan gráficos de datos cuya fuente puede ser:
ya sea el tablero actual,
ya sea un servicio web.
Para conectarse a datos provenientes de un servicio web, es necesario que este último devuelva una respuesta payload en formato JSON cuyos parámetros serán variables según el tipo de widget a alimentar.
Es importante señalar que solo ciertos widgets permiten exponer datos externos, por el momento, tales como:
Número,
Curvas,
Gráfico de barras,
Gráfico de anillo,
Radar,
Histograma,
Tabla.
Widget Número
El widget Número permite mostrar una puntuación con su variación y potencialmente un gráfico de valor por fecha.
Si se deben presentar varios widgets de número en la vista, la respuesta payload podrá contener toda la información por tipo de widget deseado. En este caso, durante la configuración de cada widget, la parametrización se realizará de tal manera que llame a la información correcta en la respuesta payload devuelta.
Formato de la respuesta Payload
La alimentación de este tipo de widget requiere la siguiente información en la respuesta Payload devuelta:
Información mostrada
Atributo
Parámetros del atributo
Obligatorio
Ejemplo
Título del widget
title
"title":"Puntuación de seguridad",
Fecha de inicio del gráfico (fecha y hora)
startDate
"startDate":"2024-12-20T00:00:00Z"
Fecha de fin del gráfico (fecha y hora)
endDate
"endDate":"2025-03-30T00:00:00Z
Ejemplo de respuesta
OTRO EJEMPLO
Widget Curvas
El widget Curvas, como su nombre indica, permite mostrar datos en forma de varias curvas.
puede tener varios valores como line, progressBar, donuts, radar, verticalBar, … pero el que se debe utilizar para este gráfico es obviamente "progressBar"
El widget Gráfico de anillo, como su nombre indica, permite representar los datos en forma de segmentos circulares dispuestos alrededor de un centro vacío, formando así un anillo (o donut).
Formato de la respuesta Payload
La alimentación de este tipo de widget requiere la siguiente información en la respuesta Payload devuelta:
Información mostrada
Atributo
Parámetros del atributo
Obligatorio
Ejemplo
Título del widget
title
"title":"Usuarios en riesgo",
Botón de ayuda que permite acceder a una documentación en línea
help
text : Etiqueta de la ayuda en información sobre herramientas
URL : URL de acceso a la ayuda en línea
El widget Radar permite representar los datos en forma de un diagrama de estrella vacío o lleno. Así, es posible representar varios conjuntos de datos superpuestos unos sobre otros.
Formato de la respuesta Payload
La alimentación de este tipo de widget requiere la siguiente información en la respuesta Payload devuelta:
Información mostrada
Atributo
Parámetros del atributo
Obligatorio
Ejemplo
Título del widget
title
"title" : "Distribución de puntuaciones por categoría",
Visualización de la escala
activateScale
true / false
"activateScale":true
Valor de la escala
scaleStep
20 si el parámetro no se especifica, de lo contrario indicar un valor de escala numérico.
activateScale debe estar en true
"scaleStep":10
Botón de ayuda que permite acceder a una documentación en línea
help
text : Etiqueta de la ayuda en información sobre herramientas
URL : URL de acceso a la ayuda en línea
El widget Tabla permite proponer una representación de los datos en forma de tabla que puede contener datos simples o compuestos por un indicador visual y una etiqueta.
Formato de la respuesta Payload
La alimentación de este tipo de widget requiere la siguiente información en la respuesta Payload devuelta:
Información mostrada
Atributo
Parámetros del atributo
Obligatorio
Ejemplo
Título del widget
title
"title":"Amenazas",
Botón de ayuda que permite acceder a una documentación en línea
help
text : Etiqueta de la ayuda en información sobre herramientas
URL : URL de acceso a la ayuda en línea
data : Lista de los datos de la tabla
A continuación se enumeran cada uno de los id de columnas y el valor que debe mostrarse en ellas. De hecho, cada bloque constituye una fila de la tabla.
Si una columna propone opciones de renderizado, entonces también se especificarán los valores relativos a estos diferentes parámetros de renderizado (ej.: color, background, etc.).-
Haga clic en Nueva conexión > Fuente de datos Panel de control.
Introduzca la información requerida, incluida la URL de acceso al servicio web de destino.
Haga clic en Agregar.
Una vez establecida la conexión, debe utilizar esta conexión al agregar sus widgets en la vista Panel de control.
Creación de una nueva conexión
Declarar variables
En el panel, puede necesitar declarar una o varias variables que permitirán contextualizar la vista Panel de control a un ámbito de datos particular (ej.: los datos de un cliente). Para ello, puede declarar una variable que luego invocará en el o los widgets deseados, siendo estas variables interpretadas en el momento de la carga de la vista.
Haga clic en el botón … del tablero > Conectores.
Haga clic en la pestaña Variables.
Haga clic en Nueva Variable.
Introduzca su nombre y su valor antes de validar.
Edite los parámetros del widget que deberá utilizar esta variable haciendo clic en el botón Rueda dentada del widget.
Ingrese, en la pestaña Payload, el valor como: "Nombre del dato variable" : "%Nombre de la variable declarada en el tablero%"
Agregar un widget conectado en la vista Panel de control
Agregar un widget conectado es muy sencillo:
En la vista Panel de control, haga clic en Agregar un widget.
Seleccione un widget entre los compatibles con una fuente externa.
Elija la conexión correspondiente a la fuente declarada previamente.
Introduzca los parámetros del payload específicos de su servicio web.
Haga clic en Guardar.
Nota: puede hacer clic en Probar y luego en la pestaña Resultados de la prueba para verificar si sus parámetros de Payload están bien configurados y devuelven la información esperada.
Adición de un widget conectado
Probar / modificar temporalmente los datos devueltos en la vista Panel de control
Como se indicó anteriormente, al hacer clic en Probar, tiene acceso a los datos devueltos en la respuesta payload del widget en la pestaña Resultados de la prueba.
Sin embargo, tenga en cuenta que también puede modificar estos datos y hacer clic en Aplicar para ver las modificaciones aplicarse temporalmente en el widget de la vista.
Adición de parámetros de prueba de un widget conectado