CU-300 Antecedentes del Caso de Uso Caso de Uso: Proyecto: Código de Proyecto: Nivel: Contexto: Actor Principal: Actores Asociados: Sistemas Externos: Intereses: Precondiciones: Resultado Esperado: Referencias: Riesgos: Control de Históricos GPNR IBERIA Aún no definido [ ] – Resumen/General [ ] – Usuario [X] – Sub Función Proceso que se encarga del control de la información histórica para Gestión PNR. Elimina los archivos PNR respaldados, realiza la eliminación de los registros del modelo control y elimina del modelo de negocio todos los registros asociados a PNR’s que han sido completamente volados y que tengan ‘n’ años de antigüedad. Este proceso será ejecutado de forma periódica. Schedule Operaciones N/A N/A Actor Fuera de Escena Intereses Área Revenue Management Usar esta información para cargar modelo de gestión propio. Se encuentran correctamente cargados los parámetros para ejecutar las reglas de control de históricos. Todos los registros de negocio que cumplen con las reglas de control de histórico son eliminados de la BD GPNR Todos los registros de control y recuperación que cumplen con las reglas de control de histórico son eliminados de la BD GPNR Todos los archivos de respaldo de los PNR files que cumplen con las reglas de control de histórico son eliminados CU200 – Control y monitoreo El proceso supera las 4 horas de ejecución, lo que significa que debería abortar para no afectar la malla de proceso Descripción de los Flujos Flujo Básico Descripción de Alto Nivel El Proceso de Control de Históricos se divide en cuatro etapas: Etapa I: Validación de Ambiente Etapa II: Control histórico PNR files Etapa III: Control histórico de Tablas de Procesos Etapa IV: Control histórico de Tablas de Negocio El proceso de control de histórico será ejecutado mensualmente. Estará monitoreado y será controlado ante caídas por el proceso de control y recuperación. Al finalizar el proceso de Control Históricos se generará un Informe de Cierre del proceso. Descripción Detallada (Paso a Paso) 1. El invocador [control M] gatilla la ejecución del proceso de control de Histórico. 2. El proceso registra punto de control, indicando inicio de proceso, Ver caso de uso CU200 – Control y Monitoreo, pasa como parámetro el “TipoCarga” con valor “CH”. 3. El proceso registra punto de control, indicando inicio de etapa. Ver caso de uso CU200 – Control Casos de Uso – Control de Históricos | Versión. 1.0 | 16-11-2015 Página 1 de 7 y Monitoreo. Etapa I: Validación de Ambiente 4. El proceso registra el punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 5. El Proceso recupera los parámetros de Conexión a la Base de datos de GPNR. 6. El Proceso valida que la Conexión a la Base de datos de GPNR esté disponible. 7. El proceso registra punto de control, indicando el término de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 8. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 9. El proceso recupera las variables de acceso al servidor de respaldo. 10. El proceso valida el acceso al servidor de respaldo. 11. El proceso registra punto de control, indicando el término de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 12. El proceso registra punto de control, indicando el término de la etapa. Ver caso de uso CU200 – Control y Monitoreo. 13. El proceso registra punto de control, indicando inicio de etapa. Ver caso de uso CU200 – Control y Monitoreo. Etapa II: Control histórico PNR files 14. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 15. El proceso recupera el parámetro de control de histórico de PNR files. 16. El proceso, con el parámetro recuperado en el paso anterior, realiza el cálculo de la fecha de eliminación, el resultado del cálculo será almacenado en una variable llamada Var1FechaEliminacion. Ver Ref001. 17. El proceso con la fecha de eliminación de archivos calculada y almacenada en la variable Var1FechaEliminacion, genera un archivo temporal que contiene el nombre de los archivos a eliminar. Ver Ref002. 18. El proceso cuenta el número de líneas del archivo generado en el paso anterior, para determinar la cantidad de archivos a borrar. 19. El proceso crea un archivo Log (nombre archivo: log_control_historico_yyyymmdd.dat, donde yyyymmdd es la fecha del día) con un parámetro contador igual a 0. 20. El proceso registra punto de control, indicando el término de la actividad, registrando la cantidad total de archivos que se deberán borrar. Ver caso de uso CU200 – Control y Monitoreo 21. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. El proceso ejecutará los pasos 22 al 25 hasta que lea todas las líneas del archivo temporal generado en el paso 17. 22. El proceso lee una línea del archivo temporal generado en el paso 17. 23. El proceso eliminará el archivo de respaldo de PNR files utilizando el nombre recuperado en el paso anterior. 24. El proceso elimina la línea leída en el paso 22 del archivo temporal. 25. El archivo agrega la línea leída en el paso 22 al log y aumenta contador en uno. 26. El proceso registra el punto de control, indicando el término de la actividad, registrando la cantidad total de archivos eliminados (contador). Ver caso de uso CU200 – Control y Monitoreo. 27. El proceso registra punto de control, indicando el término de la etapa. Ver caso de uso CU200 – Control y Monitoreo. Casos de Uso – Control de Históricos | Versión. 1.0 | 16-11-2015 Página 2 de 7 28. El proceso registra punto de control, indicando el inicio de la etapa. Ver caso de uso CU200 – Control y Monitoreo. Etapa III: Control histórico de Tablas de Procesos 29. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 30. El proceso recupera el parámetro de control de históricos para las tablas de procesos 31. El proceso, con el dato recuperado en el paso anterior, realiza el cálculo de la fecha de eliminación para las tablas de procesos y lo almacena en la variable Var2FechaEliminacion. Ver Ref003. 32. El proceso realiza la extracción del Id de proceso desde la tabla de Procesos del modelo de control cuando la fecha de término de proceso sea más antigua a Var2FechaEliminacion y se genera un archivo temporal que contiene el listado de lo ID de proceso a eliminar. 33. El proceso registra punto de control, indicando el término de la actividad, registrando la cantidad total de registros en el archivo de ID de proceso a eliminar. Ver caso de uso CU200 – Control y Monitoreo. 34. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 35. El proceso procede a eliminar todos los registros de la tabla de recuperaciones que crucen por ID de proceso con los datos del archivo generado en paso 32 36. El proceso procede a eliminar todos los registros de la tabla de recuperaciones cuya fecha fin (RCPN_FCH_FIN) sea más antigua que Var2FechaEliminacion. 37. El proceso registra punto de control, indicando el término de la actividad, registrando la cantidad total de registros eliminados de la tabla Recuperaciones. Ver caso de uso CU200 – Control y Monitoreo. 38. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 39. El proceso crea un archivo plano vacio, para guardar los ID de las etapas asociadas a los ID de proceso recuperados en el paso anterior. El proceso ejecutará los pasos 40 a 42 hasta que lea todas las líneas del archivo temporal generado en el paso 32. 40. El subproceso lee una línea del archivo generado en el paso 32. 41. El subproceso realiza la extracción de los Id de etapas desde la tabla de etapas del modelo de control de acuerdo al ID de proceso recuperado en la lectura del paso anterior. 42. El subproceso agrega los ID de las etapas recuperadas en el paso anterior al archivo temporal generado en el paso 40. 43. El proceso registra punto de control, indicando el término de la actividad, registrando la cantidad total de registros a eliminar en el archivo de ID de etapas. Ver caso de uso CU200 – Control y Monitoreo. 44. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 45. El proceso procede a eliminar todos los registros de la tabla de actividades que crucen por ID de etapa con los datos del archivo generado en paso 42 46. El proceso registra punto de control, indicando el término de la actividad, registrando la cantidad total de registros eliminados de la tabla de actividades. Ver caso de uso CU200 – Control y Monitoreo. 47. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 48. El proceso procede a eliminar todos los registros de la tabla de etapas que crucen por ID de etapa Casos de Uso – Control de Históricos | Versión. 1.0 | 16-11-2015 Página 3 de 7 con los datos del archivo generado en paso 42 49. El proceso registra punto de control, indicando el término de la actividad, registrando la cantidad total de registros eliminados de la tabla etapas. Ver caso de uso CU200 – Control y Monitoreo. 50. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 51. El proceso procede a eliminar todos los registros de la tabla de procesos que crucen por ID de proceso con los datos del archivo generado en paso 32 52. El proceso registra punto de control, indicando el término de la actividad, registrando la cantidad total de registros que se eliminaron de la tabla procesos. Ver caso de uso CU200 – Control y Monitoreo. 53. El proceso registra punto de control, indicando el término de la etapa. Ver caso de uso CU200 – Control y Monitoreo. 54. El proceso registra punto de control, indicando el inicio de la etapa. Ver caso de uso CU200 – Control y Monitoreo Etapa IV: Control histórico de Tablas de Negocio 55. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 56. El proceso recupera el parámetro de control de histórico de datos de negocio. 57. El proceso, con el parámetro recuperado en el paso anterior, realiza el cálculo de la fecha de eliminación, el resultado del cálculo será almacenado en una variable llamada Var3FechaEliminacion. Ver Ref004. 58. El proceso realiza la extracción de todos los PNR´s (record locator + fecha de creación) desde la tabla Reservas_Segmentos seleccionando aquellos registros donde la fecha de vuelo (rssg_fch_vuelo) sea más antigua a Var3FechaEliminacion, generando como salida un archivo temporal llamado Pnr_a_Borrar_Tmp con el listado de PNR’s (record locator + fecha de creación). 59. El proceso registra punto de control, indicando el término de la actividad, registrando la cantidad total de registros a eliminar en el archivo Pnr_a_Borrar_Tmp. Ver caso de uso CU200 – Control y Monitoreo. 60. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 61. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 62. El proceso realiza el cruce por PNR (record locator + fecha de creación) entre los PNR’s del archivo Pnr_a_Borrar_Tmp y la tabla Tickets. 63. El proceso procede a eliminar todos los registros de la tabla Tickets identificados en el paso anterior. 64. El proceso registra punto de control, indicando el término de la actividad, registrando la cantidad total de registros eliminados de la tabla Tickets. Ver caso de uso CU200 – Control y Monitoreo. 65. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 66. El proceso realiza el cruce por PNR (record locator + fecha de creación) entre los PNR’s del archivo Pnr_a_Borrar_Tmp y la tabla Reservas_Pax y rescata los pax_seq_cdg de la tabla Reservas_Pax . 67. El proceso realiza el cruce por pax_seq_cdg entre los registros identificados en el paso anterior y la tabla Pax, para identificar los registros de Pasajeros a eliminar. 68. El proceso procede a eliminar de la tabla Pax todos los registros identificados en el paso anterior. 69. El proceso registra punto de control, indicando el término de la actividad, registrando la cantidad total de registros eliminados de la tabla Pax. Ver caso de uso CU200 – Control y Monitoreo. Casos de Uso – Control de Históricos | Versión. 1.0 | 16-11-2015 Página 4 de 7 70. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 71. El proceso realiza el cruce por PNR (record locator + fecha de creación) entre los PNR’s del archivo Pnr_a_Borrar_Tmp y la tabla Reservas_Pax para identificar la relación pasajeros por reserva. 72. El proceso procede a eliminar de la tabla Reservas_Pax todos los registros identificados en el paso anterior. 73. El proceso registra punto de control, indicando el término de la actividad, registrando la cantidad total de registros eliminados de la tabla Reservas_Pax. Ver caso de uso CU200 – Control y Monitoreo. 74. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 75. El proceso realiza el cruce por PNR (record locator + fecha de creación) entre los PNR’s del archivo Pnr_a_Borrar_Tmp y la tabla Reservas. 76. El proceso procede a eliminar todos los registros de la tabla Reservas identificados en el paso anterior. 77. El proceso registra punto de control, indicando el término de la actividad, registrando la cantidad total de registros eliminados de la tabla Reservas. Ver caso de uso CU200 – Control y Monitoreo. 78. El proceso registra punto de control, indicando el inicio de la actividad. Ver caso de uso CU200 – Control y Monitoreo. 79. El proceso realiza el cruce por PNR (record locator + fecha de creación) entre los PNR’s del archivo Pnr_a_Borrar_Tmp y la tabla Reservas_segmentos. 80. El proceso procede a eliminar todos los registros de la tabla Reservas identificados en el paso anterior. 81. El proceso registra punto de control, indicando el término de la actividad, registrando la cantidad total de registros eliminados de la tabla Reservas_segmentos. Ver caso de uso CU200 – Control y Monitoreo. 82. El proceso registra punto de control, indicando el término de la etapa. Ver caso de uso CU200 – Control y Monitoreo. Una vez finalizada la ejecución de las etapas definidas anteriormente se deben realizar los siguientes pasos 83. El proceso registra punto de control, indicando el término del proceso. Ver caso de uso CU200 – Control y Monitoreo 84. El proceso genera los informes de cierre de control de histórico. Ver Ref008. 85. Se notificará del término del proceso por mail a los entes definidos en un parámetros “destinatarios mail fin proceso”. 86. Fin del caso de uso Flujos Alternativos NO existe Conexión a la BD de GPNR (Teradata) NO existe Conexión a la carpeta de respaldo de PNR files [ X ] Excepción [ ] Validación [ ] Búsqueda [ ] CRUD [ ] Otro [ X ] Excepción [ ] Validación [ ] Búsqueda [ ] CRUD [ ] Otro Descripción de Alto Nivel El Proceso NO tiene conexión a la Base de GPNR Descripción Detallada (Paso a Paso) 1. El subproceso NO logra acceder a la base de datos. 2. El proceso de Carga diaria finaliza con error. Ver caso de uso CU200 – Control y Monitoreo. 3. Fin del caso de uso Descripción de Alto Nivel El Proceso NO tiene acceso al servidor o no tiene permisos de acceso a la carpeta de respaldo de los PNR files. Descripción Detallada (Paso a Paso) Casos de Uso – Control de Históricos | Versión. 1.0 | 16-11-2015 Página 5 de 7 1. 2. NO Hay Espacio en FileSystem. [ X] Excepción [ ] Validación [ ] Búsqueda [ ] CRUD [ ] Otro El Proceso termina con Problemas distintos a las excepciones anteriores. [ X] Excepción [ ] Validación [ ] Búsqueda [ ] CRUD [ ] Otro El subproceso NO logra acceder a la carpeta El proceso de Carga diaria finaliza con error. Ver caso de uso CU200 – Control y Monitoreo. 3. Fin del caso de uso Descripción de Alto Nivel El Proceso detecta que NO tiene espacio en el FileSystem asignado a Sistema en el Servidor DataStage para almacenar los datos. Descripción Detallada (Paso a Paso) 1. El Proceso NO encuentra espacio en el FileSystem de DataStage para almacenar la información. 2. El proceso de Carga diaria finaliza con error. Ver caso de uso CU200 – Control y Monitoreo. 3. Fin del caso de uso Descripción de Alto Nivel El Proceso de control de histórico termina con Problemas. Descripción Detallada (Paso a Paso) 1. El Proceso termina con Problemas. 2. El proceso de Carga diaria finaliza con error. Ver caso de uso CU200 – Control y Monitoreo. 3. Fin del caso de uso Información Complementaria Comentarios y aspectos no resueltos En caso que el volumen de datos a eliminar excedan los recursos maquinas o tiempo disponibles, lo que se sugiere es ajustar los parámetros de control de históricos a valores que disminuyan los volúmenes de datos a eliminar. Resumen tablas de GPNR afectadas por control de históricos: *Tablas de Control y Recuperación: Procesos, Recuperaciones, Etapas y Actividades. ** Tablas de negocio: Reservas, Reservas_Segmentos, Reservas_Pax, Pax, Tickets. Se dispondrá de 4 respaldos completos de la BD de gestión PNR, realizado una vez al año, durante los últimos 4 años. Con esto aumenta la capacidad de disponer de datos de negocios para instancias excepcionales. Implementación Ref 001: Cálculo Fecha de Eliminación Archivos El parámetro de control de histórico indica cuantos días de antigüedad deben tener los archivos respaldados. se define como 180 días (6 meses). El Proceso calcula la fecha de eliminación a partir de la fecha actual, en donde Var1FechaEliminacion = fecha actual – parámetro control históricos PNR files. Ref 002: Lectura de Archivos. Los archivos de respaldo tendrán el siguiente formato GPNR_YYYYMMDD.zip, se accede al directorio de respaldo y se listan todos los archivos del directorio en un texto plano, se parsea cada fila del archivo texto plano por “_” y “.”, se revisa fila por fila y se dejan en el archivo las filas que cumplan con YYYYMMDD < Var1FechaEliminacion (“<” significa más antigua), las demás se eliminan de la lista. se vuelve a armar cada fila del archivo con el nombre del archivo en formato GPNR_YYYYMMDD.zip Casos de Uso – Control de Históricos | Versión. 1.0 | 16-11-2015 Página 6 de 7 Ref 003: Cálculo Fecha de Eliminación Tablas Procesos El parámetro de control de histórico indica cuantos días de antigüedad deben tener los registros de control. Se define como 730 días (2 años, 365x2). El Proceso calcula la fecha de eliminación a partir de la fecha actual, en donde Var2FechaEliminacion = fecha actual – parámetro control históricos tabla de procesos. Ref 004: Cálculo Fecha de Eliminación Tablas de negocio El parámetro de control de histórico indica cuantos días de antigüedad deben tener los registros de negocio. Se define como 1825 días (5años, 365x5). El Proceso calcula la fecha de eliminación a partir de la fecha actual, en donde Var3FechaEliminacion = fecha actual – parámetro control históricos datos de negocio. Ref 005: Generación Informe de Cierre. El informe de cierre contiene la siguiente información que será enviada por mail: o Nombre Proceso o Fecha inicio Proceso o Fecha fin Proceso o Eliminación de archivos de respaldo PNR files Cantidad de archivos de respaldo eliminados o Eliminación de Registros del Modelo de Control Cantidad de Registros eliminados desde tabla de Procesos Cantidad de Registros eliminados desde tabla de Recuperaciones Cantidad de Registros eliminados desde tabla de Etapas Cantidad de Registros eliminados desde tabla de Actividades o Eliminación de Registros del Modelo de Negocio Cantidad de Registros eliminados desde tabla de Reservas_Segmentos Cantidad de Registros eliminados desde tabla de Reservas_Pax Cantidad de Registros eliminados desde tabla de Reservas Cantidad de Registros eliminados desde tabla de Pax Cantidad de Registros eliminados desde tabla de Tickets Fecha Revisión [Fecha de la última revisión.] [# de revisión.] Registro de Cambios del Caso de Uso Descripción Autor Fuente [Modificación realizada.] [Nombre del autor del documento.] Casos de Uso – Control de Históricos | Versión. 1.0 | 16-11-2015 [Contraparte del cliente que otorgo la definición.] Aprobación [Contraparte del cliente que aprobó la definición.] Página 7 de 7