|
|
| (No se muestran 30 ediciones intermedias del mismo usuario) |
| Línea 1: |
Línea 1: |
| − | {| class="wikitable"
| + | #REDIRECT [[Manual de Usuario de Vivait Supervisor 2.0]] |
| − | |-
| |
| − | ! '''Producto: '''!! '''''VIVA'''''it Call v5.1
| |
| − | '''''VIVA'''''it Suite
| |
| − | |-
| |
| − | |}
| |
| − | <big>
| |
| − | <br><br>
| |
| − | == Introducción a Vivait-Supervisor ==
| |
| − | <br><br>
| |
| − | Con la versión 5.1 de la plataforma '''''VIVA'''''it Call se ha lanzado la aplicación: ''Vivait-Supervisor''.
| |
| − | <br><br>
| |
| − | Los puntos claves del '''''portal Vivait-Supervisor''''' son:<br>
| |
| − | : • Seguimiento de las llamadas generadas en el sistema '''''VIVA'''''it Call.<br>
| |
| − | : • Visualización de resultados mediante gráficos, tablas y otros formatos.<br>
| |
| − | : • Exportación de datos para su posterior análisis.
| |
| − | <br><br>
| |
| − | A continuación se definen los principales conceptos empleados en el supervisor:
| |
| − | <br><br>
| |
| − | '''Dashboard'''<br>
| |
| − | Panel de control que presenta de forma visual y resumida la información clave (datos, indicadores o métricas),<br>
| |
| − | con el objetivo de facilitar la supervisión, el análisis y la toma de decisiones de manera rápida y eficiente.<br>
| |
| − | Un dashboard está compuesto por uno o varios componentes.
| |
| − | <br><br>
| |
| − | '''Componente'''<br>
| |
| − | Elemento individual que forma parte de un dashboard y cuya función es mostrar la información requerida.<br>
| |
| − | Los componentes pueden adoptar distintos formatos, entre los más habituales:<br>
| |
| − | :'''• Tablas:'''<br>
| |
| − | ::La información se presenta en formato tabular. Las cabeceras y la estructura de la tabla se definen durante la creación de su lógica.<br>
| |
| − | :'''• Gráficos:'''<br>
| |
| − | ::Los datos se muestran de forma visual mediante distintos tipos de gráficos, como barras, líneas, circulares, entre otros.<br>
| |
| − | :Según el modo en que actualizan la información, los componentes se clasifican en:<br>
| |
| − | :'''• Dinámicos:'''<br>
| |
| − | ::La información se actualiza de forma periódica, de acuerdo con un temporizador asociado al componente.<br>
| |
| − | :'''• Estáticos:'''<br>
| |
| − | ::La información se carga al iniciar el dashboard y no se vuelve a actualizar hasta que el panel de control se invoca nuevamente.
| |
| − | <br><br>
| |
| − | [[#Introducción a Vivait-Supervisor | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/VIVAit_Supervisor Volver al índice]
| |
| − | <br><br>
| |
| − | | |
| − | === Arquitectura de Vivait-Supervisor ===
| |
| − | <br><br>
| |
| − | Los bloque funcionales, servicios y elementos que componen la aplicación están divididos en dos capas principales:
| |
| − | <br><br>
| |
| − | : - '''Frontend'''<br>
| |
| − | ::Reside en un servidor web Apache.<br>
| |
| − | ::Se invoca desde un navegador mediante una URL del tipo https://host/ws/<br>
| |
| − | https://172.25.128.92/Vivait-Supervisor/
| |
| − | ::Es la parte visual: HTML, CSS, JavaScript.<br>
| |
| − | ::No accede directamente a la base de datos; solo obtiene datos desde una API.
| |
| − | <br><br>
| |
| − | : - '''Backend / API REST'''<br>
| |
| − | ::Corre en un servidor web Tomcat.<br>
| |
| − | ::Expone la API en: <br>
| |
| − | https://172.25.128.92/Vivait-Supervisor/.
| |
| − | ::Contiene la lógica que permite interactuar con la BBDD.<br>
| |
| − | ::Responde en JSON para que el frontend pueda ofrecérselo al navegador.<br>
| |
| − | <br><br>
| |
| − | Diagrama funcional de la arquitectura de Vivait-Supervisor
| |
| − | <br><br>
| |
| − | [[File:arquitectura_supervisor2_V5.1.png|1500px|center|thumb]] | |
| − | <br><br>
| |
| − | [[#Introducción a Vivait-Supervisor | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/VIVAit_Supervisor Volver al índice]
| |
| − | <br><br>
| |
| − | | |
| − | ==== Flujo completo del ciclo de datos ====
| |
| − | <br><br>
| |
| − | Siguiendo el proceso se contemplan los siguientes pasos:
| |
| − | <br><br>
| |
| − | '''Paso 1''' El usuario invoca el frontend residente en Apache desde un navegador, usando javascript, mediante la URL del tipo:<br>
| |
| − | https://host/Vivait-Supervisor/
| |
| − | El navegador carga la página web servida por Apache.
| |
| − | <br><br>
| |
| − | '''Paso 2''' Una vez superada la fase de [[#Seguridad de Vivait-Supervisor |validación]] se muestra [[#Descripción de la interfaz de VIVAit Supervisor 5.1 |la pantalla inicial]] que permite al usuario elegir el dashboard, previamente configurado, ejecutandose la monitorización de la consulta preparada.<br>
| |
| − | ::Tras elegir el dashboard deseado, la página web realiza solicitudes periódicas HTTP POST al endpoint correspondiente,<br>
| |
| − | ::donde se obtienen los datos de los componentes asociados al dashboard, por ejemplo:<br>
| |
| − | https://172.25.128.92/Vivait-Supervisor/tablas/TablaComponenteDinamicoAjax
| |
| − | ::siendo la carga util de esta solicitud la identificación del componente con los filtros elegidos por el usuario:<br>
| |
| − | {idCompoCuadro: "15",…}
| |
| − | filtros : [{tipo: "titulo", valor: "titulo=Detalle"}, {tipo: "fechaDesde", valor: "FechaDesde="},…]
| |
| − | idCompoCuadro: "15"
| |
| − | <br><br>
| |
| − | '''Paso 3''' Al recibir los datos el frontend hace una petición a la API REST de Tomcat.<br>
| |
| − | <br><br>
| |
| − | '''Paso 4''' La API se conecta a la base de datos, ejecuta las consultas necesarias y devuelve la respuesta.<br>
| |
| − | INFO TablaDinamicosDaoImpl:607 - componerSQL SELECT DATE_FORMAT(DAT_LLAMADAS.D_HORA_INICIO,'%Y-%m-%d'),DATE ...
| |
| − | <br><br>
| |
| − | '''Paso 5''' El frontend recibe el JSON con los datos de la consulta en la respuesta:<br>
| |
| − | POST https://172.25.128.92/Vivait-Supervisor/tablas/TablaComponenteDinamicoAjax
| |
| − | ::El navegador lo representa en pantalla. En ningún momento el navegador accede directamente a la base de datos; todo pasa por la API.
| |
| − | <br><br>
| |
| − | [[#Introducción a Vivait-Supervisor | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/VIVAit_Supervisor Volver al índice]
| |
| − | <br><br>
| |
| − | | |
| − | === Seguridad de Vivait-Supervisor ===
| |
| − | <br><br>
| |
| − | El acceso está controlado mediante validación de tokens.
| |
| − | <br><br>
| |
| − | '''Paso 1 Autenticación inicial'''
| |
| − | <br><br>
| |
| − | : • Al introducir sus credenciales el usuario se valida a través del servicio de autenticación ''sercen''<br>
| |
| − | https://172.25.128.252/sercen/postautenticar1
| |
| − | : • Sercen genera un token firmado que identifica la sesión del usuario.
| |
| − | <br><br>
| |
| − | '''Paso 2 Validación interna de permisos'''
| |
| − | <br><br>
| |
| − | : • Una vez que el frontend tiene el token, cada petición pasa por una validación de la API del tomcat:<br>
| |
| − | https://172.25.128.252/Tracker-Rest/tracker/verificarToken
| |
| − | :: En la misma se comprueba que:<br>
| |
| − | ::: - El token es válido.<br>
| |
| − | ::: - El usuario tiene permisos para el recurso que está intentando usar. <br>
| |
| − | ::: Es necesario que el usuario tenga acceso a la aplicación ''Grabador'', ver [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit_5.0#Submen.C3.BA_Permisos_a_usuarios Usuarios].<br>
| |
| − | : • No se ejecuta ninguna acción si el token no es validado primero.
| |
| − | <br><br>
| |
| − | '''Paso 3 Proxy inverso apache-tomcat'''
| |
| − | <br><br>
| |
| − | : • Apache actúa como punto de entrada único:
| |
| − | :: - El usuario solo ve URLs de apache.
| |
| − | :: - Las peticiones que requieren lógica del backend se redirigen internamente a tomcat.
| |
| − | :: - Esto se consigue mediante proxy inverso, por ejemplo:<br>
| |
| − | ::: /Tracker_Corporativo → servido por apache<br>
| |
| − | https://172.25.128.252/Tracker_Corporativo/
| |
| − | ::: /Tracker-Rest → Apache las pasa a Tomcat de forma transparente para el usuario<br>
| |
| − | https://172.25.128.252/Tracker-Rest/tracker/extensiones
| |
| − | : • El navegador utilizado por el usuario nunca ve a tomcat.
| |
| − | <br><br>
| |
| − | [[#Introducción a Vivait-Supervisor | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/VIVAit_Supervisor Volver al índice]
| |
| − | <br><br>
| |
