Brief-57762- Manual- Arquitectura-Y- Soporte-fase1-HHPP Virtual para traslados- Aprobado 5 Nov PDF

Preview

Summary

taller de actividades para el desarrollo multimedia de aplicaciones sobre los front de cuentas matrices a su vez con el compromiso de crear servicios WEB...

Description

Claro Manual A&S – V.1 G0SS

MANUAL DE ARQUITECTURA Y SOPORTE Nombre Proyecto

HHPP Virtual Para Traslados – Fase 1

HISTORIAL DE VERSIONES FECHA

27/10/2021

03/10/2021

VERSIÓN

DESCRIPCIÓN

1

Versión inicial del documento

1.1

Ajustes sobre el documento

AUTOR Gildardo Mora Jimmy García

Gildardo Mora Jimmy García

EMPRESA

# FSP O INCIDENT E

SOAINT ORACLE

-

57762

SOAINT ORACLE

-

Nombre FSP o Incidente

57762

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

HLS

HLS BRIEF 57762 Idea 1786 HHPP Virt

HLS BRIEF 57762 Idea 1786 HHPP Virt

Página 1

Claro Manual A&S – V.1 G0SS

CONTENIDO 1.

OBJETIVO

3

2.

DIAGRAMA DE COMPONENTES

3

3.

ACTIVIDADES 3.1 DIAGRAMA DE ACTIVIDADES: Carga de Modulo “Marcaciones para Creación HHPP Virtual R1 y R2” 3.2 DIAGRAMA DE ACTIVIDADES: Realizar Marcaciones de “Aplica / No Aplica ” para las Razones - Subrazones.

4

DIAGRAMA DE SECUENCIA 4.1 DIAGRAMA DE SECUENCIA: Carga de Modulo “Marcaciones para Creación HHPP Virtual R1 y R2” 4.2 DIAGRAMA DE SECUENCIA: Realizar Marcaciones de “Aplica / No Aplica ” para las Razones -Subrazones.

7

5.

RESTRICCIÓN DEL SISTEMA

9

6.

SOPORTE 6.1 DOMINIOS 6.2 DESCRIPCIÓN TABLAS Y PROCEDIMIENTOS ALMACENADOS EN BASE DE DATOS 6.3 DESCRIPCIÓN DE LOS MÓDULOS A ENTREGAR 6.3.1 MER 6.4 ESPECIFICACIÓN TÉCNICA 6.5 NAVEGABILIDAD

9 9

4.

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

5 6

7 8

9 10 10 18 19

Página 2

Claro Manual A&S – V.1 G0SS

1. OBJETIVO Realizar modificaciones a nivel de front y backend en el aplicativo MER para tener vistas de configuración de códigos de marcaciones (Call log) que debe validar MER en RR en el proceso de la solicitud de creación de HHPPs virtual. 2. DIAGRAMA DE COMPONENTES

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 3

Claro Manual A&S – V.1 G0SS

Bitmap Image

Brief-57762-Diagra maComponentes.ea

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 4

Claro Manual A&S – V.1 G0SS

