Manual Tecnico - SirhApp

El sistema sirhapp es una integración de muchas tecnologías conjugadas para la presentación

responsive de la información desde una aplicación WEB.

Para poder explicar para su comprensión la capa de Vista con PrimeFaces es necesario
dirigirse a la documentación de referencia sobre primefaces así como su uso e integración, ya
que describirlo en este documento no seria el caso puesto que llevaría cada elemento usado en
la aplicación simplemente la recaptura de dicha información.

Para poder explicar para su comprensión el Controlador de la aplicación es necesario referir la

Documentación relacionada con el ciclo de vida y el contexto del Framework JSF por lo que
describirlo aquí seria la receptora de dicha información, este sistema funciona en la capa de
controlador completamente con JSF.

Para poder explicar pasa su compresión la capa de Modelo es necesario referir la

documentación relacionada con JPA y el contexto entity manager, el sistema usa los aspectos
básicos de la implementación del JPA favor de revisar la documentación existente en Oracle y
Java sobre esta capa.

En general el sistema esta desarrollado bajo el patrón de diseño MVC, básicamente consiste
en la separación y autonomía de cada contexto para poder integrarlo de manera eficiente en un
ambiente web empresarial.

Modelo en el contexto de la aplicación es JPA y se refiere específicamente a las conexiones

con la BD de MySql y la Seguridad por JAAS

Vista en el contexto de la aplicación es PrimeFaces que junto con JSF forman la Vista que
presenta la información del sistema.

Controlador en el contexto de la aplicación es JSF y es el framework mayormente usado para

realizar la conexión de la capa del Modelo con la Vista

En la parte de los paquets de las clases se encuentra la siguiente lista de paquetes.

NOTA: El significado y funcionalidad de cada paquete es contextual por si miso el nombre

explica su funcionalidad favor de dirigirse a la documentación sobre Java para comprender la
terminologia.

• com.hrm.sirhapp
‣ ApplicationBean-(Bean que administra la aplicación)
‣ CalendarView-(Bean que administra los calendarios)
‣ ClavesDinamicasBean-(Bean que genera Claves dinamicas)
‣ FileUploadBean-(Bean que controla la carga de los archivos)
‣ HashBean-(Bean que crea valores HASH** Favor de acudir a la
documentación sobre Hashing)
‣ LocaleBean-(Bean que gestiona la internacionalización de la aplicacion)
‣ LocaleConverter-(Bean que gestiona la internacionalización de la aplicacion)
‣

Manual Tecnico - SirhApp Page 1 of 10

 ‣ LoginBean-(Bean que gestiona la autenticación o login)
‣ MailServiceBean-(Bean que gestiona el correo electrónico)
‣ ManagedBeans-(Bean que gestiona los ManagedBeans)
‣ MediaBean-(Bean que gestiona las imagenes)
‣ MenuView-(Bean que gestiona el Menu)
‣ PercentageMaskValidator-(Valida las mascaras de porcentaje en la Vista)
‣ RequestBean-(Bean que gestiona los RequestBeans)
‣ SelectOneMenuValidator-(Valida y gestiona el Menu** ver PrimeFaces)
‣ SelectOneMenuValidatorInt-(Valida y gestiona el Menu** ver PrimeFaces)
‣ UserProfileBean-(Bean que gestiona el Perfil del usuario)
‣ UserSessionBean-(Bean que gestiona el Perfil del las variables de Sesión)
• com.hrm.sirhapp.application
‣ ControlerServlet-(Es el controller del Servlet)
‣ LogoutServlet-(Realiza el logout del Servlet)
‣ MultiPageMessagesSupport-(Parte del controlador para poder gestionar el
soporte durante el ciclo de vida del JSF)
• com.hrm.sirhapp.application.exceptionhandler-(Administra los errores)
• com.hrm.sirhapp.backing-(Administra las operaciónes CRUD con el
EntityManager por favor referirse a la documentación del JPA)
• com.hrm.sirhapp.model-(Documentos creados de manera automatica por el JPA
para poder conectar la capa del Modelo con la BD MySql)
• com.hrm.sirhapp.security-(Revisar la documentación JAAS para saber la
operación de este paquete)
•
• com.hrm.sirhapp.security.jaas-(Revisar la documentación JAAS para saber la
operación de este paquete)
• com.hrm.sirhapp.service-(Efectua las operaciones CRUD hechas por la Vista y
aplica directamente a travez del EntityManager en la BD MySql)
•
• com.hrm.sirhapp.service.exception-(Control de Errores en el caso que el
EntityManager genere una excepción por ejemplo ya existe el registro o el
registro no fue encontrado como se puede ver en el sig Ejemplo:
๏ Apriv25AlreadyExists
๏ Apriv25Notfound)
•
• com.hrm.sirhapp.util-(Beans que son utilitarios para la Vista)

