|
|
| (No se muestran 33 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>
| |
| − | Los conceptos utilizados en el supervisor son los siguientes:
| |
| − | : • '''Dashboard''': panel de control que muestra de forma visual y resumida información clave (datos, indicadores o métricas)<br>
| |
| − | ::para supervisar, analizar y tomar decisiones de manera rápida.<br>
| |
| − | ::El dashboard contiene componentes.
| |
| − | : • '''Componente''': cada pieza o elemento que aparece en el panel y que sirve para mostrar la información deseada.<br>
| |
| − | ::Los componentes pueden ser tablas o gráficos.
| |
| − | ::- '''''Tablas''''': la información se muestra en formato de tabla, las cabeceras se definen al crear la lógica de la tabla.<br>
| |
| − | ::- '''''Gráficos''''': los datos se muestra en formato gráfico. Existen diferentes formatos de gráficos disponibles: barras, <br>
| |
| − | ::Sobre como los componentes actualizan la información se pueden clasificar en:
| |
| − | :::- ''Dinámicos'': la información de este componentes se actualiza periodicamnte,, según un temporizador asociado al componente.
| |
| − | :::- ''Estáticos'': la información se muestra cuando se lanza el dashboard y ya no se actualiza más hasta que no se vuelve a invocar el panel de control.
| |
| − | <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>
| |