3. ACTIVIDADES De acuerdo a la historia de usuario HU1, se realizó la creación de la vista para Marcaciones HHPP Virtual ubicada en el front de MER en la ruta Menú Claro > Cuentas Matrices > Administración > Mantenimiento de Tablas > Marcaciones Creación HHPP Virtual R1 y R2, donde se contempla que el usuario pueda visualizar el parámetro Tiempo Mínimo Servicio a modo informativo, con una configuración inicial de 180 días, los campos Código R1, Descripción R1, Código R2, Descripción R2 forman la combinatoria de las marcaciones como razón y sub razón, así mismo se crean filtros para permitir la búsqueda por coincidencias de texto en éstos 4 campos, un último filtro se configuró para permitir la visualización de todas las Marcaciones habilitadas o deshabilitadas en el campo Aplica HHPP. Se creó un mecanismo que realiza la consulta en base de datos de la URL de un servicio del EAP y posteriormente se ejecuta un cliente REST desarrollado en el back con la URL obtenida, el servicio consulta las marcaciones existentes en el legado RR, luego ejecuta un mecanismo de comparación entre lo obtenido por el servicio desde RR y lo existente en la base de datos de MER, creando los registros nuevos inexistentes y activando o inactivando los registros antiguos según se reciban, éste mecanismo se activa cada vez que el usuario ingresa a la vista para garantizar que las marcaciones están actualizadas. En el momento actual, las marcaciones no están siendo filtradas por estado (ActivoInactivo) pero se espera que para la Fase 2 del proyecto, sólo sean recibidos desde RR los registros activos. Se creó un mecanismo de paginación para Marcaciones y Log Marcaciones que hace uso de los procedimientos almacenados en base de datos CMT_CONS_MARCACIONES_HHPP_SP, CMT_CONS_LOGS_MARC_HHPP_SP que filtra los resultados, exactamente 15 resultados por página como máximo. Luego de consultar y actualizar los datos desde RR a través del EAP, la vista presenta los primeros 15 registros, siendo los demás completamente accesibles desde la navegación de la paginación. Se creó el procedimiento interno de validación de selección del campo Aplica HHPP Virtual listarCambiosAplicaHHPP, para guardar solamente cambios efectivos en el valor original del campo, es decir, sólo se guarda el valor opuesto a la selección original del campo, sin importar cuántas veces el usuario haya cambiado el valor de selección antes de guardar el cambio. El guardado no se lleva a cabo hasta que el usuario acciona el botón Actualizar, con lo cual, se escribe un registro en la base de datos, se actualiza el

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 5

Claro Manual A&S – V.1 G0SS estado de Aplica-No Aplica en la tabla CMT_MARCACIONES_HHPP_VT y se escribe un registro de log en la tabla CMT_LOG_MARCACIONES_HHPP_VT para cada caso modificado. Se creó una segunda vista denominada Log Marcaciones HHPP, a la cual se accede desde cada registro a través del enlace Log del último campo de la fila de la tabla de datos. Ésta vista contiene los campos Usuario Modificación, Fecha Modificación, Valor Anterior y Valor Nuevo. Los registros en esta vista se cargan solamente cuando se han realizado modificaciones en el valor Aplica HHPP en la vista Marcaciones HHPP Virtual.

3.1 DIAGRAMA DE ACTIVIDADES: Carga de Modulo “Marcaciones para Creación HHPP Virtual R1 y R2”

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 6

Claro Manual A&S – V.1 G0SS

Bitmap Image

Brief-57762-Diagra maActividades.eapx

3.2 DIAGRAMA DE ACTIVIDADES: Realizar Marcaciones de “Aplica / No Aplica ” para las Razones - Subrazones.

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 7

Claro Manual A&S – V.1 G0SS

Bitmap Image

4. DIAGRAMA DE SECUENCIA 4.1 DIAGRAMA DE SECUENCIA: Carga de Modulo “Marcaciones para Creación HHPP Virtual R1 y R2”

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 8

Claro Manual A&S – V.1 G0SS

Bitmap Image

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 9

Claro Manual A&S – V.1 G0SS 4.2 DIAGRAMA DE SECUENCIA: Realizar Marcaciones de “Aplica / No Aplica ” para las Razones -Subrazones.

Bitmap Image

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 10

Claro Manual A&S – V.1 G0SS

5. RESTRICCIÓN DEL SISTEMA 

Se debe tener conexión hacia el aplicativo MER, las credenciales de acceso, y dirigirse al menu especifico para cada vista (PONER RUTA A LAS VISTAS****)



El servicio Rest del EAP, getMoveReasonsResource debe estar disponible.

6. SOPORTE 6.1DOMINIOS El dominio sobre el cual será desplegada la aplicación con los cambios será CO_Claro_IntCusOper_EAF_Domain_PR.con IP 172.24.232.23:10300

6.2DESCRIPCIÓN TABLAS Y PROCEDIMIENTOS ALMACENADOS EN BASE DE DATOS

Elemento

Descripción

CMT_CONS_MARCACIONES_HHPP_S P