Lista de documentos en la capa publica de la vista

Indice Contenido Descripción Role

Acceder a la secured/login.xhtml Con seguridad después de Publico

Aplicación realizar autenticación con
usuario y clave el sistema
asigna un rol con el acceso

Manual Tecnico - SirhApp Page 2 of 10

Indice Contenido Descripción Role

Nuevo public/register.xhtml Pagina de Bienvenida Publico

Usuario

Enviar public/contactUs.xhtml Pagina de Graficas Publico

Mensaje
Registro de Publico

Aspirantes
Aviso de public/privacy.xhtml Captura Corta de Aspirantes Publico

Privacidad

Lista de documentos en la capa segura de la vista

Indice Contenido Descripción Role

Principal 123456678

secured/empty.xhtml Pagina de Bienvenida 123456678

secured/empty_2.xhtml Pagina de Graficas 123456678

Registro de 123456678
Aspirantes
secured/nuevoaspirante/ Captura Corta de Aspirantes 123456678
capturaCorta.xhtml
secured/nuevoaspirante/ Captura Larga de Aspirantes 123456678
capturaLarga.xhtml
Aspirante a secured/procesos/ Convertidor de Aspirantes 123456678
Trabajador findAspiranteTrabajador.xhtml
Actualiza secured/procesos/ Actualizador de Clave del 123456678
Clave de findActualizacionClaves.xhtml Trabajador
Trabajador
Actualiza secured/procesos/ Actualizador del RFC del 123456678
RFC de findActualizacionRfc.xhtml aspirante
Aspirante
Aspirante
123456678

Busqueda secured/aspirantes/find.xhtml Busqueda de Aspirantes 123456678

Datos secured/aspirantes/ Datos Generales del Aspirante

123456678
Generales datosGenerales.xhtml

Manual Tecnico - SirhApp Page 3 of 10

Indice Contenido Descripción Role

Datos secured/aspirantes/ Datos Personales del Aspirante

123456678
Personales datosPersonales.xhtml

Datos de secured/aspirantes/ Datos de Identidad del 123456678

Identidad datosIdentidad.xhtml Aspirante

Documenta secured/aspirantes/ Documentacion del Aspirante 123456678

cion documentacion.xhtml

Escolaridad secured/aspirantes/ Escolaridad del Aspirante 123456678

escolaridad.xhtml

Familiares
secured/aspirantes/ Familiares del Aspirante
123456678
familiares.xhtml

Experiencia secured/aspirantes/ Experiencia del Aspirante

123456678
experiencia.xhtml

Beneficiario secured/aspirantes/ Beneficiarios del Aspirante 123456678

s beneficiarios.xhtml

secured/aspirantes/ Requisitos del Aspirante 123456678

requisitos.xhtml

Trabajador
123456678

Busqueda secured/trabajadores/find.xhtml Busqueda de Aspirantes 123456678

Datos secured/trabajadores/ Datos Generales del Trabajador

123456678
Generales datosGenerales.xhtml
Datos secured/trabajadores/ Datos Personales del Trabajador
123456678
Personales datosPersonales.xhtml
Datos de secured/trabajadores/ Datos de Identidad del 123456678
Identidad datosIdentidad.xhtml Trabajador

Documenta secured/trabajadores/ Documentacion del Trabajador 123456678

cion documentacion.xhtml
Escolaridad secured/trabajadores/ Escolaridad del Trabajador 123456678
escolaridad.xhtml
Familiares
secured/trabajadores/ Familiares del Trabajador
123456678
familiares.xhtml
Experiencia secured/trabajadores/ Experiencia del Trabajador
123456678
experiencia.xhtml
Beneficiario secured/trabajadores/ Beneficiarios del Trabajador 123456678
s beneficiarios.xhtml

Manual Tecnico - SirhApp Page 4 of 10

Indice Contenido Descripción Role

Contratos
123456678

secured/contratos/find.xhtml Busqueda de Contratos 123456678

secured/contratos/ Vista de los datos del Contrato

123456678
contratoView.xhtml

Contratos- secured/contratos/aprivList.xhtml Lista de Ausencias

123456678
Todos

Contratos- 123456678
Abandonos

Contratos- 123456678
Faltas

Contratos- 123456678
Incapacidad
es

