Manual de Usuario Sistema para calcular reservas pensionales Adrián Otálora Neira Francisco Mora Calderón 06/12/2010 Revisión Histórica Fecha Septiembre 9 de 2010 Diciembre 6 de 2010 Versión Descripción 1.0 Especificación inicial del módulo de Seguridad 2.0 Especificación de Casos de Uso del sistema SisPen Autor Proyecto Maratón Adrián Otálora Francisco Mora – REVISIÓN HISTÓRICA ...................................................................................................................................... 2 DESCRIPCIÓN ...................................................................................................................................................... 4 1. CASOS DE USO ........................................................................................................................................... 4 1.1 1.2 1.3 CAMBIAR PASSWORD .................................................................................................................................. 4 LOGIN ......................................................................................................................................................... 4 GESTIÓN DE PERFILES ................................................................................................................................. 5 1.3.1 New profile ............................................................................................................ 5 1.3.2 Select ..................................................................................................................... 6 1.3.3 Delete ..................................................................................................................... 7 1.4 GESTIÓN DE USUARIOS ................................................................................................................................ 7 1.4.1 Select ..................................................................................................................... 7 1.4.2 Change Password ................................................................................................... 8 1.4.3 New User ............................................................................................................... 9 1.5 GESTIÓN DE MENUS .................................................................................................................................... 9 1.5.1 Select ..................................................................................................................... 9 1.5.2 Edit ...................................................................................................................... 10 1.5.3 Create menu ......................................................................................................... 10 1.6 PARÁMETROS ............................................................................................................................................ 10 1.6.1 Select ................................................................................................................... 11 1.6.2 Edit ...................................................................................................................... 11 1.6.3 Done .................................................................................................................... 11 1.6.4 Create Parameter.................................................................................................. 11 1.7 ESTRUCTURA ............................................................................................................................................ 11 1.7.1 Módulos ............................................................................................................... 12 1.7.2 Select ................................................................................................................... 12 1.7.3 Edit ...................................................................................................................... 12 1.7.4 Add use case / menu ............................................................................................ 13 1.7.5 Casos de uso ........................................................................................................ 13 1.7.6 Select ................................................................................................................... 13 1.7.7 Create use case..................................................................................................... 14 1.7.8 Edit ...................................................................................................................... 14 Copyright © 2004 CincoSOFT- All rights reserved Page 2 of 25 1.7.9 Servicios .............................................................................................................. 14 1.7.10 Select ................................................................................................................... 14 1.7.11 Edit ...................................................................................................................... 15 1.8 REPORTES SEGURIDAD ............................................................................................................................. 15 1.8.1 Reporte Perfiles Usuarios .................................................................................... 15 1.8.2 Reporte Usuarios Perfiles .................................................................................... 16 1.9 CONSULTAR ACCIONES DE USUARIO ......................................................................................................... 16 1.9.1 Consultar por acción ............................................................................................ 17 1.9.2 Consultar por usuario .......................................................................................... 17 1.9.3 Ver Auditorias ..................................................................................................... 17 1.10 GESTIÓN DE EMPRESAS .......................................................................................................................... 18 1.10.1 Crear empresa ...................................................................................................... 18 1.10.2 Edit ...................................................................................................................... 19 1.10.3 View .................................................................................................................... 19 1.11 CARGAR TABLAS DE CÁLCULOS ............................................................................................................. 20 1.11.1 Página Principal ................................................................................................... 20 1.11.2 Cargar tabla de Mujeres Inválidas ....................................................................... 20 1.11.3 Cargar Tabla de mujeres validas ......................................................................... 21 1.11.4 Cargar Tabla de hombres Inválidos ..................................................................... 21 1.11.5 Cargar Tabla de Hombres Validos ...................................................................... 22 1.11.6 Cargar Tabla de Salarios Mínimos ...................................................................... 22 1.11.7 Cargar Tabla de Parámetros ................................................................................ 22 1.12 1.13 CARGAR INFORMACIÓN AL SISTEMA ...................................................................................................... 23 REPORTES .............................................................................................................................................. 23 1.13.1 Reporte consolidado de empleado ....................................................................... 24 1.13.2 Reporte consolidado de empresa ......................................................................... 24 1.13.3 Reporte consolidado de todas las empresas ......................................................... 24 1.14 VER TABLAS DE CÁLCULOS .................................................................................................................... 25 Copyright © 2004 CincoSOFT- All rights reserved Page 3 of 25 DESCRIPCIÓN Este manual presenta los casos de uso del sistema SisPen incluyendo los del módulo de seguridad CincoSecority, además explica de manera breve para qué sirven y cómo deben ser usados. Los casos de uso descritos a continuación corresponden a los del usuario cuyos perfiles de seguridad le permitan acceder a todas los casos de uso y opciones del sistema (probar por ejemplo con el usuario sysadmin). 1. CASOS DE USO Todos los casos de uso mencionados a continuación se encuentran en el menú “Acciones de Seguridad”, “Alimentar Sistema” y “Reportes”. 1.1 CAMBIAR PASSWORD Esta opción permite cambiar la contraseña correspondiente a la cuenta de usuario. Para esto, se debe proporcionar la contraseña antigua y la nueva. El botón “change” guarda los cambios realizados, el botón “cancel” los descarta. 1.2 LOGIN Esta opción cierra la sesión de usuario y muestra la ventana de inicio de sesión donde se debe suministrar los datos de cuenta para iniciar sesión. Copyright © 2004 CincoSOFT- All rights reserved Page 4 of 25 1.3 GESTIÓN DE PERFILES Esta opción proporciona al administrador una lista con los perfiles de seguridad existentes; también da la opción de eliminarlos, agregar uno nuevo y modificar los permisos de los perfiles ya existentes. 1.3.1 NEW PROFILE Esta opción muestra el listado de perfiles existentes de nuevo, tiene un campo para especificar el nombre del nuevo perfil y permite escoger los permisos que este va a tener. Copyright © 2004 CincoSOFT- All rights reserved Page 5 of 25 1.3.2 SELECT Permite editar los permisos y nombre de un perfil ya existente, al igual que la opción anterior despliega el listado de perfiles. Esta muestra el nombre y los permisos que actualmente tiene el perfil seleccionado, y a su vez permite modificar todos estos datos. Copyright © 2004 CincoSOFT- All rights reserved Page 6 of 25 1.3.3 DELETE Muestra el listado de perfiles que pueden ser eliminados por el usuario con el botón “delete”. También brinda la opción de ir a la ventana de creación de perfiles con el botón “new profile” y de ver la información de un perfil con el botón “select”. 1.4 GESTIÓN DE USUARIOS Esta opción muestra un listado de los usuarios existentes. 1.4.1 SELECT Permite cambiar los datos del usuario seleccionado. También muestra dos listados en la parte baja de la ventana, donde permite cambiar su perfil seleccionando los perfiles del sistema. Copyright © 2004 CincoSOFT- All rights reserved Page 7 of 25 1.4.2 CHANGE PASSWORD Esta opción permite cambiar la contraseña de un usuario existente en el sistema. Copyright © 2004 CincoSOFT- All rights reserved Page 8 of 25 1.4.3 NEW USER Permite ingresar un nuevo usuario al sistema, se debe especificar nombre de usuario, el nombre real, los apellidos, el número de identificación, el tipo de documento, el correo, el tipo de usuario, la empresa asociada, la contraseña y verificar la contraseña. El botón “Update” guarda el nuevo usuario, el botón “Cancel” descarta su creación. 1.5 GESTIÓN DE MENUS Permite gestionar los menús del sistema, estos se pueden buscar dado su titulo, acción o icono luego oprimiendo el botón buscar. Más abajo se encuentra un listado de menús resultantes de la búsqueda realizada, si no se ha realizado la búsqueda se muestran todos los menus existentes. 1.5.1 SELECT Nos muestra la siguiente pantalla, donde se encuentran los datos del menú seleccionado. Copyright © 2004 CincoSOFT- All rights reserved Page 9 of 25 1.5.2 EDIT Permite editar el título, icono y acción del menú. Las pestañas de la parte baja permiten editar su módulo, menú padre, caso de uso y submenús. Con el botón “Save” se actualizan los datos del menú con los cambios hechos, con “Delete” se elimina el menú y con el botón “Done” se muestran los datos del menú en un modo no editable. 1.5.3 CREATE MENU Muestra una ventana para la edición de un menú nuevo, permite editar su titulo, icono, acción, módulo, menú padre, submenús y caso de uso. Con el botón “Save” se crea el nuevo menú, con el botón “Cancel” se descartan los cambios realizados. 1.6 PARÁMETROS Permite buscar parámetros por nombre, valor y descripción con el botón buscar. Debajo muestra un listado de parámetros, resultante de la búsqueda, si no se ha realizado la búsqueda, la lista muestra todos los parámetros existentes en el sistema. Copyright © 2004 CincoSOFT- All rights reserved Page 10 of 25 1.6.1 SELECT Muestra una ventana con los datos del parámetro. 1.6.2 EDIT Con este botón se puede editar el nombre, valor y descripción del parámetro. “Save” guarda los cambios realizados, “Delete” borra el parámetro del sistema y “Done” da por terminada la edición, luego muestra la página principal de parámetros. 1.6.3 DONE Muestra la página que contiene la búsqueda de parámetros y el listado de estos. 1.6.4 CREATE PARAMETER Muestra una ventana que permite ingresar los datos del nuevo parámetro, con “Save” se crea el parámetro, con “Cancel” se descarta la creación del parámetro y se muestra la página principal de parámetros. 1.7 ESTRUCTURA Permite definir que módulos, casos de uso y servicios posee el sistema. Copyright © 2004 CincoSOFT- All rights reserved Page 11 of 25 1.7.1 MÓDULOS Permite buscar módulos por nombre con el botón buscar. Debajo muestra un listado de módulos, resultante de la búsqueda, si no se ha realizado la búsqueda, la lista muestra todos los módulos existentes en el sistema. 1.7.2 SELECT Muestra una ventana con los casos de uso y menús asociados al modulo 1.7.3 EDIT Permite editar el nombre del modulo Copyright © 2004 CincoSOFT- All rights reserved Page 12 of 25 1.7.4 ADD USE CASE / MENU Cualquiera de estos dos, muestra una pantalla de creación de caso de uso / menú (según corresponda) y lo asocia automáticamente al módulo actual. 1.7.5 CASOS DE USO Permite buscar casos de uso por nombre o por el texto desplegado con el botón “Search”. Debajo muestra un listado de casos de uso, resultante de la búsqueda, si no se ha realizado la búsqueda, la lista muestra todos los casos de uso existentes en el sistema. 1.7.6 SELECT Muestra una ventana con los datos del caso de uso, con información de que servicios tiene y a que menús y módulo está asociado. Copyright © 2004 CincoSOFT- All rights reserved Page 13 of 25 1.7.7 CREATE USE CASE Muestra una pantalla para la creación de un caso de uso, permite asociar menús, servicios y módulos al mismo. 1.7.8 EDIT Permite cambiar el nombre del caso de uso 1.7.9 SERVICIOS Permite buscar servicios por nombre o por el texto de despliegue con el botón “Search”. Debajo muestra un listado de servicios, resultante de la búsqueda, si no se ha realizado la búsqueda, la lista muestra todos los servicios existentes en el sistema. 1.7.10 SELECT Muestra una ventana con los datos del servicio y a que caso de uso está asociado. Copyright © 2004 CincoSOFT- All rights reserved Page 14 of 25 1.7.11 EDIT Permite cambiar el nombre, el nombre a mostrar en los menús, y el caso de uso asociado al servicio. 1.8 REPORTES SEGURIDAD Permite mostrar reportes de usuarios y sus perfiles. 1.8.1 REPORTE PERFILES USUARIOS Copyright © 2004 CincoSOFT- All rights reserved Page 15 of 25 Muestra en una tabla los perfiles que existen, contra los usuarios que tienen estos perfiles asociados. 1.8.2 REPORTE USUARIOS PERFILES Muestra en una tabla los usuarios que existen, contra los perfiles que tienen estos asociados. 1.9 CONSULTAR ACCIONES DE USUARIO Permite llevar un registro de todas las acciones hechas por los usuarios cuando se hace alguna modificación a los datos del sistema. Las acciones de los usuarios se pueden consultar por acción o por usuario. Copyright © 2004 CincoSOFT- All rights reserved Page 16 of 25 1.9.1 CONSULTAR POR ACCIÓN Permite buscar las acciones sobre la base de datos por el tipo de acción realizada: crear, actualizar o eliminar. Luego muestra una lista con los resultados de la búsqueda, si no se ha buscado aún muestra todas las acciones. 1.9.2 CONSULTAR POR USUARIO Permite seleccionar el usuario para ver las acciones que éste ha hecho sobre la base de datos de la aplicación. 1.9.3 VER AUDITORIAS Permite ver las acciones del usuario asociado Copyright © 2004 CincoSOFT- All rights reserved Page 17 of 25 1.10 GESTIÓN DE EMPRESAS El objetivo del caso de uso es crear, obtener, actualizar o borrar una empresa del sistema a la cual se encuentran asociados un grupo de empleados. La página principal de este caso de uso permite buscar una empresa por nit, nombre o tipo de empresa, más abajo muestra el resultado de la búsqueda de empresas, si no se ha buscado ninguna empresa muestra todas las empresas. 1.10.1 CREAR EMPRESA Muestra una pantalla para la creación de una empresa, permite asociar usuario, y tablas de parámetros para cada una de las empresas ingresadas. Con el botón “Save” se guarda la empresa en la base de datos, y con el botón “Cancel” no se hace ningún cambio. Copyright © 2004 CincoSOFT- All rights reserved Page 18 of 25 En la página se muestra una ventana para la edición de una nueva empresa, permitiendo ingresar los datos con la información del nit, el nombre, y el tipo de la empresa. 1.10.2 EDIT Por medio del botón editar se puede modificar la información de una empresas que se encuentra registrada en el sistema, después de editados los campos se debe oprimir el botón “Save” para almacenar la información en la base de datos, “Delete” para borrar la empresa, o “Cancel” para deshacer los cambios realizados. Los datos que se pueden modificar son nit, nombre y tipo de empresa. 1.10.3 VIEW Al presionar el botón “View” el sistema muestra información no editable de la empresa y la lista de usuarios, empleados, registros archivo o tablas de esperanza de vida que se encuentran asociados a una empresa determinada. En esta nueva página si presionamos el botón “Edit” vamos a la página de edición de datos de la empresa y con el botón “Done” volvemos a la página principal del caso de uso. Copyright © 2004 CincoSOFT- All rights reserved Page 19 of 25 1.11 CARGAR TABLAS DE CÁLCULOS El objetivo del caso de uso es permitirle a un usuario registrar en el sistema toda la información correspondiente a salarios, parámetros y esperanzas de vida. Estos datos son necesario para calcular las reservas pensionales de la entidades. 1.11.1 PÁGINA PRINCIPAL La página principal de este caso de uso muestra seis botones, que sirven para cargar tablas de mujeres válidas, mujeres inválidas, hombres válidos, hombres inválidos, parámetros cálculos y salarios mínimos. 1.11.2 CARGAR TABLA DE MUJERES INVÁLIDAS Esta página permite la carga de archivos de esperanza de vida de mujeres inválidas. Para cargar un archivo es necesario conocer la ruta en donde está alojado en nuestra máquina. Luego de encontrar el archivo se debe presionar el botón “Cargar Archivo” el cual permite almacenar la información del archivo en el sistema. Adicionalmente el botón “Cargar Archivo” hace algunos cálculos después de almacenar la información. Después de cargar el archivo con éxito se muestran enlaces a archivos que nos muestran los registros que no se pudieron cargar, los que sí, y el archivo cargado. Con el botón “Volver” nos devolvemos a la página inicial del caso de uso. Copyright © 2004 CincoSOFT- All rights reserved Page 20 of 25 1.11.3 CARGAR TABLA DE MUJERES VALIDAS Esta página permite la carga de archivos de esperanza de vida de mujeres válidas. Para cargar un archivo es necesario conocer la ruta en donde está alojado en nuestra máquina. Luego de encontrar el archivo se debe presionar el botón “Cargar Archivo” el cual permite almacenar la información del archivo en el sistema. Adicionalmente el botón “Cargar Archivo” hace algunos cálculos después de almacenar la información. Después de cargar el archivo con éxito se muestran enlaces a archivos que nos muestran los registros que no se pudieron cargar, los que sí, y el archivo cargado. Con el botón “Volver” nos devolvemos a la página inicial del caso de uso. 1.11.4 CARGAR TABLA DE HOMBRES INVÁLIDOS Esta página permite la carga de archivos de esperanza de vida de hombres inválidos. Para cargar un archivo es necesario conocer la ruta en donde está alojado en nuestra máquina. Luego de encontrar el archivo se debe presionar el botón “Cargar Archivo” el cual permite almacenar la información del archivo en el sistema. Adicionalmente el botón “Cargar Archivo” hace algunos cálculos después de almacenar la información. Después de cargar el archivo con éxito se muestran enlaces a archivos que nos muestran los registros que no se pudieron cargar, los que sí, y el archivo cargado. Con el botón “Volver” nos devolvemos a la página inicial del caso de uso. Copyright © 2004 CincoSOFT- All rights reserved Page 21 of 25 1.11.5 CARGAR TABLA DE HOMBRES VALIDOS Esta página permite la carga de archivos de esperanza de vida de hombres válidos. Para cargar un archivo es necesario conocer la ruta en donde está alojado en nuestra máquina. Luego de encontrar el archivo se debe presionar el botón “Cargar Archivo” el cual permite almacenar la información del archivo en el sistema. Adicionalmente el botón “Cargar Archivo” hace algunos cálculos después de almacenar la información. Después de cargar el archivo con éxito se muestran enlaces a archivos que nos muestran los registros que no se pudieron cargar, los que sí, y el archivo cargado. Con el botón “Volver” nos devolvemos a la página inicial del caso de uso. 1.11.6 CARGAR TABLA DE SALARIOS MÍNIMOS Esta página permite la carga de archivos con información detallada del valor de los salarios mínimos para un año determinado. Para cargar un archivo es necesario conocer la ruta en donde está alojado en nuestra máquina. Luego de encontrar el archivo se debe presionar el botón “Cargar Archivo” el cual permite almacenar la información del archivo en el sistema. Después de cargar el archivo con éxito se muestran enlaces a archivos que nos muestran los registros que no se pudieron cargar, los que sí, y el archivo cargado. Con el botón “Volver” nos devolvemos a la página inicial del caso de uso. 1.11.7 CARGAR TABLA DE PARÁMETROS Esta página permite la carga de archivos con información detallada del valor del IPC y del interés para un año determinado. Para cargar un archivo es necesario conocer la ruta en donde está alojado en nuestra máquina. Luego de encontrar el archivo se debe presionar el botón “Cargar Archivo” el cual permite almacenar la información del archivo en el sistema. Después de cargar el archivo con éxito se muestran enlaces a archivos que nos muestran los registros que no se pudieron cargar, los que sí, y el archivo cargado. Con el botón “Volver” nos devolvemos a la página inicial del caso de uso. Copyright © 2004 CincoSOFT- All rights reserved Page 22 of 25 1.12 CARGAR INFORMACIÓN AL SISTEMA Esta página le permite a un usuario registrar en el sistema toda la información correspondiente a los empleados o afiliados de una empresa determinada para que el sistema pueda hacer los cálculos con dicha información. Para cargar un archivo es necesario conocer la ruta en donde está alojado en nuestra máquina. Luego de encontrar el archivo dando click en “Examinar” se debe dar una fecha de corte y después podemos presionar el botón “Cargar Archivo” el cual permite almacenar la información del archivo en el sistema. Adicionalmente el botón “Cargar Archivo” hace los cálculos de reserva pensional para cada empleado. Después de cargar el archivo con éxito salen tres botones que nos indican los errores en los registros del archivo cargado, los aciertos y el archivo cargado. 1.13 REPORTES El caso de uso Reportes permite ver al usuario tres tipos de reportes, consolidado de empleado, consolidado por empresa y consolidado de todas las empresas. Copyright © 2004 CincoSOFT- All rights reserved Page 23 of 25 1.13.1 REPORTE CONSOLIDADO DE EMPLEADO Para generar este reporte se solicita la fecha de corte que se da por medio de un calendario que aparece una vez damos click en el recuadro blanco, debajo de “Fecha de Corte”, luego se oprime el botón “Generar Reporte”, después de esta acción nos sale un enlace hacia el reporte, que está en formato pdf. 1.13.2 REPORTE CONSOLIDADO DE EMPRESA Para generar este reporte se solicita la fecha de corte que se da por medio de un calendario que aparece una vez damos click en el recuadro blanco, debajo de “Fecha de Corte”, luego se oprime el botón “Generar Reporte”, después de esta acción nos sale un enlace hacia el reporte, que está en formato pdf. 1.13.3 REPORTE CONSOLIDADO DE TODAS LAS EMPRESAS Para generar este reporte basta con dar click en el botón “Generar Reporte”, después de esto nos sale un enlace hacia el reporte, que está en formato pdf. Copyright © 2004 CincoSOFT- All rights reserved Page 24 of 25 1.14 VER TABLAS DE CÁLCULOS Permite ver la información de cada una de las tablas de parámetros que se encuentran almacenadas en el sistema y que son utilizadas para hacer los cálculos de los diferentes tipos de reservas. Cuando damos click en alguno de los botones de la página Ver tablas de cálculos, se muestra la lista de valores almacenados en el sistema en una nueva página. Copyright © 2004 CincoSOFT- All rights reserved Page 25 of 25