SP Para consulta de Marcaciones totales o por filtro. SP Para consulta de Log de CMT_CONS_LOGS_MARC_HHPP_SP Marcaciones totales o por filtro. SP para inserción de Marcaciones. CMT_INS_MARCACIONES_HHPP_SP SP para inserción de Log Marcaciones. CMT_INS_LOGS_MARC_HHPP_SP SP para actualización de CMT_ACT_MARCACIONES_HHPP_SP Marcaciones. SP para consulta de parámetros MGL_CONSULTA_PARAMETRO_MER_ (Parámetro tiempo Mínimo Servicio, SP URL del servicio REST) CMT_MARCACIONES_HHPP_VT Tabla en DB para Marcaciones Tabla en DB para Log de CMT_LOG_MARCACIONES_HHPP_VT Marcaciones

6.3DESCRIPCIÓN DE LOS MÓDULOS A ENTREGAR

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 11

Claro Manual A&S – V.1 G0SS 6.3.1 MER Vista marcacionesCreaHHPPVirtualR1R2 de Marcación HHPP Virtual Desarrollo completo de la vista y sus métodos. Vista logMarcacionesCreaHHPPVirtualR1R2 de Marcación HHPP Virtual Desarrollo completo de la vista y sus métodos. Bean MarcacionesHhppVtMglBean Desarrollo completo del bean con sus métodos. Método: fillSqlList (void) Método llamado con anotación @PostConstruct, asigna valores a variables y Llama al método listInfoByPage(integer) Parámetro de Entrada: N/A Parámetro Salida: N/A

Método: listInfoByPage (integer page) Método encargado del llamado a la consulta de filtros para determinar cantidad de páginas y cantidad de registros para listarlos por página, la cual se recibe como parámetro. Parámetro de Entrada: int page Parámetro Salida: String vacío para recargar la vista.

Método: getTotalPaginas (int) Método para el conteo de la cantidad de páginas según resultados Parámetro de Entrada: N/A Parámetro Salida: N/A Método: actualizarMarcaciones (void)

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 12

Claro Manual A&S – V.1 G0SS Método que realiza la actualización del valor de Aplica – No Aplica HHPP, así como la creación del registro de Logs (pendiente independización del método). Parámetro de Entrada: N/A Parámetro Salida: N/A Método: listarCambiosAplicaHHPP (void) Método que valida cambios en la selección de Aplica HHPP. Parámetro de Entrada: N/A Parámetro Salida: N/A Método: consultarTiempoMinimoServicio (void) Método que realiza la consulta del parámetro asociado a Tiempo Minimo de Servicio. Parámetro de Entrada: N/A Parámetro Salida: N/A Método: sincronizarRazones (void) Método que realiza el proceso de sincronización entre los datos del servicio, y los datos de las marcaciones en MER. Parámetro de Entrada: N/A Parámetro Salida: N/A Bean LogMarcacionesHhppVtMglBean Método: fillSqlList (void) Método llamado con anotación @PostConstruct, asigna valores a variables y Llama al método listInfoByPage(integer) Parámetro de Entrada: N/A Parámetro Salida: N/A

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 13

Claro Manual A&S – V.1 G0SS

Método: listInfoByPage (integer page) Método encargado del llamado a la consulta de filtros para determinar cantidad de páginas y cantidad de registros para listarlos por página, la cual se recibe como parámetro. Parámetro de Entrada: int page Parámetro Salida: String vacío para recargar la vista.

Método: getTotalPaginas (int) Método para el conteo de la cantidad de páginas según resultados Parámetro de Entrada: N/A Parámetro Salida: N/A

Desarrollo completo del bean con sus métodos. Entidad CmtMarcacionesHhppVtMgl Clase de la entidad Marcaciones HHPP Virtual, con atributos correspondientes a la tabla CMT_MARCACIONES_HHPP_VT en base de datos. Entidad CmtLogMarcacionesHhppVtMgl Clase de la entidad Marcaciones HHPP Virtual, con atributos correspondientes a la tabla CMT_LOG_MARCACIONES_HHPP_VT T en base de datos. Manager CmtMarcacionesHhppVtMglManager Clase Manager del proceso Marcaciones HHPP Virtual Método: getTablasMarcacionesHhppVtSearch Método para el conteo de la cantidad de páginas según resultados Parámetro de Entrada: FiltroMarcacionesHhppVtDto filtro, boolean contar, int firstResult, int maxResults Parámetro Salida:

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 14