Contratos- 123456678
Retardos

Contratos- 123456678
Vacaciones

Premios y secured/contratos/pryprList.xhtml Lista de Premios y Prestaciones 123456678

Prestaciones

Premios y 123456678
Prestaciones
- Todos

Premios y 123456678
Prestaciones
- Premios

Premios y 123456678
Prestaciones
-
Prestaciones

Sanciones
secured/contratos/sanciList.xhtml Lista de Sanciones
123456678

Sanciones- 123456678
Todas

Sanciones- 123456678
Amonestacio
nes

Manual Tecnico - SirhApp Page 5 of 10

Indice Contenido Descripción Role

Inventarios
secured/inventarios/ Lista del Inventario 123456678
inventarioList.xhtml

Inventarios- secured/inventarios/
Entradas inventarioList.xhtml

Inventarios- secured/inventarios/ 123456678

Salidas inventarioList.xhtml

Inventarios- secured/inventarios/ 123456678

Existencias inventarioList.xhtml

Reportes
123456678

Kardex secured/kardex/ Kardex del aspirante 123456678

Aspirante findAspirantes.xhtml

Kardex secured/kardex/ Kardex del trabajador 123456678

Trabajador findTrabajadores.xhtml

Reportes secured/reportes/find.xhtml Generador Dinamico de 123456678

Reportes

Catalogos 123456678

Especialidad secured/catalogos/ Gestion de las especialidades 123456678

es especialidadesList.xhtml

Estados secured/catalogos/ Gestion de los estados civiles 123456678

Civiles estadoCivilList.xhtml

Generos secured/catalogos/sexoList.xhtml Gestion de los generos sexos 123456678

Nacionalidad secured/catalogos/ Gestion del catalogo de 123456678

es nacionalidadesList.xhtml nacionalidades

Niveles secured/catalogos/ Gestion de los niveles de 123456678

Estudio nivelesEstudioList.xhtml estudio

Proveedores secured/catalogos/ Gestion del catalogo de 123456678

proveedoresList.xhtml proveedores

Razones sin secured/catalogos/ Gestion de las razones sin 123456678

Documento causasSinDocumentoList.xhtml documento

Status secured/catalogos/ Gestion de los status del 123456678

Contratos statusContratoList.xhtml contrato
Status secured/catalogos/ Gestion de los status del 123456678
Trabajadores statusTrabajadoresList.xhtml trabajador

Tipos de secured/catalogos/ Gestion de las ausencias 123456678

Ausencias tiposAprivList.xhtml

Manual Tecnico - SirhApp Page 6 of 10

Indice Contenido Descripción Role

Tipos Casa/ secured/catalogos/ Gestion de la casa habitación 123456678

Habitacion tiposDomiciliosList.xhtml

Tipos secured/catalogos/ Gestion de los tipos de contrato 123456678

Contratos tiposContratosList.xhtml

Tipos secured/catalogos/ Gestion de los tipos de 123456678

Documentos tiposDocumentosList.xhtml documentos

Monedas secured/catalogos/ Gestion de los tipos de moneda 123456678

tiposMonedasList.xhtml

Tipos secured/catalogos/ Gestion de los tipos de 123456678

Parientes tiposParientesList.xhtml parientes

Religiones secured/catalogos/ Gestion del catalogo de 123456678

religionesList.xhtml religiones

Tipos Sangre secured/catalogos/ Gestion de los tipos de sangre 123456678

tiposSangreList.xhtml

Turnos/ secured/catalogos/ Gestion de los turnos 123456678

Tripulación turnosList.xhtml Tripulaciones

Ubicaciones secured/catalogos/ Gestion de la lista de 123456678

ubicacionesList.xhtml ubicaciones en base a la base
de correos de México

Catalogos 123456678
Especiales

Articulos secured/catalogos/ Gestion de la lista de Articulos 123456678

Inventario articulosInventariosList.xhtml de Inventario

Departament secured/catalogos/ Gestion de la lista de 123456678

os departamentosList.xhtml departamentos

Empresas/ secured/catalogos/ Gestion de la lista de empresas 123456678

Plantas empresasList.xhtml

Complejos secured/catalogos/ Gestion de la lista de sedes 123456678

sedesList.xhtml

Premios/ secured/catalogos/ Gestion de la lista de premios y 123456678

Prestaciones tiposPrypList.xhtml prestaciones

Tipos secured/catalogos/ Gestion de la lista de sanciones

123456678
Sanciones tiposSancionesList.xhtml

Catalogos 123456678
Confidencial
es