Claro Manual A&S – V.1 G0SS FiltroConsultaMarcacionesHhppVtDto filtroConsulta. Método: findTiempoMinimoServicio Método para consulta de parámetro en base de datos, asociado al Tiempo Minimo de Servicio. Parámetro de Entrada: N/A Parámetro Salida: String tiempoMinServicio . Método: sincronizarRazones Método Sincroniza las marcaciones en MER con las razones y subrazones del servicio rest. Parámetro de Entrada: FiltroMarcacionesHhppVtDto filtro, String usuario, int perfil Parámetro Salida: List Método: consultarMarcaciones Consulta las marcaciones para creacion de hhpp virtual Parámetro de Entrada: FiltroMarcacionesHhppVtDto filtro Parámetro Salida: N/A. Método: createMarcacionesHhppVt Método para creación de los registros de marcaciones actualizadas. Parámetro de Entrada: List marcacionesList, String usuario, int perfil Parámetro Salida: String retorno de llamado a método cmtMarcacionesHhppVtMglDaoImpl.createMarcacionesHhppVt Método: updateMarcacionesHhppVt Método para creación de los registros de marcaciones actualizadas. Parámetro de Entrada: List marcacionesList, String usuario, int perfil Parámetro Salida: String retorno de llamado a método cmtMarcacionesHhppVtMglDaoImpl.updateMarcacionesHhppVt

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 15

Claro Manual A&S – V.1 G0SS

Manager CmtLogMarcacionesHhppVtMglManager Clase del manager del proceso Log Marcaciones HHPP. Método: getTablasLogMcionesHhppVtSearch Método para la consulta de los registros de marcaciones. Parámetro de Entrada: FiltroLogMarcacionesHhppVtDto filtro, boolean contar, int firstResult, int maxResults Parámetro Salida: FiltroConsultaLogMarcacionesHhppVtDto filtroConsulta.

DTO CmtMarcacionesHhppVtDto Clase DTO con atributos para referenciar entidad Marcaciones HHPP Virtual. DTO CmtLogMarcacionesHhppVtDto Clase DTO con atributos para referenciar entidad Log Marcaciones HHPP Virtual. DTO Filtro FiltroMarcacionesHhppVtDto Clase DTO con atributos para referenciar entidad Filtro Marcaciones HHPP Virtual. DTO Filtro FiltroLogMarcacionesHhppVtDto Clase DTO con atributos para referenciar entidad Filtro Log Marcaciones HHPP Virtual. DTO Filtro Consulta FiltroConsultaMarcacionesHhppVtDto Clase DTO con atributos para referenciar entidad Filtro Consulta Marcaciones HHPP Virtual. DTO Filtro Consulta FiltroConsultaLogMarcacionesHhppVtDto Clase DTO con atributos para referenciar entidad Filtro Consulta Log Marcaciones HHPP Virtual. Facade CmtMarcacionesHhppVtMglFacade Clase facade con métodos de llamado a la clase Manager de Marcaciones HHPP. Facade Local CmtMarcacionesHhppVtMglFacadeLocal Interfaz facade con métodos de llamado a la clase Manager de Marcaciones HHPP. Facade CmtLogMarcacionesHhppVtMglFacade

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 16

Claro Manual A&S – V.1 G0SS Clase facade con métodos de llamado a la clase Manager de Log Marcaciones HHPP. Facade Local CmtLogMarcacionesHhppVtMglFacadeLocal Interfaz facade con métodos de llamado a la clase Manager de Log Marcaciones HHPP. DAO Implementation CmtMarcacionesHhppVtMglDaoImpl Clase de implementación DAO para el proceso Marcaciones HHPP Virtual Método: findTablasMarcacionesHhppVtSearch Método para la consulta de marcaciones. Parámetro de Entrada: FiltroMarcacionesHhppVtDto filtro, boolean contar, int firstResult, int maxResults Parámetro Salida: FiltroConsultaMarcacionesHhppVtDto filtroConsultaMarcacionesHhppVtDto según retorno de llamado al método findMarcacionesHhppVtDatos.

Método: findMarcacionesHhppVtDatos Método para listar los resultados de la consulta de marcaciones según filtro asignado desde la vista. Parámetro de Entrada: FiltroMarcacionesHhppVtDto filtro, int firstResult, int maxResult. Parámetro Salida: List marcacionesList según el resultado del llamado al método consultarMarcacionesHhppSp. Método: sincronizarRazones Método para sincronizar la información de las razones y subrazones desde el servicio hacia la tabla de marcaciones en MER. Parámetro de Entrada: FiltroMarcacionesHhppVtDto filtro, String usuario, int perfil. Parámetro Salida: List según validaciones de razones y subrazones completas o faltantes. Método: compararListasRazones Método para comparar los registros entre las 2 listas procesadas de marcaciones y razones.

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 17

Claro Manual A&S – V.1 G0SS Parámetro de Entrada: List listaA, List listaB, List listaRazones, String usuario, int perfil. Parámetro Salida: List. Método: consultarRazonesServicio Método para consultar las razones y subrazones que expone el servicio Rest GetMoveReasonsResourceRestClient. Parámetro de Entrada: N/A Parámetro Salida: List razonesList. Método: createMarcacionesHhppVt Método para preparar las marcaciones nuevas resultado de la sincronización con el servicio rest, para enviarlas al procedimiento almacenado. Parámetro de Entrada: List marcacionesList, String usuario, int perfil Parámetro Salida: String vacío. Método: updateMarcacionesHhppVt Método que prepara los registros de marcaciones para creación de hhpp virtual, para ser enviados al procedimiento almacenado. Parámetro de Entrada: List marcacionesList, String usuario, int perfil Parámetro Salida: String vacío. Método: findTiempoMinimoServicioSp Método que consulta el tiempo minimo del servicio, que corresponde al valor del acrónimo HHPP_VIRTUAL_TIEMPO_MIN_CUENTA de la tabla parámetros, ejecutando el procedimiento almacenado. Parámetro de Entrada: N/A Parámetro Salida: String result como resultado de la query.

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 18

Claro Manual A&S – V.1 G0SS Método: consultarMarcacionesHhppSp Método que consulta las marcaciones para creacion de hhpp virtual usando un procedimiento almacenado Parámetro de Entrada: FiltroMarcacionesHhppVtDto filtro Parámetro Salida: List marcacionesBdList . Método: registrarMarcacionesHhppSp Método que almacena los nuevos registros de marcaciones usando el procedimiento almacenado MGL_SCHEME.mig_insdata_sp. Parámetro de Entrada: List marcaciones, String usuario, int perfil Parámetro Salida: N/A. Método: actualizarMarcacionesHhppSp Método que realiza la actualizacion de los registros de marcaciones para creacion de hhpp virtual, a traaves del procedimiento almacenado MGL_SCHEME.mod_marcaciones_hhpp_sp. Parámetro de Entrada: List marcaciones, String usuario, int perfil Parámetro Salida: N/A. DAO Implementation CmtLogMarcacionesHhppVtMglDaoImpl Clase de implementación DAO para el proceso de Log Marcaciones HHPP Virtual Método: findTablasLogMarcacionesHhppVtSearch Método para la consulta de logs para una marcación específica. Parámetro de Entrada: FiltroLogMarcacionesHhppVtDto filtro, boolean contar, int firstResult, int maxResults Parámetro Salida: FiltroConsultaLogMarcacionesHhppVtDto filtroConsultaLogMarcacionesHhppVtDto como resultado de llamado al método findLogMarcacionesHhppVtSearchDatos. Método: findLogMarcacionesHhppVtSearchDatos Método para la búsqueda de logs para una marcación específica según el

Arquitectura y Soporte – Brief 57752 HHPP Virtual Para Traslados – Fase 1

Página 19

Claro Manual A&S – V.1 G0SS filtro asignado desde la vista. Parámetro de Entrada: FiltroLogMarcacionesHhppVtDto filtro, int firstResult, int maxResults Parámetro Salida: List logsMarcacionList según validaciones de resultados obtenidos del llamado al método consultarLogsMarcacionHhppSp. Método: consultarLogsMarcacionHhppSp Método para la búsqueda de logs para una marcación específica según resultados obtenidos del procedimiento almacenado en base de datos MGL_SCHEME.CONSULTA_LOGS_MARCACIONES_HHPP Parámetro de Entrada: FiltroLogMarcacionesHhppVtDto filtro Parámetro Salida: List logs...