Categorias secured/catalogos/ Gestion e la lista de categorías 123456678

Trabajadores categoriasTrabajadoresList.xhtml de trabajadores

Manual Tecnico - SirhApp Page 7 of 10

Indice Contenido Descripción Role

Miembros secured/catalogos/ Gestion de la lista del comite

123456678
Comité miembrosComiteList.xhtml

Usuarios secured/catalogos/ Gestion de Usuarios 123456678

usuariosList.xhtml

Auditoria secured/auditoria/auditoria.xhtml Auditoria 123456678

Ayuda secured/ayuda.xhtml Ayuda del Sistema 123456678

Despliegue o instalación del SirhApp

Para instalar la aplicación es necesario solamente copiar el archivo war en la sig ruta

/usr/local/apache-tomee-plumee-7.1.0/webaps

El sistema esta pre-configurado para instalarse y ejecutarse automáticamente

Requerimientos
La instalion previa de:
La capa de Base de Datos
1. La instalación de la BD sirh de MySql
La capa de Front End
1. La instalación de la capa de FrontEnd con apache
La capa de File System
1. La Instalación de la capa de filesystem en la NAS
El correcto despliegue y configuración de las siguientes aplicaciones.
filesystem.war
lognavigatos.war

Adicionales: se anexa en archivo el template de primefaces ultima.war no es necesario

instalarlo, funcionara como ejemplo para obtener la lista de funcionalidad completa y disponible
del ambiente PrimeFaces.

Nota: Las capas ya se encuentran actualmente configuradas e instaladas en el ambiente. Si

requiere asistencia por favor contacte a un técnico que conozca lo siguiente:

Linux SUSE
Apache2 para fronting de TomEE
La operación de la NAS Synology
Linux
Java
J2EE
JPA
Java Server Faces
PrimeFaces
Comunicaciones
Networking
TCP/IP
Firewall
VMWare

Manual Tecnico - SirhApp Page 8 of 10

VNC
SSH
MySql
JAAS
WebServices
Hardening de Seguridad de la Información
Protección de Capas de Seguridad
Error Handling Advanced
Implementación de los aspectos elementales de la Seguridad de la Información.

Se hace mención de que muchos aspectos de la aplicación requieren acudir a su propio

manual para poder interpretarlos y así poder realizar ajustes en la aplicación como son:
JAAS
log4J
JavaMail
slf4J
Tomcat
TomEE
Java8
JSF 2.3
Ciclo de Vida del JSF 2.3
Primefaces 6.2
iTextPDF
OmniFaces
Java Enterprise Edition
Entity Manager de JPA
Internacionalizacion con Java
XHTML
CSS
HTML
XML
Maven
Netbeans

Documentos de referencia

https://www.novell.com/es-es/documentation/suse/pdfdoc/SuSE-Linux-
Adminguide-9.0.0.0x86.pdf

https://httpd.apache.org/docs/2.4/es/

https://global.download.synology.com/download/Document/UserGuide/DSM/3.1/
Syno_UsersGuide_NAServer_esn.pdf

https://gramatica.usc.es/~gamallo/aulas/lingcomputacional/biblio/manualLinux.pdf

ftp://soporte.uson.mx/PUBLICO/02_ING.SISTEMAS.DE.INFORMACION/PPI2/
Java%20Manual%20de%20Referencia,%207ma%20Edici%F3n%20-%20Herbert%20Schildt-
FREELIBROS.ORG.pdf

https://www.asturias.es/OpenFWPA/Versiones/2.0/fwpa-doc-desarrollo.pdf
https://www.fdi.ucm.es/profesor/jpavon/web/41-J2EE.pdf

Manual Tecnico - SirhApp Page 9 of 10

https://docs.oracle.com/javaee/6/tutorial/doc/gfirp.html

https://docs.oracle.com/en/database/oracle/oracle-database/18/jjdev/support-
java-8.html#GUID-6B31C8D9-0489-4E1F-9CDF-B9AF9E685D71

https://netbeans.org/kb/index.html

https://www.objectdb.com/java/jpa
https://www.tutorialspoint.com/es/jpa/index.htm

http://www.juntadeandalucia.es/servicios/madeja/contenido/recurso/130

https://www.primefaces.org/documentation/

http://www.serbi.ula.ve/serbiula/libros-electronicos/Libros/trasmisiondedatos/pdf/
librocompleto.pdf

https://www2.ulpgc.es/hege/almacen/download/44/44207/tema6sergio.pdf

Etc.

Manual Tecnico - SirhApp Page 10 of 10