secretaría de estado de telecomunicaciones y para la ... · pestaña correspondiente. definir las...
TRANSCRIPT
Secretaria de Estado de Telecomunicacionesy para la Sociedad de la Información
Secretaría de Estado de Telecomunicaciones y para la Sociedad de la Información
(S.E.T.S.I.)
Manual de Implantación y Configuración
Número de expediente: 0200728
SGM_2007_10_Manual de Implantación y Configuración v01 Página 1 de 125
“SISTEMA INTEGRADO DE GESTIÓN MUNICIPAL”
Control del documento
Participantes del Grupo de Trabajo que coordina el documento
Entidad Nombre / función
MITyC Ministerio de Industria Turismo y Comercio / Organismo promotor SIGEM
FEMP Federación Española de Municipios y Provincias/ Organismo promotor SIGEM
MAP Ministerio para las Administraciones Públicas/ Organismo promotor SIGEM
Iecisa Empresa colaboradora del proyecto SIGEM
Reuniones del Grupo de Trabajo que coordina el documento
Fecha Documento / Acta de la reunión
Elaboración
Responsabilidad Nombre / función
Desarrollado por: Grupo de Trabajo
Revisado por:
Aprobado por:
Control de versiones
Versión Fecha aprobación Cambio producido
01 05-10-2007 Versión inicial
SGM_2007_10_Manual de Implantación y Configuración v01 Página 2 de 125
ÍNDICE1 OBJETO ........................................................................................................ 5
1.1 DOCUMENTOS RELACIONADOS ................................................................................ 5
2 DEFINICIÓN DE ARQUITECTURA .................................................................. 6
2.1 DIAGRAMA DE DESPLIEGUE ................................................................................... 6
3 MÓDULO NODO SERVIDOR DE APLICACIONES ............................................. 7
3.1 INSTALACIÓN DEL SISTEMA OPERATIVO ...................................................................... 7 3.1.1 Consideraciones previas ......................................................................... 7 3.1.2 Sistema operativo Linux ......................................................................... 7 3.1.3 Preparación del sistema e instalación de Linux ......................................... 7 3.1.4 Consideraciones sobre Intel y AMD ......................................................... 8 3.1.5 Instalando Linux .................................................................................. 8 3.1.6 Selección de zona horaria ...................................................................... 8 3.1.7 Selección de escritorio ........................................................................... 8 3.1.8 Configuración de la instalación ................................................................ 9 3.1.9 Instalación de paquetes ......................................................................... 9 3.1.10 Configuración de la red ...................................................................... 11 3.1.11 Actualización en línea ......................................................................... 12 3.1.12 Añadir usuarios ................................................................................. 12
3.2 SOFTWARE BASE ........................................................................................... 13 3.2.1 Instalación de Java JDK 1.4.2_14 .......................................................... 13
3.3 INSTALACIÓN DE TOMCAT ............................................................................... 13 3.4 INSTALACIÓN Y CONFIGURACIÓN DE OPEN OFFICE ......................................................... 13 3.5 INSTALACIÓN REPOSITORIO ................................................................................. 13 3.6 INSTALACIÓN SERVIDOR APLICACIONES ...................................................................... 14 3.7 CONFIGURACIONES ......................................................................................... 14
3.7.1 Servicio combinación local .................................................................... 14 3.7.2 Servicio combinación remoto ................................................................ 15
3.8 SERVIDOR DE APLICACIONES (FRAMEWORK PARA SIGEM) ................................................ 15 3.9 REPOSITORIO DE COMBINACIÓN. ........................................................................... 15 3.10 VARIOS SERVICIOS DE COMBINACIÓN REMOTOS ........................................................... 16 3.11 APLICACIONES SIGEM .................................................................................. 16 3.12 CONSOLIDACIÓN .......................................................................................... 16
3.12.1 Instalación. ....................................................................................... 17 3.12.2 Configuración .................................................................................... 17 3.12.3 Ejecución del proceso ......................................................................... 17 3.12.4 Planificación de la ejecución del proceso ............................................... 17
4 MÓDULO NODO SERVIDOR DE BASES DE DATOS ........................................ 19
4.1 GESTOR DE BASE DE DATOS. POSTGRES ................................................................... 19 4.1.1 Instalación postgres Linux .................................................................... 19 Iniciar y parar la base de datos .................................................................... 19 4.1.2 Instalación postgres en Windows ........................................................... 20
5 MÓDULO APLICACIONES SIGEM ................................................................. 27
5.1 APLICACIÓN DE REGISTRO ................................................................................ 27 5.1.1 Componentes software ......................................................................... 27 5.1.2 Configuración con BB.DD ...................................................................... 27
SGM_2007_10_Manual de Implantación y Configuración v01 Página 3 de 125
5.1.3 Log de Aplicación ................................................................................ 28 5.1.4 Instalación del cliente Windows ............................................................. 28 5.1.5 Inicialización del sistema de Registro ..................................................... 31 5.1.6 Configuración del sistema de Registro .................................................... 32 5.1.7 Configuración del servidor de impresión de imágenes .............................. 33 5.1.8 Otras configuraciones .......................................................................... 34
5.2 GESTIÓN DE EXPEDIENTES ................................................................................. 36 5.2.1 Requisitos del Sistema ......................................................................... 36 5.2.2 Entornos de bases de datos .................................................................. 37 5.2.3 Configuración del Gestor Documental ..................................................... 38 5.2.4 Configuración del servidor de aplicaciones (Tomcat) ................................ 39 5.2.1 Despliegue y ejecución de las aplicaciones web ....................................... 48 5.2.2 Acceso a las aplicaciones ...................................................................... 49
5.3 ARCHIVO ................................................................................................... 50 5.3.1 Creación de Base de Datos ................................................................... 50 5.3.2 Adaptación del producto ....................................................................... 53
5.4 CONSULTA WEB DE EXPEDIENTES .......................................................................... 95 5.4.1 El fichero WAR .................................................................................... 95 5.4.2 El despliegue ...................................................................................... 95 5.4.2 Software necesario .............................................................................. 97 5.4.3 Dependencias ................................................................................... 102
5.5 REGISTRO TELEMÁTICO ................................................................................... 103 5.5.2 Descripción del sistema de Registro Telemático ..................................... 103 5.5.3 Instalación del software ...................................................................... 104 5.4.3 Procedimiento de implantación ............................................................ 110 5.4.4 Módulos de la aplicación ..................................................................... 111
5.5 NOTIFICACIÓN TELEMÁTICA ............................................................................... 112 5.5.1 Descripción del sistema de Notificación ................................................ 112 5.5.2 Instalación del software ...................................................................... 113 5.5.3 Base de datos. Entidades necesarias .................................................... 116 5.5.4 Servidor de aplicaciones ..................................................................... 119
5.6 PAGO ELECTRÓNICO ...................................................................................... 121 5.6.1 Descripción del sistema de Pago Electrónico .......................................... 121 5.6.2 Instalación del software ...................................................................... 122 5.6.3 Configuración .................................................................................... 124
SGM_2007_10_Manual de Implantación y Configuración v01 Página 4 de 125
Avanza LOCAL SIGEM
1 Objeto
Este documento tiene por objeto detallar los procesos de implantación y configuración del “SISTEMA INTEGRADO DE GESTIÓN MUNICIPAL”, SIGEM.
Es un documento para administradores de sistemas y técnicos de informática de un Ayuntamiento o Diputación.
1.1Documentos relacionados
• SGM_2006_11_Definición de la Arquitectura del Sistema• SGM_2007_10_Manual de Administración y Configuración de Servicios• SGM_2007_10_Descripción y código Servicios Web SIGEM
SGM_2007_10_Manual de Implantación y Configuración v01 Página 5 de 125
Avanza LOCAL SIGEM
2 Definición de Arquitectura
La arquitectura básica del sistema SIGEM contemplaría el siguiente diagrama de despliegue:
2.1Diagrama de despliegue
- Módulo Nodo Servidor de Aplicaciones: máquina sobre la que se ejecuta el servidor de aplicaciones en el que se despliega SIGEM. También incluye el proceso automatizado de consolidación RT-Registro y N instancias de Open Office corriendo como procesos.
- Módulo Nodo Servidor de BB.DD: máquina sobre la que se ejecuta el sistema gestor de bases de datos de SIGEM. También sirve como repositorio documental.
- Módulo Aplicaciones SIGEM: Conjunto de aplicaciones que componen el sistema SIGEM.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 6 de 125
Avanza LOCAL SIGEM
3 Módulo Nodo Servidor de Aplicaciones
Este módulo se puede estructurar en tres partes bien diferenciadas:
- Instalación S.O- software base- Aplicaciones SIGEM
3.1Instalación del Sistema Operativo
3.1.1 Consideraciones previas
Este manual refleja el proceso de instalación adecuado para instalar el software @Firma sobre un sistema Linux, concretamente sobre OpenSUSE 10.2. Si se utiliza otra versión de Linux distinta a OpenSUSE, es posible que algunas de las características que se reflejan en este manual, se deban hacer de otra forma.Este manual asume que el usuario que realizará la instalación, ya conoce, al menos de forma básica, el funcionamiento de Linux y demás filosofías propias del mundo Unix, incluidos permisos, sistema de ficheros, etc.
3.1.2 Sistema operativo Linux
Como distribución Linux se ha escogido OpenSuse 10.2. Si se opta por otra distribución Linux ahora o en el futuro, será necesario realizar las pruebas necesarias para asegurar que tanto el sistema operativo como el software de aplicación funcionan adecuadamente, documentando las posibles diferencias que pueda haber en la instalación y configuración del software.
3.1.3 Preparación del sistema e instalación de Linux
El servidor donde se instale Linux y todo el software que conforma el proyecto SIGEN, debe tener como mínimo las siguientes características hardware.
• Procesador Intel Pentium IV con velocidad mínima a 3 Ghz (recomendable del tipo “Dual Core”, o AMD AM2 64 (modelo 3800 Dual Core como mínimo).
• Disco duro 100 GB IDE o S-ATA (preferiblemente este último).
• Memoria RAM 2 GB mínimo (2 módulos x 1 GB), con tecnología Dual Channel y velocidad de bus de 800 Mhz, con tecnología ECC de correción de errores.
• Lector DVD IDE (OpenSUSE 10.2 encuentra problemas con lectores DVD SATA).
• Grabadora DVD tipo “Dual Layer” (graba discos hasta 9 GB) y tecnología de discos +/-R
• Puertos USB (2 como mínimo)
• Tarjeta de red integrada o PCI 10/100/1000 Mbits Fast Ethernet
SGM_2007_10_Manual de Implantación y Configuración v01 Página 7 de 125
Avanza LOCAL SIGEM
3.1.4 Consideraciones sobre Intel y AMD
Actualmente, ambos fabricantes utilizan tecnologías distintas, por cuanto que Intel sigue fabricando microprocesadores que funcionan a 32 bits (con emulación a 64 bits en algunos modelos), mientras que AMD fabrica sus microprocesadores actualmente a 64 bits. La decisión sobre uno u otro puede parecer banal, pero incorporar uno u otro afectará a la instalación del sistema operativo y demás software de aplicación. Se da la paradoja de que en algunos equipos que montan procesadores de AMD a 64 bits, algunas versiones de Linux de 64 bits, no se instalan correctamente, y hay que recurrir a la versión de Linux de 32 bits. Se desconoce si este hecho puede generar problemas con algún tipo de software, como las bases de datos y otras aplicaciones que consumen gran cantidad de recursos. Por lo tanto, y si no es posible hacer pruebas conjuntas con ambos tipos de equipos, se aconseja decantarse por la opción de Intel.
3.1.5 Instalando Linux
La instalación se realizará a partir de DVD, de ahí que el equipo necesite contar con un lector de este tipo. También es posible instalar OpenSuse desde CD, pero la cantidad de CD's necesarios multiplica innecesariamente el riesgo de fallos de los soportes durante la instalación. El esquema de particionado del disco se realizará de la siguiente forma.
Partición Tamaño mínimo recomendado
/ 10 GB
/usr 10 GB
/var El resto del disco (mínimo 50 GB)
/swap 512 MB
El tamaño mínimo de disco recomendado será de 100 GB. El sistema de archivos escogido será ReiserFS. En caso de utilizar una distribución Linux que no disponga de este sistema de archivos, se utilizará XFS o Ext3.
3.1.6 Selección de zona horaria
Se seleccionará la hora como local, ya que si selecciona hora del tipo UTC, el servidor tendrá una hora distinta a la real en España, y dada la importancia de la sincronización horaria en los servidores, es imprescindible realizar correctamente este paso.
3.1.7 Selección de escritorio
Si realmente no se necesita instalar un gestor de ventanas, es mejor no instalarlo, ya que se ahorran recursos en el sistema. Si es necesario, se escogerá un gestor de ventanas y luego en la selección de paquetes solo se instalará los referentes al gestor de ventanas escogido, ya que no tiene sentido en un servidor escoger dos o más gestores de ventanas. En este caso se escoge la opción de Gnome, por lo que esta será la selección en la pantalla de selección de escritorio durante la instalación.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 8 de 125
Avanza LOCAL SIGEM
3.1.8 Configuración de la instalación
Desde esta pantalla se definirán algunas de las opciones de instalación más importantes, y para ello hay que situarse en el modo Experto pinchando en la pestaña correspondiente. Definir las particiones, el cargador de arranque, el cual para esta versión de Linux será Grub, que se instalará en el sector de arranque maestro del disco duro MBR. Hay que editar la opción de arranque de Opensuse y en l as opc iones de a r ranque, hay que camb ia r splash=silent por splast=verbose, y añadir acpi=no. Si ya existiera esta opción acpi=yes, se cambiará a acpi=no.
3.1.9 Instalación de paquetes
Para poder elegir todos los paquetes, en el apartado Software hay que pinchar en la pestaña Detalles para poder ver todos los paquetes. Aunque algunos de los paquetes genéricos no hay que cambiarlos, ya que implicaría un completo estudio del hardware donde se va a instalar Linux y del software que hay que instalar, reduciendo la escalabilidad a corto y medio plazo, sí se realizarán algunos cambios importantes, añadiendo algunos paquetes que necesitamos y quitando otros innecesarios, como podemos ver en la siguiente tabla de selección de paquetes.
Tecnologías de base Acción a realizar
Sistema básico OpenSuse Quitar los siguientes paquetes: ppp, pptp, smpppop, qlogic-firmware (si no hay instalada este tipo de tarjeta). Hay también que quitar cualquier paquete considerado inncesario, lo que dependerá del tipo de instalación ha realizar, máquina, etc.
Novell AppArmor Se dejan los paquetes tal y como la instalación los marca por defecto
Herramientas de consola Instalar los siguientes paquetes: finger, findutils-locate, mc, pin
Portátil Asegurarse que no hay ningún paquete marcado si la instalación se realiza en un equipo de sobremesa o servidor.
Administración de Yast Mantener los paquetes marcados por defecto
Gestión de software de OpenSuse Marcar el paquete pin (si se marcó en Herramientas de consola estará ya marcado)
Gestión de software de empresa Mantener los paquetes marcados por defecto
Entornos gráficos
Entorno de escritorio gnome Se deben quitar los siguientes paquetes: kino, liferea, planner, Realplayer, totem, totem-plugin, xsane
Sistema básico gnome Se deben quitar los siguientes paquetes: aspeel, awesfx, beagle, beagle-
SGM_2007_10_Manual de Implantación y Configuración v01 Página 9 de 125
Avanza LOCAL SIGEM
evolution, beagle-firefox, beagle-gui, beagle-index, cups-backends (solo si no necesitamos impresora), evolution, gnome-audio, gnome-cups-manager (solo si no necesitamos impresora), gnome-themes, gstreamer010-plugins-base, gstreamer010-plugings-good, jack, sox
Escritorio KDE No debe tener ningún paquete marcado
Sistema básico KDE No debe tener ningún paquete marcado
Sistema Xwindows Se deben quitar los siguientes paquetes: 3ddiag, xaw3d
Tipografías Se pueden dejar los paquetes como están
Funciones del escritorio
Efectos de escritorio Se deben quitar todos los paquetes, ya que no se necesitan efectos de escritorio en un servidor
Gráficos Se deben quitar todos los paquetes menos el paquete eog
Juegos Se deben quitar todos los paquetes
Escritorio remoto No se debe instalar ningún paquete
Clientes de Voz sobre IP No se debe instalar ningún paquete
Herramientas de edición de XML y LaTex
No se debe instalar ningún paquete
Funciones del servidor
Servidor de archivos Se dejan las opciones como están por defecto, sin quitar ni instalar ningún paquete salvo caso necesario
Print Server Si no se necesita una impresora para el servidor, se quitan todos los paquetes menos samba
Administración de red Se deben instalar los siguientes paquetes: mtr, nmap, wireshark. tcpdump debe estar también seleccionado para su instalación
Servidor variado No se debe instalar ningún paquete
Servidor de Voz sobre IP No se debe instalar ningún paquete
Servidor de correo y noticias Solo debe marcarse sendmail, necesario para el sistema, del resto no se debe instalar ninguno
Servidor Se instalarán los siguientes paquetes: apache2, apache2-doc, apache2-mod-perl, apache2-mod-php5, mysql (solo si necesitamos esta base de datos)
Gateway de Internet Solo se debe instalar el paquete ipsec-tools si es necesario, del resto no se debe
SGM_2007_10_Manual de Implantación y Configuración v01 Página 10 de 125
Avanza LOCAL SIGEM
instalar ninguno
Servidor DCHP y DNS No se debe instalar ningún paquete
Servidor de directorios No se debe instalar ningún paquete
Servidor host de máquina virtual Xen Dejar las opciones como están por defecto
Software registrado
Entorno Java Instalar el siguiente paquete: java-1_4_2-sun-devel. Desmarcar otras versiones de Java, como la 1.5.x, si están marcadas.
Paquetes patentados diversos No se debe instalar ningún paquete
Desarrollo
Desarrollo básico Instalar los siguientes paquetes: autoconf, automake, build, cpp, gcc, gcc++, make
Desarrollo gnome No se debe instalar ningún paquete
Desarrollo KDE No se debe instalar ningún paquete
Entorno de creación de RPM Mantener los paquetes que están marcados por defecto y además marcar los siguientes paquetes si no están marcados para su instalación: autoconf, automake
Entornos de desarrollo integrados No se debe instalar ningún paquete
Desarrollo en C/C++ No se debe instalar ningún paquete
Desarrollo del nucleo de linux Instalar el paquete kernel-source
Desarrollo en perl No se debe instalar ningún paquete
Desarrollo en Qt4 No se debe instalar ningún paquete
Desarrollo en Python No se debe instalar ningún paquete
Desarrollo de Yast No se debe instalar ningún paquete
Desarrollo Web No se debe instalar ningún paquete
3.1.10 Configuración de la red
En la opción Compatibilidad con protocolo Ipv6, hay que inhabilitar dicha opción. Para configurar la tarjeta de red, se debe indicar dirección IP, máscara de red, servidores DNS y gateway (puerta de enlace predeterminada).
IMPORTANTE Si existe servidor proxy para salida a Internet, hay que configurarlo ahora, ya que de no hacerlo, es posible que no se pueda realizar la actualización en línea posterior a la instalación de los paquetes, pero que se enmarca dentro del proceso de instalación de OpenSuse Linux 10.2. Para configurar el proxy, siempre que se conozcan sus datos, hay que que seguir los siguientes pasos:
• Establecer la direccion del proxy y el puerto utilizado separado por dos puntos : como en el siguiente ejemplo:
http://proxy.ejemplo.prueba:8080
SGM_2007_10_Manual de Implantación y Configuración v01 Página 11 de 125
Avanza LOCAL SIGEM
• Marcar la casilla Utilizar este proxy para todos los protocolos
• Establecer el nombre de usuario del proxy con su correspondiente contraseña si se requiere ese dato. Este paso es importante, ya que de lo contrario OpenSuse no podrá acceder a Internet para realizar la actualización en línea después de la instalación de los paquetes. Se debe realizar la prueba de conexión para asegurar que se ha configurado correctamente la red y el proxy, y OpenSUSE tiene acceso a Internet.
3.1.11 Actualización en línea
Hay que ejecutar la actualización en línea después de instalar los paquetes. Para ello, hay que tener configurada correctamente la red, incluyendo los datos del proxy si existe, debiendo indicar en la configuración de la red el nombre de usuario del proxy y su contraseña, o la actualización en línea no funcionará.
3.1.12 Añadir usuarios
Hay que añadir al menos un usuario al sistema aparte del root, indicando el nombre del usuario y su contraseña, así como su método de validación, como en local, a través de LDAP, del dominio de Windows, etc., por lo que se escogerá la opción que interese, que por lo general será dentro de la misma máquina local. Añadir al menos un usuario a parte del root es un paso fundamental para que luego funcione la base de datos PostgreSQL.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 12 de 125
Avanza LOCAL SIGEM
3.2Software base
3.2.1 Instalación de Java JDK 1.4.2_14
Antes de instalar JAVA JDK, hay que tener previamente instalado en el sistema Java J2RE, el cual se puede instalar desde Yast. Seleccionar el paquete java-1.4.2_14 desde Yast. También se puede instalar bajándola directamente de la web de SUN.
3.3Instalación de TOMCAT
Versión: 5.0.28.
Descargar la versión 5.0.28 de la web de apache en formato targz ó zip y descomprimirlo en el directorio /home/sigem/SIGEM .Configurar variables de entorno: JAVA_HOME,CATALINA_HOME en el .bash_profile del usuario propietario de /home/sigem/SIGEM.
Para optimizar el rendimiento de nuestras aplicaciones, se añadirá en el archivo, catalina.sh , la siguiente línea al principio del archivo:
JAVA_OPTS=”-Xms64M –Xmx1024M $JAVA_OPTS”
3.4Instalación y Configuración de Open Office
Para disponer del servicio de combinación de documentos generados a partir de plantillas, en donde se sustituirán variables por valores de los Expedientes, es necesario:
Instalar OpenOffice v2.x o v1.1.x Iniciar el servicio de escucha en el puerto <<puerto>> de la siguiente
forma:
Nota importante: para iniciar más de un servicio en la misma máquina, es necesario ejecutar los servicios de escucha con distintos usuarios. En caso contrario simplemente se obtendría una única instancia de OpenOffice recibiendo peticiones en dos puertos distintos.
3.5Instalación repositorio
El repositorio consiste en dos directorios que deben ser accesibles mediante el sistema de ficheros, tanto para el servidor de combinación (OpenOffice) como para el servidor de aplicaciones.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 13 de 125
soffce -headless -nologo -nodefault -accept=socket,host=<<servidor>>,port=<<puerto>>;urp;
Avanza LOCAL SIGEM
Se configura mediante las siguientes propiedades del framework de SIGEM:
3.6Instalación servidor aplicaciones
Para finalizar la instalación, es necesario informar al framework dónde se encuentra disponible el servicio de combinación. Para ello se utilizan las siguientes propiedades del framework ISPAC (ispac.properties).
3.7Configuraciones
Se pueden distinguir varios tipos de configuración según las necesidades de instalación y las arquitecturas de despligue de ISPAC. Según la disposición (local o remota) de los componentes instalados en relación con el servidor de aplicaciones se obtiene todo el abanico de configuraciones posibles.
• Local: el componente se encuentra en la máquina donde esté instalado el servidor de aplicaciones.• Remota: el componente se encuentra instalado en una máquina distinta.
3.7.1 Servicio combinación local
Se trata de la configuración más sencilla. Los tres componentes se encuentran en local y por tanto las consideraciones a realizar son mínimas: el proceso de instalación básico descrito anteriormente bastaría. Tiene como principal desventaja el compartir la CPU por parte del servicio de combinación y el servidor de aplicaciones.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 14 de 125
#REPOSITORIO COMBINACIÓN##Directorio temporalTEMPORARY_PATH = /home/juan/ispac_fles/temporary
#Caché de plantillas en disco.TEMPLATE_PATH = /home/juan/ispac_fles/templates
# Cadena conexión para OpenOffce.OPEN_OFFICE_CONNECT = uno:socket,host=localhost,port=8100;urp;StarOffce.NamingService
# Instancias adicionales de OpenOffce#OPEN_OFFICE_ADDITIONAL_INSTANCES = 1
# Añadir tantas entradas extras como servicios de combinación adicionales se deseen.uno:socket,host=localhost,port=8101;urp;StarOffce.NamingService
Avanza LOCAL SIGEM
3.7.2 Servicio combinación remoto
En esta configuración, el servicio de combinación se encuentra instalado en otra máquina. Para su correcto funcionamiento son necesarios realizar dos cambios en la instalación:
3.8Servidor de aplicaciones (framework para SIGEM)
Cambiar adecuadamente el nombre de servidor.
3.9Repositorio de combinación.
En este caso, los directorios deben ser accesibles de manera local con la misma ruta tanto al servidor de aplicaciones como al servicio de combinación. La forma difiere según el entorno hardware:
1. Entorno Ms Windows: utilizar unidades de red compartidas entre ambos. Ejemplo:
2. Entorno Unix: mediante NFS, montar en una misma ruta el repositorio
SGM_2007_10_Manual de Implantación y Configuración v01 Página 15 de 125
# Cadena conexión para OpenOffce.OPEN_OFFICE_CONNECT = uno:socket,host=<<servidor>>,port=8100;urp;StarOffce.NamingService
# Instancias adicionales de OpenOffce#OPEN_OFFICE_ADDITIONAL_INSTANCES = 1
# Añadir tantas entradas extras como servicios de combinación adicionales se deseen.
#REPOSITORIO COMBINACIÓN## Unidad de red mapeada a unidad local V: en ambas máquinas: servidor de aplicaciones y# servidor de combinación (OpenOffce)# #Directorio temporal
TEMPORARY_PATH = V:/ispac_fles/temporary
#Caché de plantillas en disco.TEMPLATE_PATH = V:/ispac_fles/templates
#REPOSITORIO COMBINACIÓN## Sistema de fcheros NFS montado sobre el path /data/ispac_fles en ambas máquinas:# servidor de aplicaciones y servidor de combinación (OpenOffce)## Directorio temporalTEMPORARY_PATH = /data/ispac_fles/temporary
#Caché de plantillas en disco.TEMPLATE_PATH = /data/ispac_fles/templates
Avanza LOCAL SIGEM
En ambos casos, es necesario asegurar que los usuarios bajo los cuales se ejecutan ambos servicios, tengan el permiso de acceso adecuado a los ficheros.
3.10Varios servicios de combinación remotos
Para disponer de más de un servicio de combinación, estos se deben configurar de igual forma que en el punto anterior. Además es necesario anotar en el fichero de propiedades del framework ISPAC el nuevo servicio de combinación:
Ejemplo de configuración para dos servicios de combinación, instalados en las máquinas <<servidor1>> y <<servidor2>> respectivamente:
3.11Aplicaciones SIGEM
En este apartado solo se enumeran las aplicaciones SIGEM, ya que, mas adelante, se detallan cada una de ellas en el módulo aplicaciones SIGEM.Estas aplicaciones son:
• Registro• Registro telemático• Consolidación• Archivo• Gestión de Expedientes• Pago electrónico• Notificación electrónica• Consulta Web de expedientes• Catálogo de tramites• Catálogo de procedimientos• Gestión de Usuarios• Servicios Web
3.12Consolidación
El proceso de consolidación se encarga de actualizar en el Registro de Entrada /Salida, los registros realizados desde el registro telemático, por tramitación electrónica.
Es un proceso java que se ejecuta periódicamente fuera del servidor de aplicaciones.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 16 de 125
# Cadena conexión para OpenOffce.OPEN_OFFICE_CONNECT = uno:socket,host=<<servidor1>>,port=8100;urp;StarOffce.NamingService
# Se utilizará un servicio de combinación adicional.OPEN_OFFICE_ADDITIONAL_INSTANCES = 1
# Segundo servicio de combinaciónOPEN_OFFICE_CONNECT_0=uno:socket,host=<<servidor2>>,port=8100;urp;StarOffce.NamingService
Avanza LOCAL SIGEM
3.12.1 Instalación.
Descomprimir el archivo de distribución SIGEM_Consolidacion.tar.gz en el directorio elegido. Preferentemente dentro de una carpeta en el home de usuario “sigem”.
Una vez descomprimido la estructura de la aplicación de consolidación es la siguiente:
- Bin: directorio con los ejecutables.- Lib: directorio con las librerías java necesarias.- Log: directorio donde se almacenan los logs del proceso.- Xsl: plantillas para la transformación entre formatos.
3.12.2 Configuración
Variables de entorno
Para la correcta ejecución del proceso es necesario que el ejecutable de la máquina virtual de java este disponible en la variable de entorno $PATH. Para esto debe existir la ruta a <dir_java>/bin.
La máquina virtual debe ser la 1.4.2_14.
Base de datos
Dentro del directorio “bin” se encuentra el archivo notxadomian.xml en el que se configuran el origen ( modelo de datos del registro telemático ) y destino ( modelo de datos del registro presentical ).
Hay que configurar las dos entradas con los datos correctos.
Volumen
D e n t r o d e l d i r e c t o r i o “ b i n ” s e e n c u e n t r a e l a r c h i v o pistaVU2Sicres_Configuracion.xml en que se define el volumen dentro del gestor documental de registro en el que se almacenaran los archivos. Dentro de este archivo hay que configurar la propiedad:
<IdentificadorIVOLVOLHDR>1</IdentificadorIVOLVOLHDR>
3.12.3 Ejecución del proceso
Para ejecutar la consolidación hay que ejecutar:
<dir_consolidacion>\bin\ runConsolidacion.sh
3.12.4 Planificación de la ejecución del proceso
El proceso de consolidación debe ejecutarse periódicamente. Dependiendo del S.O. anfitrión habra que realizar una de las siguientes tareas:
SGM_2007_10_Manual de Implantación y Configuración v01 Página 17 de 125
Avanza LOCAL SIGEM
S.O. Windows
Añadir y configurar la ejecución de la consolidación en el planificador de tareas de la máquina.
S.O. Unix
Añadir y configurar la ejecución de la consolidación en el cron del sistema.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 18 de 125
Avanza LOCAL SIGEM
4 Módulo Nodo Servidor de Bases de Datos
4.1Gestor de base de datos. Postgres
4.1.1 Instalación postgres Linux
Hay que instalar PostgreSQL desde la herramienta Yast. Hay que instalar los siguientes paquetes:
postgresql postgresql-server postgresql-libs
Una vez creada la base de datos, esta crea su propio usuario, el cual se llama postgres, y será desde este usuario desde el que se arrancará la base de datos. La contraseña de este usuario también es postgres. Durante la instalación, al mismo tiempo que se crea el usuario, PostgreSQL también crea su propia base de datos por defecto, aunque es posible crear después más bases de datos. La base de datos creada por defecto se encuentra en:
/var/lib/pgsql/data/
Iniciar y parar la base de datos
Para iniciar la base de datos:
pg_ctl start -D /var/lib/pgsql/data
Para parar la base de datos
pg_ctl stop -D /var/lib/pgsql/data
IMPORTANTE: Antes de apagar el servidor, hay que detener la base de datos con el comando antes indicado o con el script que se ha creado para la automatización de los arranques y paradas que se detalla en el apartado xxxx de este manual.
Acceso a la base de datos desde la red
Para acceder a la base de datos PostgreSQL desde cualquier equipo de la red, hay que comprobar y/o realizar los siguientes pasos:
• Editar el archivo /var/lib/pgsql/data/pg_hba.conf • Comentar la línea que hace referencia al protocolo IPv6, ya que no es
necesaria• Añadir la siguiente línea:
SGM_2007_10_Manual de Implantación y Configuración v01 Página 19 de 125
Avanza LOCAL SIGEM
host postgres postgres 0.0.0.0/0 trust
• Los datos indicados anteriormente tienen que estar separados por al menos un espacio, no existiendo problemas si se introduce más de un espacio, por ejemplo, para ordenar los datos de forma estética dentro del script
• Editar el archivo /var/lib/pgsql/data/postgresql.conf• Cambiar la línea listen_addresses y dejarla de la siguiente forma:
listen_addresses='*'
• Descomentar la línea # port=5432
4.1.2 Instalación postgres en Windows
Lanzar el programa de instalación postgresql-8.2.msi. Existe una guía básica en inglés. Después, ir siguiendo paso a paso la instalación:
Primero se preguntará el idioma, (en la versión 8.2 no hay español).
También se indica si se quiere guardar un log de instalación.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 20 de 125
Avanza LOCAL SIGEM
A continuación se muestran las notas sobre la instalación.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 21 de 125
Avanza LOCAL SIGEM
En Installation options debemos activar: National Language Support y PL/Java, si no vinieran por defecto.
En el siguiente paso, debemos definir usuario y password que lanza el servicio postgres de Windows.
.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 22 de 125
Avanza LOCAL SIGEM
A continuación, activaremos Accept connections on all addreses, not just localhost, dejaremos el idioma C, seleccionaremos la codificación. Encoding: que necesitemos (latin9). También introduciremos la contraseña del administrador de la base de datos (postgres).
.
En la pantalla llamada Enable procedural languages, dejar activados PL/pgsql
SGM_2007_10_Manual de Implantación y Configuración v01 Página 23 de 125
Avanza LOCAL SIGEM
En Enable contrib modules, activar:
Adminpack. TSearch2
En la siguiente pantalla : pulsar next>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 24 de 125
Avanza LOCAL SIGEM
Continuar hasta el final con la instalación:
SGM_2007_10_Manual de Implantación y Configuración v01 Página 25 de 125
Avanza LOCAL SIGEM
Al final de la instalación, el servicio ya debería de estar funcionando. Para asegurar que todo ha ido bien, se puede ir al Administrador de servicios.
Ahora hay que revisar los ficheros de configuración que podemos ver en el menú:
< Directorio de instalación Postgres.>\PostgreSQL\8.2\data
Los ficheros de configuración a revisar son:pg_hba.confpostgresql.conf
Sobretodo debemos asegurarnos de que en pg_hba.conf se permite el acceso a las máquinas de la red que vayan a trabajar como clientes de PostgreSQL. Es importante también, el comprobar que en postgresql.conf se permite recibir conexiones desde las direcciones que nos interesan con la opción listen_addresses. Una vez modificados los ficheros de configuración a nuestro gusto, parar y arrancar el servicio.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 26 de 125
Avanza LOCAL SIGEM
5 Módulo Aplicaciones SIGEM
5.1Aplicación de Registro
Se comienza a describir la instalación en el servidor web del Registro de SIGEM.
La aplicación de Registro se despliega en el war: <<isicres.war>> en el servidor web, dentro del directorio de Tomcat:
<<<DIRECTORIO INSTALACION TOMCAT>/webapps/isicres/>>
5.1.1 Componentes software
El software de instalación, se encuentra en el CD de instalación o en el sitio web SIGEM de descarga, dentro del directorio: Registro:
<<isicres.war>>
5.1.2 Configuración con BB.DD
Se tiene que configurar una fuente de datos en tomcat desde el administrador de tomcat y para el contexto isicres:
El nombre JNDI será: ISicres
SGM_2007_10_Manual de Implantación y Configuración v01 Página 27 de 125
Avanza LOCAL SIGEM
5.1.3 Log de AplicaciónLa aplicación de registro, genera un log de aplicación denominado: ISicresWeb.log
Este log reside en el directorio: /var/log/isicres/ISicresWeb.log
5.1.4 Instalación del cliente Windows
Para la configuración del Registro del Organismo, se instalará un cliente Windows de Registro. Este cliente Windows para SIGEM, se basa en la especificación SICRES V3 que tiene el producto invesicres, por ello en las ventanas de la instalación, a veces se leerá sicres y otras invesicres, ambas denominaciones se refieren al Registro de SIGEM. El sistema sicres cuenta con un gestor documental asociado, desde el que se controlan los usuarios y repositorios de documentos del Registro. Este sistema está basado en el producto invesdoc, por esta circunstancia, puede en algún punto de este manual, hacerse referencia a una utilidad o directorio de este producto, que está embebido en el software del registro. Se detalla en esta sección su instalación.
Componentes software
El software de instalación, se encuentra en el CD de instalación o en el sitio web SIGEM de descarga, dentro del directorio: Registro, subdirectorio: Cliente Windows:
1) Del directorio que se muestra, se ejecutará el programa: Instalar.exe:
2) Después de la ventana de bienvenida el proceso de instalación presenta una ventana para la selección de la carpeta destino de la instalación. Debemos colocar esa carpeta en C:\Archivos de programa\SIGEM\invesicres
SGM_2007_10_Manual de Implantación y Configuración v01 Página 28 de 125
Avanza LOCAL SIGEM
3) A continuación, el proceso de instalación, presenta la ventana de componentes a instalar. Los componentes que se instalarán en SIGEM son:
Cliente: incluye la aplicación cliente de registro.
Administración: incluye los siguientes módulos,
o Gestión de tipos de asuntos
o Gestión de informes
o Inicialización de base de datos
o Gestión de libros de registro
o Control de modificaciones
o Gestión de unidades administrativas
o Gestión de usuarios
o Gestión de volúmenes
o Herramientas de administración de estructura de libros, Administración de formatos y utilidad de exportación/importación)
o Configuración del sistema
SGM_2007_10_Manual de Implantación y Configuración v01 Página 29 de 125
Avanza LOCAL SIGEM
Otros: incluye:
o Archivos de ayuda
o Fichero de unidades administrativas
o Microsoft XML Parser 4.0 SP1 ( No es necesario marcarlo si el puesto es Xp con SP2 )
4) Una vez seleccionado los componentes a instalar, el proceso empieza a copiar los distintos archivos al destino indicado.
5) Finalmente, el proceso de instalación solicita datos de configuración de la estación en la que se está instalando la aplicación:
Base de datos central: ODBC de conexión a la base de datos
SGM_2007_10_Manual de Implantación y Configuración v01 Página 30 de 125
Avanza LOCAL SIGEM
Base de datos local: no hay base de datos local
Dispositivos: disponibilidad de dispositivos en la estación (Impresora de validación y escáner), y opciones de configuración de los mismos.
Directorios: directorios de trabajo utilizados por la aplicación sicres. Los directorios a configurar son:
o Directorio de caché: toma como valor por defecto C:\Archivos de programa\SIGEM\invesicres\Cache. El tamaño de 0Mb para este valor, indica un cache de tamaño infinito.
o Directorio temporal: toma como valor por defecto C:\Archivos de programa\SIGEM\invesicres\Temp.
5.1.5 Inicialización del sistema de Registro
Como requisitos previos para la inicialización del sistema sicres, se requieren las siguientes condiciones en la estación de trabajo desde la cuál se vaya a realizar esta operación:
Instalación del software si c r e s seleccionando dentro del componente Administración, la instalación del módulo Inicialización de base de datos.
Instalación del software cliente de conexión a la base de datos central, y del correspondiente controlador ODBC.
1) Ejecute la utilidad de Herramientas de sistema IDOCTSYS.EXE, desde el subdirectorio \bin del directorio de instalación de sicres, para inicializar la estructura de datos. Sistema (inicializar). Para ello, primero debe conectarse a la base de datos desde esta misma herramienta. BD (conectar).
2) Cargue las licencias (gratuitas en SIGEM, pero necesarias) usuario invesicres desde la misma utilidad de Herramientas de invesdoc (sistema) de invesdoc 8.9.2 (IDOCTSYS.EXE). Para ello seleccione, una vez conectado, la opción Importar del menú Licencias.
3) Ejecute la utilidad Inicialización de base de datos de sicres: ISINICIA.EXE desde el subdirectorio \bin del directorio de instalación de sicres, para inicializar la estructura de datos sicres. Siga los siguientes pasos:
Proceda a crear las tablas (Menú Herramientas, opción Crear tablas). En el transcurso de la creación del modelo de datos, se informará en pantalla (Informe de incidencias) de posibles errores o incidencias que surjan.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 31 de 125
Avanza LOCAL SIGEM
5.1.6 Configuración del sistema de Registro
Para realizar la tarea de configuración del sistema sicres, se requiere la instalación previa de los módulos del componente Administración. Todas las operaciones descritas a continuación deben realizarse con el usuario SYSSUPERUSER/SYSPASSWORD, hasta poder crear un superusuario invesicres, momento a partir del cuál se deben proseguir las operaciones usando dicho usuario.
1) Desde la aplicación de Gestión de unidades administrativas, proceda a:
Introducir la Entidad Registral que va a representar al sistema sicres.
Cargar las unidades administrativas que vayan a utilizarse en el sistema de Registro, agrupadas en los distintos tipos de institución. Esta operación puede realizarse manualmente o bien mediante la importación de un fichero de datos conteniendo las unidades administrativas a cargar. El kit de instalación dispone de un fichero de unidades administrativas llamado UNIDADES.ADM (Módulo Fichero de unidades administrativas del componente Otros). Este fichero se instala en el subdirectorio \bin del directorio de instalación de sicres.
Introduzca las distintas Oficinas de Registro que deben definirse en el sistema. Las oficinas de registro deben pertenecer a la entidad registral definida en el paso anterior.
De de alta los distintos usuarios del sistema, asignando cada uno de ellos a una oficina de registro. Se debe asignar a cada usuario un perfil de usuario sicres (Superusuario, Administrador de libro u Operador de registro). Es muy recomendable crear en este paso un Superusuario sicres, y proseguir las operaciones de configuración usando ese nuevo usuario.
2) Desde la aplicación de Gestión de libros de registro, proceda a crear los libros de registro que vayan a utilizarse, indicando:
Nombre del libro
Tipo: Entrada o Salida
Tipo de numeración: Central, Local, por Oficina.
Formato de numeración: corto o largo
Autenticación de las imágenes digitalizadas
Repositorio de información para almacenamiento de imágenes digitalizadas. (Opcional)
3) Asocie a cada libro de registro creado, las distintas oficinas de registro y usuarios, con los permisos pertinentes.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 32 de 125
Avanza LOCAL SIGEM
4) Opcionalmente, puede ser necesario actualizar los contadores de numeración (Menú Herramientas, opciones Numeración de entrada/Numeración de salida)
Al ejecutar la aplicación cliente de registro por primera vez en un puesto windows, aparece una pantalla donde se nos indica que demos de alta la estación desde donde estamos trabajando, indicando siempre la oficina de registro a la que pertenece, y su nombre de estación Windows (por defecto, nombre de máquina).
5.1.7 Configuración del servidor de impresión de imágenes
Para poder imprimir imágenes digitalizadas desde la aplicación sicres en su cliente Windows, es necesario previamente configurar el servidor de impresión de imágenes en cada estación desde la cual se realizará la impresión. Para ello se dispone en el subdirectorio \bin del directorio de instalación de la aplicación, de un script VBScript, que permite realizar tal configuración.
Ejecute el script configprint.vbs. Aparecerá un cuadro de diálogo para configurar el tipo de impresora y sus propiedades (Directorio de spool), así como el tipo de formatos de imágenes (TIFF, BMP, etc...) que serán redirigidos al servidor de impresión.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 33 de 125
Avanza LOCAL SIGEM
5.1.8 Otras configuraciones
La versión de Registro, permite configurar algunos aspectos del comportamiento de la aplicación de un modo global, definiendo una sola vez para todo el sistema los valores de esa configuración.
Esta configuración del sistema se realiza desde un fichero denominado:ISicres-DesktopWeb-Configuration.xml.
Este fichero se encuentra dentro de:<DIRECTORIO INSTALACION TOMCAT>/webapps/isicres/WEB-INF/classes
Para que los cambios en este fichero sean efectivos se tiene que parar tomcat.
Este fichero se encuentra dentro de isicres.war y tiene definidas por defecto las configuraciones de registro mas comunes (solo se toca en casos muy especiales).
SGM_2007_10_Manual de Implantación y Configuración v01 Página 34 de 125
Avanza LOCAL SIGEM
SGM_2007_10_Manual de Implantación y Configuración v01 Página 35 de 125
Avanza LOCAL SIGEM
5.2Gestión de Expedientes
5.2.1 Requisitos del Sistema
Los módulos Tramitador y Archivo del producto SIGEM se han desarrollado bajo el siguiente entorno tecnológico:
Entorno ProductoJava JDK 1.4.2_14Servidor de Aplicaciones Apache Tomcat 5.0.28Base de Datos PostgreSQL 8.2.3 con búsqueda
documental integrada (TSearch2) y la función connectby instalada
Gestor Documental invesDoc 9.2Gestor de Plantillas OpenOffice 2.2.0
Para su correcta instalación, será necesario disponer de la información de conexión con estos otros componentes de SIGEM:
• Consulta Telemática• Gestor de Plantillas OpenOffice• Gestor de Terceros• Gestor de Territorio• Gestor Documental invesDoc• Notificación Telemática• Registro
SGM_2007_10_Manual de Implantación y Configuración v01 Página 36 de 125
Avanza LOCAL SIGEM
5.2.2 Entornos de bases de datos
Hay que crear los siguientes esquemas de base de datos en PostgreSQL:
• archivo (codificación Latin1(1))
• tramitador (codificación Latin9)
En el directorio databases se adjuntan los scripts de creación e inicialización de tablas para ambos esquemas (carpetas Creación bbdd tramitador y Creación bbdd archivo).Se adjunta también el script de creación de una base de datos de pruebas de Consulta Telemática y Notificación Telemática por si no se dispone de la base de datos real así como el script de inicialización de la bbdd tramitador (Inicialización bbdd tramitador).
El orden de ejecución de los scripts situados en databases\Inicialización bbdd archivo\ es el siguiente:
1. create_tables.sql2. create_functions.sql3. create_documentary_search.sql (o create_documentary_search.linux.sql)4. insert_data.sql5. insert_clob.sql
El resto de scripts adjuntados en esta carpeta son para realizar limpiezas o eliminaciones de tablas.El orden de ejecución del resto de scripts seguirá el orden lógico de ejecutar primero los scripts bajo las carpetas Creación bbdd tramitador y Creación bbdd consulta Telemática y finalmente, si se desea, los scripts de inicialización de datos de consulta telemática bajo la carpeta Inicialización bbdd tramitador.
1 Para instalaciones en Linux, la codificación tanto del servidor de bases de datos como de la base de datos creada deber ser Latin9. Utilizar script adjuntado en los entregables databases\Inicialización bd archivo\create_documentary_search_linux.sql
SGM_2007_10_Manual de Implantación y Configuración v01 Página 37 de 125
Avanza LOCAL SIGEM
5.2.3 Configuración del Gestor Documental
Creación de un repositorio de documentos
Desde el Administrador de almacenamiento de invesDoc, hay que crear: un repositorio, un volumen dentro de ese repositorio y una lista de volúmenes asociada a ese volumen.
Por ejemplo:
- Repositorio:
Nombre REPOSITORIO_LOCAL_TEMPTipo PFSDisponible SíRuta de acceso C:\REPOSITORIO_INVESDOC
- Volumen:
Nombre VOLUMEN_LOCAL_01Ruta de acceso C:\REPOSITORIO_INVESDOC\VOLUMEN_LOCAL_01Capacidad 500Disponible Sí
- Lista de volúmenes:
Nombre LVOL_SIGEMVolúmenes asociados VOLUMEN_LOCAL_01
Esta lista de volúmenes se deberá configurar en el fichero archivo-cfg.xml de la aplicación archivo.
Creación de los archivadores de documentos
Con la herramienta de importación de invesDoc, crear los dos archivadores siguientes:
• Documentos Electrónicos• Documentos Electrónicos Firmados
Para ello, en el directorio invesDoc, se adjuntan los xml de importación de estos archivadores. Ambos deben estar asociados a la lista de volúmenes creada anteriormente (LVOL_SIGEM).Los identificadores de estos archivadores se deberán configurar en el fichero de configuración IDocStorageCfg.xml en las aplicaciones ispaccatalog, ispacmgr, ispacpublicador e ispacwsarchivo.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 38 de 125
Avanza LOCAL SIGEM
5.2.4 Configuración del servidor de aplicaciones (Tomcat)
Orígenes de datos
En el directorio datasources se adjuntan los ficheros xml que definen los datasources utilizados por las aplicaciones web.Para configurar los datasources de las bases de datos de invesdoc y sicres a la instalación de que se disponga se deben modificar los siguientes ficheros:
1. En archivo.xml:a. jdbc/invesdocDSb. jdbc/SicresDS
2. En ispaccatalog.xmla. jdbc/SIGEM_TRAMITADORDSb. jdbc/INVESDOCDS
3. En ispacmgr.xmla. jdbc/SIGEM_TRAMITADORDSb. jdbc/INVESDOCDSc. jdbc/sicresDS
4. En ispacpublicador.xmla. jdbc/SIGEM_TRAMITADORDSb. jdbc/consultac. jdbc/INVESDOCDS
5. En ispacwsarchivo.xml y en SIGEM_TramitacionWS.xmla. jdbc/SIGEM_TRAMITADORDSb. jdbc/INVESDOCDS
6. En SIGEM_TercerosWS.xmla. jdbc/sicres
Si además se han creado las bases de datos de archivo, tramitación y consulta Telematica con nombres diferentes a los indicados (archivo, tramitacion y consultaTelematica) en los datasources, también habría que configurarlos adecuadamente. Una vez modificados, estos ficheros deben copiarse a la ruta:
%TOMCAT_HOME%\conf\Catalina\localhost
SSL
Es necesario habilitar en conector SSL en el servidor de aplicaciones. Para ello se deberán realizar las siguientes tareas:
1. Crear un certificado de servidor2. Habilitar el conector SSL en el servidor de aplicaciones.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 39 de 125
Avanza LOCAL SIGEM
Creación de un certificado de servidor
Para crear el certificado de servidor, se utilizará la utilidad keytool desde la línea de comandos:
C:> cd %TOMCAT_HOME%\conf
C:\%TOMCAT_HOME%\CONF> keytool -genkey -v -alias tomcat -keystore keystore -storepass changeit -keypass changeit -dname "CN=SIGEM, OU=TECNOLOGIA DOCUMENTAL Y WORKFLOW, O=IECISA, C=ES"
El fichero de certificado creado (keystore) debe ser copiado a la carpeta %TOMCAT_HOME%\conf\.
Activación del conector SSL
Para habilitar el conector SSL en el servidor de aplicaciones, se debe configurar el fichero %TOMCAT_HOME%\conf\server.xml.Por ejemplo:
<Service name="Catalina">
{...}
<!-- Define a non-SSL Coyote HTTP/1.1 Connector on port 9080 --><Connector
acceptCount="100" connectionTimeout="20000" debug="0" disableUploadTimeout="true" enableLookups="false" maxSpareThreads="75" maxThreads="150" minSpareThreads="25" port="9080" redirectPort="8443"/>
<!-- SSL archivo --><Connector acceptCount="100" clientAuth="false" debug="0" disableUploadTimeout="true" enableLookups="false" keystoreFile="conf/keystore" keystorePass="changeit" maxSpareThreads="75" maxThreads="150" minSpareThreads="25" port="4443" scheme="https" secure="true"
SGM_2007_10_Manual de Implantación y Configuración v01 Página 40 de 125
Avanza LOCAL SIGEM
sslProtocol="TLS"/>
{...}
</Service>
Configuración de las aplicaciones web
SIGEM Archivo
Fichero "WEB-INF\web.xml"
Es el fichero de configuración de la aplicación web. Los parámetros que sería necesario modificar / adaptar después de cada despliegue serían:
Nombre DescripciónLOGGING_XMLCONF Ruta física completa al fichero de configuración del
log. Por defecto: C:/desarrollo/java/WEBAPPS/archivo/archivo/config/log4j.xml
archivo.cfg.file Ruta física completa al fichero de configuración de la aplicación. Por defecto:
C:/desarrollo/java/WEBAPPS/archivo/archivo/config/archivo-cfg.xml
Fichero "archivo-cfg.xml"
En este fichero se configura la conectividad de la aplicación de archivo con sistemas externos a través de clases o de servicios web que implementan el interfaz correspondiente. Aquí se mencionan aquellos que sería necesario conocer y/o modificar para el despliegue actual.
Sistema gestor de organizaciones
El gestor de organizaciones actual está configurado para ser invesDoc, por lo que la estructura jerárquica que se cree en invesDoc y de la que cuelguen los usuarios a utilizar en la aplicación será la que se use. Para el despliegue actual sólo habría que tenerlo en cuenta, no es necesario modificarlo.
<Sistemas_Gestores_Organismos> <Sistemas_Externos> <Sistema> <Id>SIGEM</Id> <Nombre>Organización SIGEM</Nombre> <Clase> se.instituciones.archivo.invesdoc.GestorOrganismoInvesdoc </Clase> </Sistema> </Sistemas_Externos> {...}</Sistemas_Gestores_Organismos>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 41 de 125
Avanza LOCAL SIGEM
Sistema gestor de catálogo de procedimientos
El sistema gestor de catálogo de procedimientos actual está configurado para ser un servicio del sistema ISPAC. Para el despliegue actual sólo habría que tenerlo en cuenta, no es necesario modificarlo a no ser que no se vaya a instalar en la misma máquina que la aplicación de archivo; en ese caso, habría que establecer el valor WSDL_LOCATION correctamente.
<Sistema_Gestor_Catalogo> <Id_SistGestor_Org>SIGEM</Id_SistGestor_Org> <Clase>se.procedimientos.archigest.GestorCatalogoArchigest</Clase> <init-param> <param-name>WSDL_LOCATION</param-name> <param-value> http://localhost:9080/ispacwsarchivo/services/CatalogoService?wsdl </param-value> </init-param></Sistema_Gestor_Catalogo>
Sistema tramitador de expedientes
El sistema tramitador de expedientes actual está configurado para ser un servicio del sistema ISPAC. Para el despliegue actual sólo habría que tenerlo en cuenta, no es necesario modificarlo a no ser que no se vaya a instalar en la misma máquina que la aplicación de archivo; en ese caso, habría que establecer el valor WSDL_LOCATION correctamente.
<Sistemas_Tramitadores> <Sistema> <Id>04</Id> <Nombre>SIGEM</Nombre> <Id_SistGestor_Org>SIGEM</Id_SistGestor_Org> <Clase>se.tramites.archigest.SistemaTramitadorArchigest</Clase> <init-param> <param-name>WSDL_LOCATION</param-name> <param-value> http://localhost:9080/ispacwsarchivo/services/TramitadorService?wsdl </param-value> </init-param> </Sistema> </Sistemas_Tramitadores>
Sistema gestor de terceros
El sistema gestor de terceros actual es SICRES, integrado dentro de la base de datos de invesDoc. Para el despliegue actual sólo habría que tenerlo en cuenta, no es necesario modificarlo.
<Sistema_Gestor_Terceros> <Id>BDTERCEROS</Id> <Clase>se.terceros.sicres.SicresGestorTerceros</Clase>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 42 de 125
Avanza LOCAL SIGEM
</Sistema_Gestor_Terceros>
Configuración de fichas descriptivas
Aquí se configuran las rutas físicas completas a las hojas de trasformación para las fichas. Es necesario darles el valor adecuado a su ubicación en el sistema en el que se despliegue la aplicación de archivo.
<Configuracion_Descripcion> <Plantillas_XSL> <Consulta>C:/desarrollo/java/WEBAPPS/archivo/archivo/config/templateConsultaFicha.xsl </Consulta> <Edicion>C:/desarrollo/java/WEBAPPS/archivo/archivo/config/templateEdicionFicha.xsl </Edicion> </Plantillas_XSL></Configuracion_Descripcion>
Configuración de auditoríaAquí se configura la ruta física completa a la hoja de transformación para la
auditoría. Es necesario darles el valor adecuado a su ubicación en el sistema en el que se despliegue la aplicación de archivo.
<Configuracion_Auditoria> <Plantilla_XSL> C:/desarrollo/java/WEBAPPS/archivo/archivo/config/transformLogTemplate.xsl </Plantilla_XSL></Configuracion_Auditoria>
Fichero "WEB-INF\classes\IeciTd_DbConn_Cfg.xml”
Esta configuración se utiliza para realizar la autenticación de usuarios contra el gestor de usuarios de invesDoc. En este fichero sólo es necesario modificar el datasource definido para la conexión con la base de datos de invesDoc en caso de que no se utilice el que se adjunta para este despliegue en los ficheros XML.
SIGEM Catálogo de Procedimientos
Configuración del Catálogo de Procedimientos
Ruta del fichero:WEB-INF\classes\ispac.properties
Descripción:Fichero principal de configuración de la aplicación.
Parámetros:
SGM_2007_10_Manual de Implantación y Configuración v01 Página 43 de 125
Avanza LOCAL SIGEM
Nombre DescripciónPOOLNAME Nombre del pool de base de datos del tramitador.
Por defecto: POOLNAME=java:comp/env/jdbc/SIGEM_TRAMITADORDS
KEEP_ALIVE Indica cada cuanto tiempo (en milisegundos) el navegador debe enviar el ping. Por defecto:
KEEP_ALIVE = 60000SESSION_TIMEOUT Indica el tiempo máximo que una sesión puede
permanecer abierta sin enviar ningún ping. Cuando se sobrepase este tiempo el framework liberará la sesión junto con recursos y bloqueos obtenidos. Por defecto:
SESSION_TIMEOUT = 4800000DIRECTORY_MANAGER Indica el sistema gestor de usuarios. Los valores posibles
son: LDAP, INVESDOC. Por defecto:DIRECTORY_MANAGER = INVESDOC
DIRECTORY_NAME Texto descriptivo del sistema de usuarios. Por defecto:DIRECTORY_NAME = invesDoc
USERS_POOL_NAME Nombre JNDI del pool de conexiones sobre la BBDD en la que se encuentra instalado invesdoc. Por defecto:
USERS_POOL_NAME = java:comp/env/jdbc/INVESDOCDS
Configuración del acceso al Gestor Documental
Ruta del fichero:WEB-INF\classes\IDocStorageCfg.xml
Descripción:Fichero de configuración del gestor documental invesDoc.
Parámetros:Nombre Descripcióndefault_archive_id Identificador del archivador por defecto.ctxpool_name Nombre del datasource de acceso a invesDoc.idocuser_id Identificador de un usuario para conectarse a
invesDoc.temporary_path Directorio temporal para subir ficheros.archive Lista de archivadores con sus metadatos
SIGEM Tramitador
Configuración del Tramitador
Ruta del fichero:WEB-INF\classes\ispac.properties
Descripción:Fichero principal de configuración de la aplicación.
Parámetros:
SGM_2007_10_Manual de Implantación y Configuración v01 Página 44 de 125
Avanza LOCAL SIGEM
Nombre DescripciónPOOLNAME Nombre del pool de base de datos del tramitador.
Por defecto: POOLNAME=java:comp/env/jdbc/SIGEM_TRAMITADORDS
KEEP_ALIVE Indica cada cuanto tiempo (en milisegundos) el navegador debe enviar el ping. Por defecto:
KEEP_ALIVE = 60000SESSION_TIMEOUT Indica el tiempo máximo que una sesión puede
permanecer abierta sin enviar ningún ping. Cuando se sobrepase este tiempo el framework liberará la sesión junto con recursos y bloqueos obtenidos. Por defecto:
SESSION_TIMEOUT = 4800000DIRECTORY_MANAGER Indica el sistema gestor de usuarios. Los valores posibles
son: LDAP, INVESDOC. Por defecto:DIRECTORY_MANAGER = INVESDOC
DIRECTORY_NAME Texto descriptivo del sistema de usuarios. Por defecto:DIRECTORY_NAME = invesDoc
USERS_POOL_NAME Nombre JNDI del pool de conexiones sobre la BBDD en la que se encuentra instalado invesdoc. Por defecto:
USERS_POOL_NAME = java:comp/env/jdbc/INVESDOCDS
HOST Dirección donde se encuentra ejecutandose el OpenOffice. Por defecto:HOST = localhost
OPEN_OFFICE_CONNECT Cadena conexión para OpenOffice. Por defecto:OPEN_OFFICE_CONNECT=
uno:socket,host=localhost, port=8100;urp;StarOffice.NamingService
TEMPORARY_PATH Directorio temporal. Por defecto:TEMPORARY_PATH = C:/temp/temporary
TEMPLATE_PATH Caché de plantillas en disco. Por defecto:TEMPLATE_PATH = C:/temp/templates
CONNECTOR_MANAGER Indica los tipos de conectores documentales. Los posibles valores son: database, documentum, invesdoc, filesystem. Por defecto:
CONNECTOR_MANAGER = invesdocTHIRDPARTY_API_CLASS Clase que gestiona el acceso a terceros. Por defecto:
THIRDPARTY_API_CLASS= ieci.tdw.ispac.ispaclib.thirdparty.sicres.SicresThirdPartyAPI
THIRDPARTY_SICRES_POOL_NAME En caso de seleccionar SICRES como gestor de terceros, este parámetro indica el datasource de acceso a SICRES. Por defecto:
THIRDPARTY_SICRES_POOL_NAME= java:comp/env/jdbc/INVESDOCDS
Configuración del acceso al Gestor Documental
Ruta del fichero:WEB-INF\classes\IDocStorageCfg.xml
Descripción:Fichero de configuración del gestor documental invesDoc.
Parámetros:Nombre Descripcióndefault_archive_id Identificador del archivador por defecto.ctxpool_name Nombre del datasource de acceso a invesDoc.idocuser_id Identificador de un usuario para conectarse a
invesDoc.temporary_path Directorio temporal para subir ficheros.archive Lista de archivadores con sus metadatos
SGM_2007_10_Manual de Implantación y Configuración v01 Página 45 de 125
Avanza LOCAL SIGEM
Configuración del acceso a SICRES
Ruta del fichero:WEB-INF\classes\sicres.properties
Descripción:Fichero de configuración del acceso a SICRES.
Parámetros:Nombre DescripciónINVESDOC_POOL_NAME Pool de conexiones.SICRES_OFFICE_CODE Código de Oficina del usuario de registro.SICRES_UNIT_CODE Código de la Unidad Administrativa del usuario de
Registro.STAMP_WIDTH Ancho del selloSTAMP_HEIGHT Alto del selloSTAMP_TITLE Etiqueta del título del sello.STAMP_REGISTRY_TYPE Etiqueta del tipo de registro.STAMP_REGISTER_NUMBER Etiqueta del número de registro.STAMP_REGISTER_DATE Etiqueta de la fecha de registro.
SIGEM PublicadorConfiguración del Publicador
Ruta del fichero:WEB-INF\classes\ispac.properties
Descripción:Fichero principal de configuración de la aplicación.
Parámetros:Nombre DescripciónPOOLNAME Nombre del pool de base de datos del tramitador. Por defecto:
POOLNAME=java:comp/env/jdbc/SIGEM_TRAMITADORDSAPPLICATION_NAME Nombre de la aplicación que tratara los hitos activos. Por defecto:
APPLICATION_NAME = PUBLICADOR_SIGEMLOCK_TIME_OUT Máximo tiempo que puede tener bloqueado un hito una
aplicación (en milisegundos). Por defecto:LOCK_TIME_OUT = 3600000
READER.SIGEM_TRAMITADOR Lista de lectores dados de alta en la aplicación. Por defecto:READER.SIGEM_TRAMITADOR=
ieci.tdw.ispac.ispacpublicador.business.reader.sigem.SIGEMReaderHOST Dirección donde se encuentra ejecutandose el OpenOffice.
Por defecto:HOST = localhost
OPEN_OFFICE_CONNECT Cadena conexión para OpenOffice. Por defecto:OPEN_OFFICE_CONNECT= uno:socket,host=localhost,
port=8100;urp;StarOffice.NamingServiceTEMPORARY_PATH Directorio temporal. Por defecto:
TEMPORARY_PATH = C:/temp/temporaryTEMPLATE_PATH Caché de plantillas en disco. Por defecto:
TEMPLATE_PATH = C:/temp/templatesCONNECTOR_MANAGER Indica los tipos de conectores documentales. Los posibles valores
son: database, documentum, invesdoc, filesystem. Por defecto:CONNECTOR_MANAGER = invesdoc
Configuración del acceso al Gestor Documental
Ruta del fichero:
SGM_2007_10_Manual de Implantación y Configuración v01 Página 46 de 125
Avanza LOCAL SIGEM
WEB-INF\classes\IDocStorageCfg.xmlDescripción:
Fichero de configuración del gestor documental invesDoc.Parámetros:
Nombre Descripcióndefault_archive_id Identificador del archivador por defecto.ctxpool_name Nombre del datasource de acceso a invesDoc.idocuser_id Identificador de un usuario para conectarse a
invesDoc.temporary_path Directorio temporal para subir ficheros.archive Lista de archivadores con sus metadatos
Configuración del API de acceso a Tramitación Telemática
Ruta del fichero:WEB-INF\classes\SIGEM_spring.xml
Descripción:Configuración de las implementaciones de los servicios de Tramitación Telemática: Consulta y Notificación Telemáticas.
Ruta del fichero:WEB-INF\classes\database.properties
Descripción:Configuración de la base de datos de Consulta y Notificación Telemáticas.
SIGEM Servicios Web Archivo
Configuración de Servicios Web Archivo
Ruta del fichero:WEB-INF\classes\ispac.properties
Descripción:Fichero principal de configuración de la aplicación.
Parámetros:Nombre DescripciónPOOLNAME Nombre del pool de base de datos del tramitador.
Por defecto: POOLNAME=java:comp/env/jdbc/SIGEM_TRAMITADORDS
TABLA_PRODUCTORES Nombre de la tabla de validación de sistemas productores. Por defecto:
TABLA_PRODUCTORES=SPAC_TBL_007TABLA_INTERESADOS Nombre de la tabla de validación de los interesados. Por
defecto:
TABLA_INTERESADOS=SPAC_TBL_002CONNECTOR_MANAGER Indica los tipos de conectores documentales. Los posibles
valores son: database, documentum, invesdoc, filesystem. Por defecto:
CONNECTOR_MANAGER = invesdocRDE_ARCHIVE_ID Identificador del repositorio de custodiaREPOSITORY Código del repositorio para los documentos firmados
SGM_2007_10_Manual de Implantación y Configuración v01 Página 47 de 125
Avanza LOCAL SIGEM
Configuración del acceso al Gestor Documental
Ruta del fichero:WEB-INF\classes\IDocStorageCfg.xml
Descripción:Fichero de configuración del gestor documental invesDoc.
Parámetros:Nombre Descripcióndefault_archive_id Identificador del archivador por defecto.ctxpool_name Nombre del datasource de acceso a invesDoc.idocuser_id Identificador de un usuario para conectarse a
invesDoc.temporary_path Directorio temporal para subir ficheros.archive Lista de archivadores con sus metadatos
5.2.1 Despliegue y ejecución de las aplicaciones web
Para desplegar las aplicaciones en el servidor de aplicaciones, se deberán seguir los siguientes pasos:
1. Parar el servidor de aplicaciones Tomcat.2. Copiar los siguientes ficheros (se adjuntan en el directorio webapps)
a la ruta %TOMCAT_HOME%\webapps:- archivo.war- ispaccatalog.war- ispacmgr.war- ispacpublicador.war- ispacwsarchivo.war - SIGEM_TramitacionWS.war- SIGEM_TercerosWS.war
3. Arrancar el servidor de aplicaciones Tomcat.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 48 de 125
Avanza LOCAL SIGEM
5.2.2 Acceso a las aplicaciones
La gestión de usuarios se realiza mediante el Administrador de usuarios de invesDoc.El usuario administrador de invesDoc, por defecto ,va a ser:
Usuario: SYSSUPERUSERClave: SYSPASSWORD
SIGEM Archivo
Ruta de acceso http://<servidor>:<puerto>/archivoUsuarios sigem / sigem
sac / sacEs necesario dar de alta estos usuarios y darles los permisos y grupos de usuario
que se desee en la aplicación de archivo cuando se entra por primera vez utilizando para ello el usuario SYSSUPERUSER.
SIGEM Catálogo
Ruta de acceso http://<servidor>:<puerto>/ ispaccatalogUsuarios sigem / sigem
SIGEM Tramitador
Ruta de acceso http://<servidor>:<puerto>/ ispacmgrUsuarios sigem / sigem
sac / sac
SIGEM Publicador
Ruta de acceso http://<servidor>:<puerto>/ ispacpublicador
SGM_2007_10_Manual de Implantación y Configuración v01 Página 49 de 125
Avanza LOCAL SIGEM
5.3Archivo
5.3.1 Creación de Base de Datos
Para crear una base de datos, se utilizará el programa pgadmin3 que se puede instalar mediante Yast. Como ejemplo de incorporación de búsqueda documental, se utilizarán las tablas de Archivo, que incluyen búsqueda documental.
Se añadirá un nuevo servidor mediante archivo Añadir servidor:
Se creará un nuevo tablespace para la base de datos de prueba. Como primer paso, se creará un subdirectorio en el directorio de tablespaces creado anteriormente mediante el comando de sistema “mkdir /usr/local/pgsql/pruebatablespaces/archivo” y se añadirá el tablespace en el pgadmin3:
SGM_2007_10_Manual de Implantación y Configuración v01 Página 50 de 125
Avanza LOCAL SIGEM
Se creará la nueva base de datos:
Se añadirán a la base de datos recién creada, los complementos compilados anteriormente y necesarios para el correcto funcionamiento de la aplicación:
psql -U postgres -h localhost -d archivo < /usr/local/pgsql/share/contrib/adminpack.sql
SGM_2007_10_Manual de Implantación y Configuración v01 Página 51 de 125
Avanza LOCAL SIGEM
psql -U postgres -h localhost -d archivo < /usr/local/pgsql/share/contrib/tablefunc.sqlpsql -U postgres -h localhost -d archivo < /usr/local/pgsql/share/contrib/tsearch2.sql
Se creará un nuevo lenguaje para poder importar las funciones que necesita la aplicación de archivo:
En este punto ya se pueden crear e importar los datos de todas las tablas de archivo:
psql -U postgres -h localhost -d archivo < /tmp/limpia/create_tables.sqlpsql -U postgres -h localhost -d archivo < /tmp/limpia/insert_data.sqlpsql -U postgres -h localhost -d archivo < /tmp/limpia/insert_clob.sqlpsql -U postgres -h localhost -d archivo < /tmp/limpia/create_functions.sql
Se copiarán los ficheros necesarios para búsqueda documental (spanish.aff, spanish.med, spanish.stop) en /usr/local/pgsql/share/contrib/
Se ejecutará el script para incorporar búsqueda documental2:
psql -U postgres -h localhost -d archivo < /tmp/limpia/create_documentary_search.linux.sql
2 En caso de que la cadena de encoding devuelta por el comando locale no sea es_ES@euro se debe actualizar el script create_documentary_search.linux.sql y cambiar el insert en pg_ts_cfg con el valor que devuelve el comando locale
SGM_2007_10_Manual de Implantación y Configuración v01 Página 52 de 125
createlang plpgsql archivo
Avanza LOCAL SIGEM
5.3.2 Adaptación del producto
Para realizar la adaptación del producto, se partirá de la distribución del mismo en formato WAR. La primera tarea que es necesario realizar es la descompresión del archivo WAR en un directorio local utilizando los descompresores habituales (winzip o winrar). Al descomprimirlo, comprobaremos que se ha creado la estructura completa de directorios que representan la aplicación.
A continuación se detallarán los cambios que es necesario realizar en cada uno de los ficheros/directorios implicados en la adaptación y el lugar concreto en el que se ubican los mismos.
Una vez realizados todos los cambios indicados en los apartados siguientes, se deberá generar de nuevo el archivo WAR con la misma herramienta utilizada para la descompresión (preferiblemente winzip) y ya podrá ser desplegado en el servidor totalmente adaptado a la organización en cuestión.
Adaptación de imágenes
Para adaptar SIGEM a la imagen de una organización es necesario sustituir los logotipos proporcionados por defecto en la aplicación, utilizando exactamente los mismos nombres de archivo y ubicaciones que los originales.
La relación de imágenes y logotipos a sustituir se detalla a continuación. A la ruta indicada en la ubicación sería necesario anteponerle la ruta en la que se ha descomprimido el WAR.
Imágenes de informes
Las imágenes utilizadas en los informes se localizan en la siguiente ubicación:
Sigem\webapp\WEB-INF\reports\images\
La relación de las que sería necesario sustituir es la siguiente:
Fichero Descripción
fondo.png(232 x 476 px)
Imagen corporativa de fondo de las páginas de los informes PDF generados por la aplicación y que puede ser sustituida por otra específica de la organización.
logo_archivo.gif(177 x 85 px)
Imagen representativa del producto SIGEM que aparecerá en la parte superior derecha de los informes PDF generados por la aplicación y que puede ser sustituida por otra específica de la organización.
logo_cartela.gif(213 x 406 px)
Imagen corporativa que aparecerá en la parte superior central de las cartelas PDF generadas en la aplicación y que debe ser sustituida por una propia de la organización.
logo_organizacion.gif Imagen corporativa que aparecerá en la parte superior
SGM_2007_10_Manual de Implantación y Configuración v01 Página 53 de 125
Avanza LOCAL SIGEM
(181 x 64 px) izquierda de los informes PDF generados por la aplicación y que puede ser sustituida por otra específica de la organización.
Imágenes del árbol menú izquierdo
Las imágenes utilizadas en el árbol menú izquierdo se localizan en la siguiente ubicación:
Sigem\webapp\ pages\images\arboles
La relación de las que sería necesario sustituir es la siguiente:
Fichero Descripción
fondo_menu.jpg(434 x 451 px)
Imagen corporativa de fondo del árbol menú situado en la parte izquierda de las ventanas de la aplicación y que puede ser sustituida por otra específica de la organización.
icono_raiz.gif(16 x 16 px)
Icono corporativo que aparece como raíz del árbol del menú y que puede ser sustituido por uno específico de la organización.
Imágenes de entrada a la aplicación y de cabecera
Las imágenes utilizadas en la entrada a la aplicación y en la cabecera común a todas las ventanas se localizan en la siguiente ubicación:
Sigem\webapp\pages\images\logo
La relación de las que sería necesario sustituir es la siguiente:
Fichero Descripción
cabecera.jpg(750 x 63 px)
Imagen de cabecera común a todas las ventanas de la aplicación excepto la de entrada y que puede ser sustituida por otra específica de la organización.
ico_archivo.jpg(112 x 26 px)
Imagen representativa del producto SIGEM que aparecerá en la parte superior derecha de la imagen de cabecera y que puede ser sustituida por una específica de la organización.
logo_archivo.jpg(313 x 150 px)
Imagen representativa del producto SIGEM que aparecerá en la ventana de entrada a la aplicación y que puede ser sustituida por una específica de la organización.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 54 de 125
Avanza LOCAL SIGEM
Adaptación de textos
Dentro de la aplicación existen varias referencias textuales a la organización para la que se va a instalar. Estas referencias textuales se encuentran localizadas en un fichero dentro de la aplicación que será necesario modificar para adaptarlas a la instalación concreta que se va a realizar.
El fichero se está localizado en la siguiente ruta:
Sigem\src\java\resources\OrganizationResources.properties
Todas las cadenas que aparecen en el fichero deben ser adaptadas a la organización.
La lista de cadenas junto con su descripción se muestra a continuación.
Textos generales
Estos textos aparecen en diferentes partes de la aplicación.
Cadena Descripción
organizacion.nombreCompleto Nombre completo de la organizaciónorganización.copyright Texto que aparecerá como copyrightorganizacion.archivo.informe.cartelas.archivo.organizacion
Nombre completo de la organización en mayúsculas
Textos de aviso legal
Estos textos aparecen en la página de aviso legal de la aplicación y están divididos en varios párrafos opcionales.
Cadena Descripción
organizacion.aviso_legal.parrafo1 Primer párrafo del aviso legalorganizacion.aviso_legal.parrafo2 Segundo párrafo del aviso legalorganizacion.aviso_legal.parrafo3 Tercer párrafo del aviso legalorganizacion.aviso_legal.parrafo4 Cuarto párrafo del aviso legalorganizacion.aviso_legal.parrafo5 Quinto párrafo del aviso legalorganizacion.aviso_legal.parrafo6 Sexto párrafo del aviso legal
SGM_2007_10_Manual de Implantación y Configuración v01 Página 55 de 125
Avanza LOCAL SIGEM
Texto de informes
Estos textos aparecerán en los informes PDF generados por la aplicación.
Cadena Descripción
organizacion.archivo.informe.titulo Texto que aparecerá como título del informe en la parte superior centrada del mismo
organizacion.archivo.informe.subtitulo1 Texto que aparecerá como primer subtítulo del informe en la parte superior centrada del mismo
organizacion.archivo.informe.subtitulo2 Texto que aparecerá como segundo subtítulo del informe en la parte superior centrada del mismo
organizacion.archivo.informe.subtitulo3 Texto que aparecerá como tercer subtítulo del informe en la parte superior centrada del mismo
organizacion.archivo.informe.direccion Texto que aparecerá como dirección postal de la organización en la parte inferior o pie de página de los informes
Texto del área de transferencias
Estos textos aparecerán en el área de transferencias de la aplicación.
Cadena Descripción
organizacion.archivo.transferencias.paisDefecto
Texto que representa el país en el que se localizarán las ubicaciones origen en las transferencias extraordinarias.
organizacion.archivo.transferencias.comunidadDefecto
Texto que representa la comunidad en el que se localizarán las ubicaciones origen en las transferencias extraordinarias.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 56 de 125
Avanza LOCAL SIGEM
Adaptación de informes
Los informes PDF de la aplicación son generados dinámicamente a partir de ficheros jasper compilados con la aplicación IReport (versión 0.4.0). Estos ficheros están dentro de la aplicación en la siguiente ubicación (considerada a partir de la ruta en la que se haya descomprimido el WAR):
Sigem/webapp/WEB-INF/reports
Existe un fichero xml por cada fichero jasper. Para modificar un informe, bastará con abrirlo desde la aplicación IReport, hacer las modificaciones de diseño que se consideren oportunas (teniendo en cuenta que no se podrán añadir nuevos parámetros puesto que se les da valor en el código de la aplicación) y compilar de nuevo el fichero xml modificado, con lo que se generará un nuevo fichero jasper con el que habrá que sobrescribir el original.
Dentro del IReport, se recomienda seleccionar como directorio de compilación, la propia ruta donde se encuentran los informes (Tools > Options > Compiler), de esta manera, el proceso de modificación del xml y sobrescritura del jasper será directo.
Adaptación de sistemas externos
Fichero de configuración del sistema
Para comunicarse con sistemas externos habrá que tener en cuenta el fichero de configuración del sistema, que estará ubicado donde indique el parámetro de inicialización de la aplicación archivo.cfg.file dentro del fichero
Archivo/webapp/WEB-INF/web.xml
de la aplicación.
En el fichero de configuración se indica, entre otras cosas, sobre qué sistemas externos está corriendo la aplicación. Su estructura es la siguiente:
<?xml version="1.0" encoding="ISO-8859-1"?><Configuracion_Sistema_Archivo Version="01.00"> <Sistemas_Gestores_Organismos> <Sistemas_Externos> <Sistema> <Id>ORGXML</Id> <Nombre>Organizacion</Nombre> <Clase>se.instituciones.DefaultGestorOrganismoImpl</Clase> </Sistema> </Sistemas_Externos> <Sistema_Interno> <Id>ARCHIVO</Id> <Clase>se.instituciones.archivo.GestorOrganismoArchivo</Clase> </Sistema_Interno> </Sistemas_Gestores_Organismos> <Sistemas_Gestores_Usuarios> <Sistema> <Id>USRXML</Id> <Nombre>Usuarios</Nombre> <Clase>se.autenticacion.DefaultAuthenticationConnectorImpl</Clase> </Sistema>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 57 de 125
Avanza LOCAL SIGEM
</Sistemas_Gestores_Usuarios> <Sistema_Gestor_Catalogo> <Id_SistGestor_Org>CTLGXML</Id_SistGestor_Org> <Clase>se.procedimientos.DefaultGestorCatalogoImpl</Clase> </Sistema_Gestor_Catalogo> <Sistemas_Tramitadores> <Sistema> <Id>04</Id> <Nombre>Tramitador</Nombre> <Id_SistGestor_Org>ORGXML</Id_SistGestor_Org> <Clase>se.tramites.DefaultSistemaTramitadorImpl</Clase> </Sistema> </Sistemas_Tramitadores> <Sistema_Gestor_Geograficos> <Id>GEOGRXML</Id> <Clase>se.geograficos.DefaultGestorGeograficosImpl</Clase> </Sistema_Gestor_Geograficos> <Sistema_Gestor_Terceros> <Id>TERCEROSXML</Id> <Clase>se.terceros.DefaultGestorTercerosImpl</Clase> </Sistema_Gestor_Terceros><!-- A partir de versión 2.1.1 --> <Sistema_Gestor_Repositorio_Electronico> <Id>REP</Id> <Clase>se.repositorios.archigest.GestorRepositorioArchigest</Clase> </Sistema_Gestor_Repositorio_Electronico><!--> <Configuracion_ControlAcceso> <Usuarios> <Usuario Tipo="1"> <Nombre_Tipo>Interno</Nombre_Tipo> <Id_SistGestor_Usr>USRXML</Id_SistGestor_Usr> <Id_SistGestor_Org>ORGXML</Id_SistGestor_Org> </Usuario> <Usuario Tipo="2"> <Nombre_Tipo>Asociado</Nombre_Tipo> <Id_SistGestor_Usr>USRXML</Id_SistGestor_Usr> <Id_SistGestor_Org>ARCHIVO</Id_SistGestor_Org> </Usuario> <Usuario Tipo="3"> <Nombre_Tipo>Externo</Nombre_Tipo> <Id_SistGestor_Usr>USRXML</Id_SistGestor_Usr> </Usuario> </Usuarios> <Perfil_Usuarios_Externos>ID_ROL_USUARIOS_EXTERNOS</Perfil_Usuarios_Externos> </Configuracion_ControlAcceso> <Configuracion_Servicios> <Prestamos> <Plazo>30</Plazo> <Plazo_tras_reclamacion>10</Plazo_tras_reclamacion> <Plazo_Reserva>30</Plazo_Reserva> <Plazo_Prorroga>30</Plazo_Prorroga> </Prestamos> </Configuracion_Servicios> <Configuracion_Descripcion> <Campos_Descriptivos> <Fecha_Extrema_Inicial>3</Fecha_Extrema_Inicial> <Fecha_Extrema_Final>4</Fecha_Extrema_Final> <Id_Tercero_Interesado>51</Id_Tercero_Interesado> </Campos_Descriptivos> <Plantillas_XSL> <Consulta>C:/desarrollo/java/WEBAPPS/archivo/archivo/config/templateConsultaFicha.xsl</Consulta> <Edicion>C:/desarrollo/java/WEBAPPS/archivo/archivo/config/templateEdicionFicha.xsl</Edicion> </Plantillas_XSL> </Configuracion_Descripcion> <Configuracion_Auditoria> <Plantilla_XSL>C:/desarrollo/java/WEBAPPS/archivo/archivo/config/transformLogTemplate.xsl</Plantilla_XSL> </Configuracion_Auditoria>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 58 de 125
Avanza LOCAL SIGEM
<Configuracion_Fondos> <Instituciones_Productoras> <Id_SistGestor_Org>ORGXML</Id_SistGestor_Org> </Instituciones_Productoras> <Lista_Paises_Mapping_File>/MapPaises.xml</Lista_Paises_Mapping_File> <Rules_Processing_Paises_Mapping_File>/rules_mapPaises.xml</Rules_Processing_Paises_Mapping_File> <Rules_Processing_Identificacion_Serie>/rules_identificacion_serie.xml</Rules_Processing_Identificacion_Serie>
<Directorio_Logs_Eliminacion>c:\\</Directorio_Logs_Eliminacion> <Delimitador_Codigo_Referencia>/</Delimitador_Codigo_Referencia> <Tabla_Validacion_Boletines_Oficiales>ID_TBLVLD_BOLETINES_OFICIALES</Tabla_Validacion_Boletines_Oficiales> </Configuracion_Fondos> <Configuracion_Transferencias> <Udoc_Fields_Mapping_File>/MapUDocRel.xml</Udoc_Fields_Mapping_File> <Rules_Processing_Info_Unidad_Documental>/rules_xinfo_unidad_documental.xml</Rules_Processing_Info_Unidad_Documental> <Tabla_Validacion_Rol_Interesado>ID_TBLVLD_ROLES_INTERESADO</Tabla_Validacion_Rol_Interesado> <Tabla_Validacion_Forma_Documental>ID_TBLVLD_FORMAS_DOCUMENTALES</Tabla_Validacion_Forma_Documental> <Pais> <Codigo>108</Codigo> <Nombre>España</Nombre> </Pais> <Provincia> <Codigo>33</Codigo> <Nombre>Navarra</Nombre> </Provincia> </Configuracion_Transferencias> <Configuracion_Documentos_Vitales> <Id_Lista_Volumenes>1</Id_Lista_Volumenes> </Configuracion_Documentos_Vitales> <Configuracion_General> <Data_Source>java:comp/env/jdbc/archivoDS</Data_Source> <Periodo_Maximo_Bloqueo>1440</Periodo_Maximo_Bloqueo> <Periodo_Evento_Sesion>60</Periodo_Evento_Sesion> <Keep_alive>60000</Keep_alive> <Tabla_Validacion_Soporte>ID_TBLVLD_SOPORTE</Tabla_Validacion_Soporte> <Tabla_Validacion_Formato>ID_TBLVLD_FORMATO</Tabla_Validacion_Formato> <Numero_Maximo_Resultados>500</Numero_Maximo_Resultados> <!-- A partir de versión 2.1 --> <Numero_Resultados_Por_Pagina>15</Numero_Resultados_Por_Pagina> <Numero_Maximo_Intentos>3</Numero_Maximo_Intentos> <!--> <DB_Factory_Class>common.db.DBEntityFactorySqlServer2000</DB_Factory_Class> <Listas_Descriptoras_Productores> <lista productor="Institucion" tipoproductor="1">ID_LIST_INSTITUCION</lista> <lista productor="Familia" tipoproductor="2">ID_LIST_FAMILIA</lista> <lista productor="Persona" tipoproductor="3">ID_LIST_PERSONA</lista> <lista productor="Organo" tipoproductor="4">ID_LIST_ORGANO</lista> <lista productor="BDOrganizacion" tipoproductor="5">ID_LIST_BDORGANIZACION</lista> </Listas_Descriptoras_Productores> <Encriptacion> <Algoritmo>AES</Algoritmo> <Clave_Secreta>YWJjMTIzZGVmNDU2Z2g3OA==</Clave_Secreta> </Encriptacion> <Usuario_Anonimo_Servicios_Web> <Usuario>SYSSUPERUSER</Usuario> <Clave>SYSPASSWORD</Clave> </Usuario_Anonimo_Servicios_Web> <!-- A partir de versión 2.1 --> <Superusuario_Sistema_Archivo>
<Usuario>SYSSUPERUSER</Usuario><Clave>U1lTUEFTU1dPUkQ=</Clave><Clase>se.autenticacion.ConfigAuthenticationConnectorImpl</Clase><TipoUsuario>1</TipoUsuario><IdExterno>0</IdExterno>
</Superusuario_Sistema_Archivo> <!-->
SGM_2007_10_Manual de Implantación y Configuración v01 Página 59 de 125
Avanza LOCAL SIGEM
</Configuracion_General></Configuracion_Sistema_Archivo>
Configuración de Sistemas Gestores de Organismos
Información acerca de los sistemas gestores de organización que se pueden utilizar dentro del sistema para recuperar información de los órganos productores.
Definición
<Sistemas_Gestores_Organismos>
<Sistemas_Externos>
<Sistema>
</Sistema> .
.
. <Sistema>
</Sistema>
</Sistemas_Externos>
<Sistema_ Interno>
</Sistema_Interno>
</Sistemas_Gestores_Organismos>
Configuración de Sistemas Externos
Definición de los sistemas gestores externos a los que puede preguntar el sistema para obtener la información de la jerarquía entre los órganos y la relación entre órganos y usuarios que son utilizados dentro del sistema.
<Sistemas_Externos>
<Sistema>
<Id> </Id>
<Nombre></Nombre>
<Clase></Clase>
<init-param>
<param-name>…</param-name>
<param-value>…</param-value>
</init-param>
…
</Sistema> …</Sistemas_Externos>
Configuración de un Sistema Externo
Información de un sistema gestor externo de organización.
<Sistema>
<Id></Id>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 60 de 125
Avanza LOCAL SIGEM
<Nombre></Nombre>
<Clase></Clase>
<init-param>
<param-name>…</param-name>
<param-value>…</param-value>
</init-param>
…
</Sistema>
La información que es necesario indicar para cada sistema es la siguiente:
Campo Descripción
Id Identificador del sistema, único entre los demás sistemas gestores de organismos.
Nombre Nombre que se asigna al enlace, dentro de la aplicación de archivo, con este sistema. También debe ser único entre los demás sistemas gestores de organismos.
Clase Clase que implemente el interfaz GestorOrganismos (ver punto 2 del documento).
init-param Parámetro opcional para indicar de configuración del sistema.
Campo Descripciónparam-name Nombre del parámetro de configuración del sistema.param-value Valor del parámetro de configuración del sistema.
Sistemas externos soportados
XML (Defecto)
Campo Valor
Id [ID_SISTEMA_EXTERNO_ORGANIZACION_XML]Nombre NOMBRE_SISTEMA_EXTERNO_ORGANIZACIÓN_XML]Clase se.instituciones.DefaultGestorOrganismoImpl
Invesdoc (v.9.2)
Campo Valor
Id [ID_SISTEMA_EXTERNO_ORGANIZACION_INVESDOC]Nombre [NOMBRE_SISTEMA_EXTERNO_ORGANIZACIÓN_INVESDOC]Clase se.instituciones.archivo.invesdoc.GestorOrganismoInvesdoc
Configuración de Sistema Interno
Definición del sistema que mantiene la relación, en un periodo determinado, entre órganos procedentes de sistemas externos de organismos dados de alta en el sistema de archivo, con usuarios que también están incluidos en el sistema de archivo
SGM_2007_10_Manual de Implantación y Configuración v01 Página 61 de 125
Avanza LOCAL SIGEM
Campo Descripción
Id Identificador del sistema, único entre los demás sistemas gestores de organismos..
Clase Clase que implemente el interfaz GestorOrganismos (ver punto 2 del documento).
init-param Parámetro opcional para indicar de configuración del sistema.
Campo Descripciónparam-name Nombre del parámetro de configuración del sistema.param-value Valor del parámetro de configuración del sistema.
Configuración de Sistemas Gestores de Usuarios
Definición
Información acerca de los sistemas gestores de usuarios que se pueden utilizar dentro de la aplicación de Archivo para realizar la autenticación.
<Sistemas_Gestores_Usuarios>
<Sistema>
<Id> </Id>
<Nombre></Nombre>
<Clase></Clase>
<init-param>
<param-name>…</param-name>
<param-value>…</param-value>
</init-param>
…
</Sistema> …</Sistemas_Gestores_Usuarios>
Configuración de Sistema
Información de un sistema gestor de usuarios.
<Sistema>
<Id> </Id>
<Nombre></Nombre>
<Clase></Clase>
<init-param>
<param-name>…</param-name>
<param-value>…</param-value>
</init-param>
…
</Sistema>
La información que es necesario indicar para cada sistema es la siguiente:
Campo Descripción
Id Identificador del sistema, único entre los demás sistemas gestores de usuarios.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 62 de 125
Avanza LOCAL SIGEM
Nombre Nombre que se asigna al enlace, dentro de la aplicación de archivo, con este sistema. También debe ser único entre los demás sistemas gestores de usuarios.
Clase Clase que implemente la funcionalidad de autenticación. (ver punto 2 del documento).
init-param Parámetro opcional para indicar de configuración del sistema.Campo Descripciónparam-name Nombre del parámetro de configuración del sistema.param-value Valor del parámetro de configuración del sistema.
Interfaces con sistemas gestores de usuarios
Sistema Versión
XML (Defecto) 2.0Servicio Web 2.0Invesdoc 9.2 2.0LDAP A partir de versión 2.0
XML (Defecto)
Campo Valor
Id [ID_SISTEMA_GESTOR_USUARIOS_XML]Nombre [NOMBRE_SISTEMA_GESTOR_USUARIOS_XML]Clase se.autenticacion.DefaultAuthenticationConnectorImpl
Servicio Web
Campo Valor
Id [ID_SISTEMA_GESTOR_USUARIOS_SERVICIO_WEB]Nombre [NOMBRE_SISTEMA_GESTOR_USUARIOS_SERVICIO_WEB]Clase se.instituciones.archigest.GestorOrganismoArchigestinit-param
Parámetro Descripción ValorWSDL_LOCATION Parámetro que indicará la URL
de la definición WSDL del servicio web de autenticación de usuarios.
URL del WSDL del servicio web de autenticación de usuarios.
Invesdoc (v.9.2)
Campo Valor
Id [ID_SISTEMA_GESTOR_USUARIOS_INVESDOC]Nombre [NOMBRE_SISTEMA_GESTOR_USUARIOS_INVESDOC]Clase se.autenticacion.idoc.InvesDocConnector
SGM_2007_10_Manual de Implantación y Configuración v01 Página 63 de 125
Avanza LOCAL SIGEM
LDAP (Java Directory Server 5.2 P4 / (Protocolo IPlanet), Active Directory 5.2)3
Campo Valor
Id [ID_SISTEMA_GESTOR_USUARIOS_LDAP]Nombre [NOMBRE_SISTEMA_GESTOR_USUARIOS_LDAP]Clase se.autenticacion.ldap.LdapConnectorinit-param
Parámetro Descripción ValorENGINE Indica quién implementa el
protocolo LDAP.Los posibles valores son1 Si lo implementa Active Directory2 Si lo implementa iPlanet3 Si lo implementa OpenLdap
PROVIDER Proveedor de LDAP. Los posibles valores son1 Si el proveedor es SUN
URL URL de conexión al servidor de LDAP
URL de conexión al servidor LDAP
USER_DEFAULT Usuario por defecto de LDAP. Para realizar autenticaciones y búsquedas de usuarios, es necesario conectarse previamente a LDAP por lo que es necesario disponer de un usuario.
Usuario por defecto de LDAP
PASSWORD_DEFAULT Contraseña del usuario por defecto
Contraseña del usuario por defecto
USER_START Nodo a partir del cual se realizan las búsquedas de usuarios.
Nodo inicial
USER_SCOPE Punto de comienzo de una búsqueda de LDAP y la profundidad desde la base DN a la que la búsqueda podría acceder
Los posibles valores son
0 BASE: Sólo se busca en el nodo inicial de la BASE DN
1. ONELEVEL: Sólo se busca en los nodos del nivel inferior al nodo inicial de la BASE DN, pero no en este último
2. SUBTREE: Se realiza la búsqueda en todos los nodos a partir del nodo inicial de la Base DN y también en este último
USER_ATTRIBUTE Atributo que se corresponde con el valor de nombre de usuario.
Atributo que se corresponde con el valor de nombre de usuario.
POOLING Indica si se está usando un pool de conexiones.
N (No)S (Si)
POOLING_TIMEOUT Indica el tamaño del pool de conexiones.
Si no se utiliza se asigna el valor 0.
FILE_USER_ATTRIBUT Indica la ruta donde se Ruta del fichero de
3 Consultar documentación específica de LDAP
SGM_2007_10_Manual de Implantación y Configuración v01 Página 64 de 125
Avanza LOCAL SIGEM
ES encuentra el archivo de configuración de atributos de LDAP.
configuración de atributos de LDAP.
Configuración de Sistema Gestor del Catálogo de Procedimientos
Definición
Información acerca del sistema gestor de catálogo de procedimientos que se puede utilizar dentro de la aplicación de Archivo.
<Sistema_Gestor_Catálogo>
<Id_SistGestor_Org></ Id_SistGestor_Org>
<Clase></Clase>
<init-param>
<param-name>…</param-name>
<param-value>…</param-value>
</init-param>
…
</Sistema_Gestor_Catálogo>
La información que es necesario indicar para el sistema gestor del catálogo:
Campo Descripción
Id_SistGestor_Org Identificador del sistema externo de organización que gestiona los órganos asociados a los procedimientos. Tiene que coincidir con un identificador de alguno de los sistemas gestores de organismos definidos en la sección Sistemas_Gestores_Organismos.
Clase Clase que implementa el interfaz GestorCatálogo (ver punto 3 del documento)
init-param Parámetro opcional para indicar de configuración del sistema.Campo Descripciónparam-name Nombre del parámetro de configuración del sistema.param-value Valor del parámetro de configuración del sistema.
Interfaces con sistemas gestores de catálogos de procedimientos
Sistema Versión
XML (Defecto) 2.0Servicio Web 2.0Servicio Web y API (Sigem Core)
2.1.1
XML (Defecto)
Campo Valor
Id [ID_SISTEMA_GESTOR_CATALOGO_XML]Nombre [NOMBRE_SISTEMA_GESTOR_CATALOGO_XML]
SGM_2007_10_Manual de Implantación y Configuración v01 Página 65 de 125
Avanza LOCAL SIGEM
Clase se.procedimientos.DefaultGestorCatalogoImpl
Servicio Web
Campo Valor
Id [ID_SISTEMA_GESTOR_CATALOGO_SERVICIO_WEB]Nombre [NOMBRE_SISTEMA_GESTOR_CATALOGO_SERVICIO_WEB]Clase se.procedimientos.archigest.GestorCatalogoArchigestinit-param
Parámetro Descripción Valor
WSDL_LOCATION
Parámetro que indicará la URL de la definición WSDL del servicio web de gestión del catálogo de procedimientos.
URL del WSDL del servicio web de gestión del catálogo de procedimientos.
Servicio Web y API (Sigem Core)
Campo Valor
Id [ID_SISTEMA_GESTOR_CATALOGO_SERVICIO_WEB_API]Nombre [NOMBRE_SISTEMA_GESTOR_CATALOGO_SERVICIO_WEB_API]Clase se.procedimientos.GestorCatalogoSigeminit-param
Parámetro Descripción Valor
MODE Parámetro que indica si se utiliza API o Web Service para llamar a los métodos.
API o WS
WSDL_LOCATION Parámetro que indicará la URL de la definición WSDL del servicio web de gestión del catálogo de procedimientos (sólo es necesario si el modo es WS).
URL del WSDL del servicio web de gestión del catálogo de procedimientos.
Configuración de Sistemas Tramitadores
Definición
Información acerca de los sistemas tramitadores de expedientes que van a ser transferidos a la aplicación de Archivo.
<Sistemas_Tramitadores>
<Sistema>
<Id> </Id>
<Nombre></Nombre>
<Id_SistGestor_Org></Id_SistGestor_Org>
<Clase></Clase>
<init-param>
<param-name>…</param-name>
<param-value>…</param-value>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 66 de 125
Avanza LOCAL SIGEM
</init-param>
…
</Sistema>…
</Sistemas_Tramitadores>
Configuración de un Sistema Tramitador
Información de un sistema tramitador ó productor de expedientes.
<Sistema>
<Id> </Id>
<Nombre></Nombre>
<Id_SistGestor_Org></Id_SistGestor_Org>
<Clase></Clase>
<init-param>
<param-name>…</param-name>
<param-value>…</param-value>
</init-param>
…
</Sistema>
La información que es necesario indicar para un sistema tramitador es la siguiente:
Campo Descripción
Id Identificador del sistema, único entre los demás sistemas tramitadores.
Nombre Nombre que se asigna al enlace, dentro de la aplicación de archivo, con este sistema.
Id_SistGestor_Org Identificador del sistema externo gestor de organismos de donde se va a recuperar la información del órgano al que pertenece un usuario de este tipo.Valores posibles:
a.- Valor en blanco, cuando un usuario de este tipo no pertenece a ningún órganob.- ARCHIVO, cuando la información del órgano al que pertenece el usuario la gestiona el propio sistema de archivoc.- Alguno de los identificadores de los sistemas gestores de organismos definidos en la sección <Sistemas_Gestores_Organismos>
Clase Clase que implementa el interfaz SistemaTramitador (ver punto 4 del documento).
init-param Parámetro opcional para indicar de configuración del sistema.Campo Descripciónparam-name Nombre del parámetro de configuración
del sistema.param-value Valor del parámetro de configuración del
sistema.
Interfaces con sistemas tramitadores
Sistema Versión
SGM_2007_10_Manual de Implantación y Configuración v01 Página 67 de 125
Avanza LOCAL SIGEM
XML (Defecto) 2.0Servicio Web 2.0Servicio Web y API (Sigem Core)
2.1.1
XML (Defecto)
Campo Valor
Id [ID_SISTEMA_TRAMITADOR_XML]Nombre [NOMBRE_SISTEMA_TRAMITADOR_XML]Clase se.tramites.DefaultSistemaTramitadorImpl
Servicio Web
Campo Valor
Id [ID_SISTEMA_GESTOR_TRAMITATOR_SERVICIO_WEB]Nombre [NOMBRE_SISTEMA_GESTOR_TRAMITADOR_SERVICIO_WEB]Clase se.tramites.archigest.SistemaTramitadorArchigestinit-param
Parámetro Descripción Valor
WSDL_LOCATION
Parámetro que indicará la URL de la definición WSDL del servicio web de obtención de datos del tramitador.
URL del WSDL del servicio web de obtención de datos del tramitador.
Servicio Web y API (Sigem Core)
Campo Valor
Id [ID_SISTEMA_GESTOR_CATALOGO_SERVICIO_WEB_API]Nombre [NOMBRE_SISTEMA_GESTOR_CATALOGO_SERVICIO_WEB_API]Clase se.tramites.SistemaTramitadorSigeminit-param
Parámetro Descripción Valor
MODE Parámetro que indica si se utiliza API o Web Service para llamar a los métodos.
API o WS
WSDL_LOCATION Parámetro que indicará la URL de la definición WSDL del servicio web de obtención de datos del tramitador.
URL del WSDL del servicio web de obtención de datos del tramitador.
Configuración del Sistema Gestor de Geográficos
Definición
SGM_2007_10_Manual de Implantación y Configuración v01 Página 68 de 125
Avanza LOCAL SIGEM
Información acerca del sistema gestor de geográficos.
<Sistema_Gestor_Geográficos>
<Id></Id>
<Clase></Clase>
<init-param>
<param-name>…</param-name>
<param-value>…</param-value>
</init-param>
…
</Sistema_Gestor_ Geográficos>
La información que es necesario indicar para un sistema gestor de geográficos es la siguiente:
Campo Descripción
Id Identificador del sistema externo que gestiona la información y relación entre países, comunidades, poblaciones y localizaciones.
Clase Clase que implementa el interfaz GestorGeográficos (ver punto 5 del documento).
init-param Parámetro opcional para indicar de configuración del sistema.Campo Descripciónparam-name Nombre del parámetro de configuración del
sistema.param-value Valor del parámetro de configuración del sistema.
Interfaces con sistemas gestores de geográficos
Sistema Versión
XML (Defecto) 2.0Servicio Web Por definir
XML (Defecto)
Campo Valor
Id [ID_SISTEMA_GESTOR_GEOGRAFICOS_XML]Nombre [NOMBRE_SISTEMA_GESTOR_GEOGRAFICOS_XML]Clase se.geograficos.DefaultGestorGeograficosImpl
Servicio Web – Por definir
Configuración del Sistema Gestor de Terceros
Definición
Información acerca del sistema que gestiona la base de datos de Terceros.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 69 de 125
Avanza LOCAL SIGEM
Si este apartado no existe en el fichero de configuración, no habrá base de datos de terceros.
<Sistema_Gestor_Terceros>
<Id></Id>
<Clase></Clase>
<init-param>
<param-name>…</param-name>
<param-value>…</param-value>
</init-param>
…
</Sistema_Gestor_Terceros>
La información que es necesario indicar para un sistema gestor de terceros es la siguiente:
Campo Descripción
Id Identificador del sistema externo que gestiona los Terceros.Clase Clase que implementa el interfaz GestorTerceros (ver punto 6 del documento).
init-param Parámetro opcional para indicar de configuración del sistema.Campo Descripciónparam-name Nombre del parámetro de configuración del
sistema.param-value Valor del parámetro de configuración del sistema.
Interfaces con sistemas gestores de terceros
Sistema Versión
XML (Defecto) 2.0Servicio Web Por definirServicio Web y API (Sigem Core)
2.1.1
XML (Defecto)
Campo Valor
Id [ID_SISTEMA_GESTOR_TERCEROS_XML]Nombre [NOMBRE_SISTEMA_GESTOR_TERCEROS_XML]Clase se.terceros.DefaultGestorTercerosImpl
Servicio Web y API (Sigem Core)
Campo Valor
Id [ID_SISTEMA_GESTOR_TERCEROS_SERVICIO_WEB_API]Nombre [NOMBRE_SISTEMA_GESTOR_TERCEROS_SERVICIO_WEB_API]
SGM_2007_10_Manual de Implantación y Configuración v01 Página 70 de 125
Avanza LOCAL SIGEM
Clase se.terceros.sicres.SicresGestorTercerosinit-param
Parámetro Descripción Valor
MODE Parámetro que indica si se utiliza API o Web Service para llamar a los métodos.
API o WS
WSDL_LOCATION Parámetro que indicará la URL de la definición WSDL del servicio web del gestor de terceros.
URL del WSDL del servicio web del gestor de terceros.
Configuración del Sistema Gestor de Repositorio Electrónico
Definición
Información acerca del sistema que gestiona el repositorio electrónico.Si este apartado no existe en el fichero de configuración, no habrá gestor de repositorio electrónico.
<Sistema_Gestor_Repositorio_Electronico>
<Id></Id>
<Clase></Clase>
<init-param>
<param-name>…</param-name>
<param-value>…</param-value>
</init-param>
…
</Sistema_Gestor_Repositorio_Electronico>
La información que es necesario indicar para un sistema de gestor de repositorio electrónico es la siguiente:
Campo Descripción
Id Identificador del sistema externo que gestiona el repositorio electrónico.Clase Clase que implementa el interfaz GestorRepositorio.
init-param Parámetro opcional para indicar de configuración del sistema.Campo Descripciónparam-name Nombre del parámetro de configuración del
sistema.param-value Valor del parámetro de configuración del sistema.
Interfaces con sistemas gestores de repositorio electrónico
Sistema Versión
Servicio Web 2.1.1Servicio Web y API (Sigem Core)
2.1.1
SGM_2007_10_Manual de Implantación y Configuración v01 Página 71 de 125
Avanza LOCAL SIGEM
Servicio Web
Campo Valor
Id [ID_SISTEMA_GESTOR_REPOSITORIO_ELECTRONICO_SERVICIO_WEB]Nombre [NOMBRE_SISTEMA_GESTOR_ REPOSITORIO_ELECTRONICO_SERVICIO_WEB]Clase se.repositorios.archigest.GestorRepositorioArchigestinit-param
Parámetro Descripción Valor
Servicio Web y API (Sigem Core)
Campo Valor
Id [ID_SISTEMA_GESTOR_REPOSITORIO_ELECTRONICO_SERVICIO_WEB_API]Nombre [NOMBRE_SISTEMA_GESTOR_ REPOSITORIO_ELECTRONICO_SERVICIO_WEB_API]Clase se.repositorios.GestorRepositorioSigeminit-param
Parámetro Descripción Valor
MODE Parámetro que indica si se utiliza API o Web Service para llamar a los métodos.
API o WS
Configuración del Control de Acceso
Definición
Información de configuración asociada al sistema de control de acceso.
<Configuración_ControlAcceso>
<Usuarios>
…
</Usuarios>
<Perfil_Usuarios_Externos>ID_ROL_USUARIOS_EXTERNOS</Perfil_Usuarios_Externos></Configuración_ ControlAcceso >
Definición de Usuarios
Información para añadir usuarios al sistema de Archivo.
<Usuarios>
<Usuario Tipo=””>
<Nombre_Tipo> </Nombre_Tipo>
<Id_SistGestor_Usr> </Id_SistGestor_Usr>
<Id_SistGestor_Org></Id_SistGestor_Org>
</Usuario>
…
<Usuario Tipo=””>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 72 de 125
Avanza LOCAL SIGEM
<Nombre_Tipo> </Nombre_Tipo>
<Id_SistGestor_Usr> </Id_SistGestor_Usr>
<Id_SistGestor_Org></Id_SistGestor_Org>
</Usuario>
</Usuarios>
Definición de un usuario
Define características propias para dar de alta un usuario de un tipo determinado.
Campo Descripción Valor
Tipo Atributo con un valor único entre los demás tipos definidos.
Valores posibles: 1 Interno 2 Asociado 3 Externo
Nombre_Tipo Nombre que se muestra en la aplicación al mostrar los tipos posibles de usuarios que se pueden dar de alta en la aplicación
Nombre descriptivo para del tipo de usuario.
Id_SistGestor_Usr Identificador del sistema externo que va a realizar la autenticación de usuarios de este tipo. Tiene que coincidir con un identificador de alguno de los sistemas gestores de usuarios definidos en la sección Sistemas_Gestores_Usuarios.
Uno de los identificadores de sistemas gestores de usuarios.
Id_SistGestor_Org Identificador del sistema externo gestor de organismos de donde se va a recuperar la información del órgano al que pertenece un usuario de este tipo.
Valores posibles:a.- Valor en blanco, cuando un usuario de este tipo no pertenece a ningún órganob.- ARCHIVO, cuando la información del órgano al que pertenece el usuario la gestiona el propio sistema de archivoc.- Alguno de los identificadores de los sistemas gestores de organismos definidos en la sección <Sistemas_Gestores_Organismos>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 73 de 125
Avanza LOCAL SIGEM
Definición de Perfil de Usuarios Externos
Campo Descripción Valor
Perfil_Usuarios_Externos
Por definir Por definir
Configuración de Servicios
Definición
Información de configuración asociada al sistema de control de préstamos y consultas.
<Configuracion_Servicios>
<Préstamos>
<Plazo>30</ Plazo> <Plazo_tras_reclamación>10</Plazo_tras_reclamación>
<Plazo_Reserva>30</Plazo_Reserva>
<Plazo_Prorroga>30</Plazo_Prorroga>
</Préstamos>
</Configuración_Servicios>
Configuración de Préstamos
Información de configuración para los préstamos.
La información que es necesario indicar para configurar los préstamos es la siguiente:
Campo Descripción
Plazo Máximo número de días del que se puede disponer de un préstamo desde el momento que se autoriza.
Plazo_tras_reclamación Máximo número de días que deben pasar hasta el envío de una segunda reclamación. Desde el momento que se envió la primera, si el préstamo no ha sido devuelto.
Plazo_Reserva Máximo número de días del que se puede disponer de un préstamo desde el momento que se fija un día de reserva.
Plazo_Prorroga Número de días en que se amplía la fecha prevista de devolución de un préstamo al serle concedida una prórroga.
Configuración de Descripción
Definición
Información de configuración asociada al sistema de Descripción.
<Configuración_Descripción>
<Campos_Descriptivos>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 74 de 125
Avanza LOCAL SIGEM
<Fecha_Extrema_Inicial>3</ Fecha_Extrema_Inicial> <Fecha_Extrema_Final>4</Fecha_Extrema_Final>
<Id_Tercero_Interesado></Id_Tercero_Interesado>
</Campos_Descriptivos>
<Plantillas_XSL>
<Consulta> </Consulta><Edicion></Edicion>
</Plantillas_XSL>
</Configuración_Descripción>
Configuración de Campos Descriptivos
Información sobre los campos descriptivos cuyo valor se muestra en algunas operaciones del sistema de Archivo.
La información que es necesario indicar para configurar los campos descriptivos es la siguiente:
Campo Descripción
Fecha_Extrema_Inicial Identificador del campo cuyo valor representa la fecha extrema inicial de las unidades documentales.
Fecha_Extrema_Final Identificador del campo cuyo valor representa la fecha extrema final de las unidades documentales.
Id_Tercero_Interesado Identificador del tercero interesado
Configuración de Plantillas XSL
Rutas de las plantillas XSL que se aplicarán a las fichas de descripción.
La información que es necesario indicar para configurar el uso de las plantillas XSL es la siguiente:
Campo Descripción
Consulta Ruta de la plantilla XSL para la ficha de descripción en modo consulta.
Edicion Ruta de la plantilla XSL para la ficha de descripción en modo edición.
Configuración de Auditoria
Definición
Información de configuración asociada al sistema de Auditoría.
<Configuracion_Auditoria><Plantilla_XSL></Plantilla_XSL>
</Configuracion_Auditoria>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 75 de 125
Avanza LOCAL SIGEM
La información que es necesario indicar para configurar la auditoría es la siguiente:
Campo Descripción
Plantilla_XSL Ruta de la plantilla XSL para la presentación de las pistas de auditoría.
Configuración de Fondos
Definición
Información de configuración asociada al sistema de Fondos.
<Configuracion_Fondos><Instituciones_Productoras>
<Id_SistGestor_Org></Id_SistGestor_Org> </Instituciones_Productoras> <Lista_Paises_Mapping_File></Lista_Paises_Mapping_File>
<Rules_Processing_Paises_Mapping_File></Rules_Processing_Paises_Mapping_File><Rules_Processing_Identificacion_Serie></Rules_Processing_Identificacion_Serie>
<Directorio_Logs_Eliminacion></Directorio_Logs_Eliminacion> <Delimitador_Codigo_Referencia></Delimitador_Codigo_Referencia>
<Tabla_Validacion_Boletines_Oficiales></Tabla_Validacion_Boletines_Oficiales></Configuracion_Fondos>
Configuración de Instituciones Productoras
Recoge la información referente a las instituciones productoras de los fondos.
Campo Descripción
Id_SistGestor_Org Identificador del sistema externo gestor de organismos de
donde se va a recuperar la entidad productora a la que
pertenece el fondoLista_Paises_Mapping_file Ruta del fichero XML con la información de los
países.Rules_Processing_Paises_Mapping_file Ruta del fichero XML con las reglas para parsear el
XML con la información de los países.Rules_Processing_Identificacion_Serie Ruta del fichero XML con las reglas para parsear el
XML con la información de la serie.Directorio_Logs_Eliminacion Directorio donde se van a dejar los logs de
eliminación de elementos del cuadro de clasificación.
Delimitador_Codigo_Referencia Separador de los códigos que componen el código de referencia de un elemento del cuadro de clasificación.
Tabla_Validacion_Boletines_Oficiales Identificador de la tabla de validación de los boletines oficiales asociada a un fondo. Se utiliza cuando se va a dictaminar una valoración de una
SGM_2007_10_Manual de Implantación y Configuración v01 Página 76 de 125
Avanza LOCAL SIGEM
serie perteneciente a un fondo.
Configuración de Transferencias
Información de configuración del sistema de Transferencias.
<Configuracion_Transferencias><Udoc_Fields_Mapping_File></Udoc_Fields_Mapping_File><Rules_Processing_Info_Unidad_Documental> </Rules_Processing_Info_Unidad_Documental>
<Tabla_Validacion_Rol_Interesado> </Tabla_Validacion_Rol_Interesado><Tabla_Validacion_Forma_Documental></Tabla_Validacion_Forma_Documental><Pais>
<Codigo>108</Codigo><Nombre>España</Nombre>
</Pais><Provincia>
<Codigo>33</Codigo><Nombre>Asturias</Nombre>
</Provincia></Configuracion_Transferencias>
Campo Descripción
Udoc_Fields_Mapping_File Ruta del fichero XML con la información de las unidades documentales.
Rules_Processing_Info_Unidad_Documental
Ruta del fichero XML con las reglas para parsear el XML con la información de las unidades documentales.
Tabla_Validacion_Rol_Interesado Identificador de la Lista de Valores que contiene los valores de los posibles roles de un tercero en un expediente o unidad documental: campo ID del registro correspondiente en la tabla ADCTLGTBLVLD.
Tabla_Validacion_Forma_Documental Identificador de la tabla de validación de la forma documental asociada a una transferencia.
Pais Información del país donde se va a implantar la aplicación.
Provincia Información de la provincia donde se va a implantar la aplicación.
Configuración de Documentos Vitales
Refleja la lista de volúmenes que se utiliza para almacenar los documentos vitales.
<Configuracion_Documentos_Vitales> <Id_Lista_Volumenes></Id_Lista_Volumenes> </Configuracion_Documentos_Vitales>
Campo Descripción
SGM_2007_10_Manual de Implantación y Configuración v01 Página 77 de 125
Avanza LOCAL SIGEM
Id_Lista_Volumenes Identificador de la lista de volúmenes que se utiliza para almacenar los documentos vitales.
Configuración General
Información de configuración, utilizada de forma general en el sistema.
<Configuracion_General> <Data_Source> </Data_Source> <Periodo_Maximo_Bloqueo></Periodo_Maximo_Bloqueo> <Periodo_Evento_Sesion></Periodo_Evento_Sesion> <Keep_alive></Keep_alive> <Tabla_Validacion_Soporte></Tabla_Validacion_Soporte> <Tabla_Validacion_Formato></Tabla_Validacion_Formato> <Numero_Maximo_Resultados></Numero_Maximo_Resultados> <!-- A partir de versión 2.1 --> <Numero_Resultados_Por_Pagina></Numero_Resultados_Por_Pagina> <Numero_Maximo_Intentos></Numero_Maximo_Intentos> <!--> <DB_Factory_Class></DB_Factory_Class> <Listas_Descriptoras_Productores> <lista productor="Institucion" tipoproductor="1">ID_LIST_INSTITUCION</lista> <lista productor="Familia" tipoproductor="2">ID_LIST_FAMILIA</lista> <lista productor="Persona" tipoproductor="3">ID_LIST_PERSONA</lista> <lista productor="Organo" tipoproductor="4">ID_LIST_ORGANO</lista> <lista productor="BDOrganizacion" tipoproductor="5">ID_LIST_BDORGANIZACION</lista> </Listas_Descriptoras_Productores> <Encriptacion> <Algoritmo></Algoritmo> <Clave_Secreta> </Clave_Secreta> </Encriptacion> <Usuario_Anonimo_Servicios_Web> <Usuario> </Usuario> <Clave> </Clave> </Usuario_Anonimo_Servicios_Web> <!-- A partir de versión 2.1 --> <Superusuario_Sistema_Archivo>
<Usuario>SYSSUPERUSER</Usuario><Clave>U1lTUEFTU1dPUkQ=</Clave><Clase>se.autenticacion.ConfigAuthenticationConnectorImpl</Clase><TipoUsuario>1</TipoUsuario><IdExterno>0</IdExterno>
</Superusuario_Sistema_Archivo> <!--> </Configuracion_General>
Campo Descripción
Data_Source Nombre del origen de datos de la aplicación.Periodo_Maximo_Bloqueo Periodo, expresado en minutos, que se puede tener bloqueado un
objeto del sistemaPeriodo_Evento_Sesión Periodo, expresado en minutos, que debe transcurrir entre cada
llamada al evento que mantiene la sesión válida.Keep_alive Tiempo que se va a mantener la sesión activa.Tabla_Validacion_Soporte OBSOLETOTabla_Validacion_Formato Por definirNumero_Maximo_Resultados
Número máximo de resultados que puede proporcionar una consulta
SGM_2007_10_Manual de Implantación y Configuración v01 Página 78 de 125
Avanza LOCAL SIGEM
Numero_Maximo_Intentos(A partir de la versión 2.0)
Indica el número máximo de intentos que tiene un usuario para autenticarse.
Numero_Resultados_Por_Pagina (A partir de la versión 2.0)
Indica el número de registros por página del displaytag para las consultas de búsqueda
DB_Factory_Class Clase factoría a utilizar en función de la base de datos de la aplicación.
BBDD ValorSqlServer common.db.DBEntityFactorySqlServer2000Oracle common.db.DBEntityFactoryOracle9iPostgreSQL common.db. DBEntityFactoryPostgreSQL
Listas_Descriptoras_Productores Conjunto de listas descriptoras de los productores.productor tipo listaInstitución 1 [ID_LIST_INSTITUCION]Familia 2 [ID_LIST_FAMILIA]Persona 3 [ID_LIST_PERSONA]Órgano 4 [ID_LIST_ORGANO]BDOrganizacion 5 [ID_LIST_BDORGANIZACION]
Encriptacion Por definirUsuario_Anonimo_Servicios_Web Por definirSuperusuario_Sistema_Archivo(A partir de la versión 2.0)
Configuración del superusuario de la aplicación cuya autenticación no utiliza sistemas externos.Campo ValorUsuario Nombre de UsuarioClave Contraseña encriptada de UsuarioClase se.autenticacion.ConfigAuthenticationConnectorImplTipoUsuario Tipo de usuario del superusuario dentro de la
aplicación de ArchivoIdExterno Valor del campo IdExterno en la tabla de usuarios
del superusuario.
Adaptación de búsquedas
Tipos de búsquedas
Los tipos de búsquedas configurables dentro de la aplicación de Archivo son los siguientes:
• Búsqueda sencilla desde la Bandeja de Entrada• Búsqueda ampliada desde la Bandeja de Entrada• Búsqueda rápida desde el módulo de Fondos• Búsqueda avanzada desde el módulo de Fondos• Búsqueda Archivística (ficha ISAD(G) desde el módulo de Descripción
Así mismo, cada una de estas búsquedas puede a su vez ser configurada de manera diferente para un usuario que pertenece al archivo que para otro que no, por ejemplo un usuario tramitador, con lo que se dispondrá en realidad de 10 tipos diferentes de búsqueda a configurar, una por cada tipo de búsqueda y tipo de usuario.
Ficheros de configuración de búsquedas
SGM_2007_10_Manual de Implantación y Configuración v01 Página 79 de 125
Avanza LOCAL SIGEM
Descripción
En la configuración de las búsquedas hay que tener en cuenta dos tipos de ficheros distintos. Por un lado, estarán los ficheros situados en la ruta:
Archivo\generales\src\java\test\general
Serán los encargados de determinar qué campos de entrada y salida van a aparecer en una determinada búsqueda, qué restricciones se les aplicará y por qué campo hay que ordenar los resultados de la salida.
Por otro lado, estará el fichero ubicado donde indique el parámetro de inicialización de la aplicación busquedas.cfg.file dentro del fichero
Archivo/webapp/WEB-INF/web.xml
de la aplicación, que contendrá mapeos de las restricciones de búsqueda de IDCAMPO y listas descriptoras a su traducción en valores que reconozca la base de datos y que pueden por tanto variar dependiendo de cada instalación de la aplicación.
Ruta Relativa al fichero de búsquedas Descripción
bandeja\bandeja_simple.xml Fichero de configuración de la búsqueda simple desde la bandeja de entrada para usuarios que no pertenecen a un grupo de archivo
bandeja\bandeja_simple_archivo.xml
Fichero de configuración de la búsqueda simple desde la bandeja de entrada para usuarios que pertenecen a un grupo de archivo
bandeja\bandeja_avanzada.xml Fichero de configuración de la búsqueda avanzada desde la bandeja de entrada para usuarios que no pertenecen a un grupo de archivo
bandeja\bandeja_avanzada_archivo.xml
Fichero de configuración de la búsqueda simple desde la bandeja de entrada para usuarios que pertenecen a un grupo de archivo
fondos\fondos_rapida.xml Fichero de configuración de la búsqueda rápida desde el módulo de fondos para usuarios que no pertenecen a un grupo de archivo
fondos\fondos_rapida_archivo.xml Fichero de configuración de la búsqueda rápida desde el módulo de fondos para usuarios que pertenecen a un grupo de archivo
fondos\fondos_avanzada.xml Fichero de configuración de la búsqueda avanzada desde el módulo de fondos para usuarios que no pertenecen a un grupo de archivo
fondos\fondos_avanzada_archivo.xml
Fichero de configuración de la búsqueda avanzada desde el módulo de fondos para usuarios que pertenecen a un grupo de archivo
prestamos\prestamos.xml Fichero de configuración de las búsquedas de unidades documentales para añadir a un préstamo
prestamos\prestamos_archivo.xml Fichero de configuración de las búsquedas de unidades documentales para añadir a un préstamo para usuarios que pertenecen a un grupo de archivo
SGM_2007_10_Manual de Implantación y Configuración v01 Página 80 de 125
Avanza LOCAL SIGEM
Estructura de ficheros de búsqueda
Todos los ficheros de búsquedas tienen la misma estructura en formato XML:
<?xml version="1.0" encoding="ISO-8859-1"?><Busqueda version="01.00" descripcion=" ">
<entrada> <campo nombre=" " mostrar=" " tipo=""/>
<restriccion id=" " tipo=" "><listasDescriptoras>
<lista> </lista> ………………
<lista> </lista></listasDescriptoras>
</restriccion> … <restriccion id=" " tipo=" ">
<listasDescriptoras><lista> </lista>
… <lista> </lista> </listasDescriptoras>
</restriccion></campo> ………………
</entrada><salida>
<campo nombre=" " mostrar=" " tipo=""><restriccion id=" " tipo=""/>
</campo> ……………………………………
</salida><ordenacion tipo=" ">
<orden> </orden></ordenacion>
<restriccion id=" " tipo=" "><listasDescriptoras>
<lista> </lista> ………………
<lista> </lista></listasDescriptoras>
</restriccion> <restriccion> ………………………………………… </restriccion> </Busqueda>
Campo Descripción
Busqueda Identificador de la lista de volúmenes que se utiliza para almacenar los documentos vitales.Campo Descripcióndescripcion Texto descriptivo de la búsqueda a la que corresponde
la configuraciónentrada Lista de campos que van a aparecer en el formulario de
entrada para una búsqueda determinada.salida Lista de campos que van a aparecer en el formulario y/
o informe resultado de la búsqueda.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 81 de 125
Avanza LOCAL SIGEM
ordenacion Campo por el que se va a ordenar el resultado de las búsquedas.
restriccion(A partir de versión 2.1.1)
Restricciones aplicables a la búsqueda completa en lugar de a un campo en concreto
Configuración de campos de búsqueda
Tanto los campos de entrada como los de salida seguirán la misma estructura en cuanto a su definición, tendrán un nombre, unas opciones de visibilidad, un tipo y una lista de restricciones que podrán tener definidas o no listas descriptoras sobre las que aplicar las restricciones.
<campo nombre=" " mostrar=" " tipo=""/> <restriccion id=" " tipo=" ">
<listasDescriptoras> <lista> </lista>
………………
<lista> </lista></listasDescriptoras>
</restriccion> … <restriccion id=" " tipo=" ">
<listasDescriptoras> <lista> </lista> … <lista> </lista> </listasDescriptoras>
</restriccion> </campo>
Atributos de campos
Existen atributos de campos que se aplican a todos ellos y otros que sólo pueden aparecer en ciertos tipos de campos como se indica a continuación.
Atributo Descripción Valor Campos
nombre Nombre del campo de entrada/salida
Uno de los valores predefinidos para los nombres de campos.
Todos
mostrar Estado de visibilidad del campo en el formulario de entrada/salida
S - VisibleN - No visible
Todos
tipo Tipo de campo de entrada/salida
0 – Campos Avanzados1 – Campo de texto2 – Campo numérico3 – Campo de tipo fecha4 – Campo de tipo identificador5 – Campo de tipo todos los textos6 – Campo de tipo todos los descriptores
Todos
SGM_2007_10_Manual de Implantación y Configuración v01 Página 82 de 125
Avanza LOCAL SIGEM
7 – Campo de tipo todos los textos y todos los descriptores
mostrarCalificadores
Estado de visibilidad de los calificadores de fechas
S - VisibleN - No visible
Fecha_InicialFecha_FinalFechasNumero_ExpedienteSignatura (A partir de versión 2.1.1)
Campos de búsqueda
Los posibles campos de entrada/salida que es posible definir se detallan a continuación.
Campo Tipo Descripción
E S
Codigo_Referencia 1 1 Realiza una búsqueda en el campo CODIGO de la tabla ASGFELEMENTOCF
Titulo 1 1 Realiza una búsqueda en el campo documental TITULO de la tabla ASGFELEMENTOCF
Rangos 1 1 Realiza una búsqueda en el campo documental VALOR de la tabla ADVCTEXTCF
Numero_Expediente 1 1 Realiza una búsqueda en el campo NUMEXP de la tabla ASGFUNIDADDOC
Texto Realiza la búsqueda correspondiente según el valor que se indique en el tipo
5 X Realiza una búsqueda en el campo VALOR de las tablas ADVCTEXTCF y ADVCTEXTLCF
6 X Realiza una búsqueda en el campo NOMBRE de la tabla ADDESCRIPTOR
7 X Realiza una búsqueda en el campo VALOR de las tablas ADVCTEXTCF y ADVCTEXTLCF y en el campo NOMBRE de la tabla ADDESCRIPTOR
Fecha_Inicial 3 3 Realiza una búsqueda en el campo VALOR de las tablas ADVCFECHACF restringiendo por el IDCAMPO de fecha inicial
Fecha_Final 3 3 Realiza una búsqueda en el campo VALOR de las tablas ADVCFECHACF restringiendo por el IDCAMPO de fecha final
Fechas 3 3 Realiza una búsqueda en el campo VALOR de las tablas ADVCFECHACF sin restricción de IDCAMPO
Productor 4 1 Realiza una búsqueda por el campo IDOBJREF de la tabla ADVCREFCF
Fondo 4 1 Realiza una búsqueda por el campo IDOBJREF de la tabla ADVCREFCF
Niveles_Descripción 4 1 Realiza una búsqueda por el campo IDNIVEL de la tabla ASGFELEMENTOCF
Descriptores 4 X Realiza una búsqueda por el campo IDOBJREF de la tabla ADVCREFCF
Ámbito 4 X Realiza una búsqueda por el campo CODREFERENCIA de la tabla ASGFELEMENTOCF
Dato_Numerico 5 X Realiza una búsqueda por el campo VALOR de la tabla
SGM_2007_10_Manual de Implantación y Configuración v01 Página 83 de 125
Avanza LOCAL SIGEM
ADVCNUMCFEstado 4 1 Realiza una búsqueda por el campo ESTADO de la tabla
ASGFELEMENTOCFCodigo 1 1 Realiza una búsqueda por el campo CODIGO de la tabla
ASGFELEMENTOCFProcedimiento 4 1 Realiza una búsqueda por el campo IDPROCEDIMIENTO de
la tabla ASGFSERIECondiciones_Avanzadas
0 X Realiza una composición de búsquedas incluyendo algunas de las definidas en el resto de campos.
Signatura (A partir de versión 2.1.1)
1 1 Realiza una búsqueda en el campo SIGNATURAUDOC de la tabla ASGDUDOCENUI
Atributos de restricciones de campos
<restriccion id=" " tipo=" ">
<listasDescriptoras> <lista> </lista> … <lista> </lista> </listasDescriptoras>
</restriccion>
Atributo Descripción Valor
id Identificador único para la restricción
Uno de los valores predefinidos para los nombres de restricciones
tipo Tipo de restricción 0 – Todos los campos1 – Texto corto2 – Texto largo3 – Fecha4 – Numérico5 – Referencia-1 – Campo especial título -2 – Campo especial código-3 – Campo especial número de expediente-4 – Campo especial referencia-5 – Campo especial tabla (A partir de versión 2.1.1)
listasDescriptoras
Identificadores de las listas descriptoras que es necesario tener en cuenta para una restricción determinada
Identificadores de listas descriptoras
<lista>[ID_LISTA_DESCRIPTORA]</lista> …
Restricciones de campos de búsqueda
Las posibles restricciones que es posible aplicar a los campos de entrada/salida se detallan a continuación.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 84 de 125
Avanza LOCAL SIGEM
Restricción Tipo Descripción
E S
Interesado_Identidad 5 X Añade a las condiciones de búsqueda del campo la restricción opcional de buscar en el campo NOMBRE de la tabla ADDESCRIPTOR filtrando por los descriptores que corresponden al IDCAMPO de Interesado en la tabla ADVCREFCF. Además, si se indican, se tendrán en cuenta la lista de listas descriptoras que se enumeren.
Localización 1 X Añade a las condiciones de búsqueda del campo la restricción opcional de buscar en el campo NOMBRE de la tabla ADVCTEXTCF filtrando por el campo IDCAMPO de Localización.
Emplazamiento_Pais 5 X Añade a las condiciones de búsqueda del campo la restricción opcional de buscar en el campo NOMBRE de la tabla ADVCTEXTCF filtrando por los descriptores que corresponden al IDCAMPO de País. Además, si se indican, se tendrán en cuenta la lista de listas descriptoras que se enumeren.
Emplazamiento_Comunidad
5 X Añade a las condiciones de búsqueda del campo la restricción opcional de buscar en el campo NOMBRE de la tabla ADVCTEXTCF filtrando por los descriptores que corresponden al IDCAMPO de Comunidad. Además, si se indican, se tendrán en cuenta la lista de listas descriptoras que se enumeren.
Emplazamiento_Concejo
5 X Añade a las condiciones de búsqueda del campo la restricción opcional de buscar en el campo NOMBRE de la tabla ADVCTEXTCF filtrando por los descriptores que corresponden al i IDCAMPO de Concejo. Además, si se indican, se tendrán en cuenta la lista de listas descriptoras que se enumeren.
Emplazamiento_Poblacion
5 X Añade a las condiciones de búsqueda del campo la restricción opcional de buscar en el campo NOMBRE de la tabla ADVCTEXTCF filtrando por los descriptores que corresponden al IDCAMPO de Población. Además, si se indican, se tendrán en cuenta la lista de listas descriptoras que se enumeren.
RangosInicialNorm 1 X Añade a las condiciones de búsqueda del campo la restricción opcional de buscar en el campo NOMBRE de la tabla ADVCTEXTCF filtrando por los descriptores que corresponden al IDCAMPO de Rango Inicial Normalizado.
RangosFinalNorm 1 X Añade a las condiciones de búsqueda del campo la restricción opcional de buscar en el campo NOMBRE de la tabla ADVCTEXTCF filtrando por los descriptores que corresponden al IDCAMPO de Rango Final Normalizado.
Fecha_Inicial 3 3 Añade a las condiciones de búsqueda del campo la restricción opcional de buscar en el campo VALOR de las tablas ADVCFECHACF restringiendo por el IDCAMPO de fecha inicial
Fecha_Final 3 3 Añade a las condiciones de búsqueda del campo la restricción opcional de buscar en el campo VALOR de las tablas ADVCFECHA CF restringiendo por el IDCAMPO de fecha final
Productor 5 X Añade a las condiciones de búsqueda del campo la restricción opcional de buscar en el campo IDOBJREF de la tabla ADVCREFCF restringiendo por el IDCAMPO de
SGM_2007_10_Manual de Implantación y Configuración v01 Página 85 de 125
Avanza LOCAL SIGEM
Productor.RangosInicial X 1 Añade a las condiciones de búsqueda del campo la
restricción opcional de buscar en el campo NOMBRE de la tabla ADVCTEXTCF filtrando por los descriptores que corresponden al IDCAMPO de Rango Inicial.
RangosFinal X 1 Añade a las condiciones de búsqueda del campo la restricción opcional de buscar en el campo NOMBRE de la tabla ADVCTEXTCF filtrando por los descriptores que corresponden al IDCAMPO de Rango Final.
UDoc_EnRelEntrega (A partir de versión 2.1.1)
-5 X Añade a las condiciones de búsqueda del campo la restricción opcional de que el elemento del cuadro que se está buscando sea una unidad documental en una relación de entrega dentro de una caja.
Estado_UDoc_Validada (A partir de versión 2.1.1)
-5 X Añade a las condiciones de búsqueda del campo la restricción opcional de que la Unidad documental que se busca esté validada
Configuración de ordenación
<ordenacion tipo=" "><orden> </orden>
</ordenacion>
Campo Descripción Valor
Tipo Modo de ordenación de los resultados de la búsqueda
ASC - AscendenteDESC – Descendente
orden Nombre del campo de salida por el que se va a ordenar
Un nombre de campo de los definidos para la salida
Configuración de restricciones de búsqueda
La configuración de las restricciones de búsqueda sería idéntica a la indicada en el punto 3.5.2.2.1.4, pero aplicada en lugar de a un campo en particular a la búsqueda en general.
Estructura de ficheros de mapeo de restricciones de búsqueda
El fichero de mapeo de restricciones de búsqueda tendrá la siguiente estructura y contenido por defecto:
<?xml version="1.0" encoding="ISO-8859-1"?><ConfigBusquedas version="01.00" descripcion="Configuración de búsquedas"> <Campos_Descriptivos> <campo nombre="Fecha_Inicial" valor="3" tipo="3"/> <campo nombre="Fecha_Final" valor="4" tipo="3"/>
<campo nombre="Fechas" valor="0" tipo="3"/> <campo nombre="Id_Tercero_Interesado" valor="51" tipo="5"/>
<campo nombre="Interesado_Identidad" valor="9" tipo="5"/><campo nombre="Localizacion" valor="42" tipo="1"/><campo nombre="Emplazamiento_Pais" valor="2" tipo="5"/><campo nombre="Emplazamiento_Comunidad" valor="39" tipo="5"/>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 86 de 125
Avanza LOCAL SIGEM
<campo nombre="Emplazamiento_Municipio" valor="40" tipo="5"/><campo nombre="Emplazamiento_Poblacion" valor="41" tipo="5"/><campo nombre="Productor" valor="16" tipo="5"/><campo nombre="RangosInicialNorm" valor="203" tipo="5"/><campo nombre="RangosFinalNorm" valor="204" tipo="5"/>
<campo nombre="RangosInicial" valor="201" tipo="5"/><campo nombre="RangosFinal" valor="202" tipo="5"/>
</Campos_Descriptivos> <Listas_Descriptoras> <lista nombre="ID_LIST_PAIS" valor="ID_LIST_PAIS" tipo="5"/> <lista nombre="ID_LIST_PROVINCIA" valor="ID_LIST_PROVINCIA" tipo="5"/>
<lista nombre="ID_LIST_COMUNIDAD" valor="ID_LIST_COMUNIDAD" tipo="5"/><lista nombre="ID_LIST_CONCEJO" valor="ID_LIST_CONCEJO" tipo="5"/><lista nombre="ID_LIST_POBLACION" valor="ID_LIST_POBLACION" tipo="5"/><lista nombre="ID_LIST_INTERESADO_IDENTIDAD" valor="ID_LIST_INTERESADO" tipo="5"/><lista nombre="ID_LIST_BDORGANIZACION" valor="ID_LIST_BDORGANIZACION" tipo="5"/>
</Listas_Descriptoras></ConfigBusquedas>
Campo Descripción
Campos_Descriptivos Lista de mapeos para restricciones sobre el campo IDCAMPO de las tabla correspondiente según el tipo de campo/restricción.
Listas_Descriptoras Lista de mapeos de denominaciones de listas descriptoras a los identificadores de las listas en la base de datos.
Definición de Campos Descriptivos
<Campos_Descriptivos> <campo nombre=" " valor="" tipo=""/> …………… </Campos_Descriptivos>
Campo Descripción
campo Mapeo de una restricción indicada en los ficheros de configuración de búsquedas dentro de la aplicación a valores reconocidos por la base de datos.
Definición de un campo descriptivo
<campo nombre=" " valor="" tipo=""/>
Atributo Descripción Valor
Nombre Nombre de una de las restricciones indicadas en alguno de los ficheros de configuración de búsquedas de la aplicación
Nombre de una de las restricciones de los ficheros de búsquedas
Valor Valor en la base de datos del campo IDCAMPO al que se aplica la restricción
Uno de los IDCAMPO válidos definidos en la base de datos.
Tipo Tipo de restricción que determinará sobre qué tabla es necesario aplicar la restricción
1 – Texto corto - ADVCTEXTCF2 – Texto largo -
SGM_2007_10_Manual de Implantación y Configuración v01 Página 87 de 125
Avanza LOCAL SIGEM
de IDCAMPO ADVCTEXTLCF3 – Fecha - ADVCFECHA4 – Numérico - ADVCNUMCF5 – Referencia - ADVCREF
Definición de Listas Descriptoras
<Listas_Descriptoras> <lista nombre=" " valor=" " tipo=" "/> </Listas_Descriptoras>
Campo Descripción
lista Mapeo de una restricción de lista descriptora indicada en los ficheros de configuración de búsquedas dentro de la aplicación a valores reconocidos por la base de datos.
Definición de una Lista Descriptora
<lista nombre=" " valor=" " tipo=" "/>
Atributo Descripción Valor
Nombre Nombre de una de las restricciones de lista descriptora indicadas en alguno de los ficheros de configuración de búsquedas de la aplicación
Nombre de una de las restricciones de lista descriptora de los ficheros de búsquedas
Valor Valor en la base de datos del campo IDLISTA al que se aplica la restricción
Uno de los IDLISTA válidos definidos en la base de datos.
Tipo Por definir Por definir
SGM_2007_10_Manual de Implantación y Configuración v01 Página 88 de 125
Avanza LOCAL SIGEM
Ficheros XML de configuraciones por defecto
Fichero xml del gestor de geográficos
Si el sistema de geográficos se obtiene de un fichero xml, (situado en test/sistema_gestor_geograficos.xml) tendrá que tener la siguiente estructura.
<?xml version="1.0" encoding="ISO-8859-1" ?><geograficos> <paises> <pais id="[id de pais]" name="[nombre de pais]"> <provincias> <provincia id="[id de provincia]" name="[nombre de provincia]"> <municipios>
<municipio id="[id de municipio]" name="[nombre de municipio]"> <localidades> <localidad id="[id de localidad]" name="[nombre de localidad]"/>
………………………………………………………………………… <localidad id="[id de localidad]" name="[nombre de localidad]"/> </localidades> </municipio>
……………………………………………………………………………
<municipio id="[id de municipio]" name="[nombre de municipio]"> <localidades> <localidad id="[id de localidad]" name="[nombre de localidad]"/>
………………………………………………………………………… <localidad id="[id de localidad]" name="[nombre de localidad]"/> </localidades> </municipio> </municipios>
……………………………………………………………………………
<provincia id="[id de provincia]" name="[nombre de provincia]"> <municipios>
<municipio id="[id de municipio]" name="[nombre de municipio]"> <localidades> <localidad id="[id de localidad]" name="[nombre de localidad]"/>
………………………………………………………………………… <localidad id="[id de localidad]" name="[nombre de localidad]"/> </localidades> </municipio>
……………………………………………………………………………
<municipio id="[id de municipio]" name="[nombre de municipio]"> <localidades> <localidad id="[id de localidad]" name="[nombre de localidad]"/>
………………………………………………………………………… <localidad id="[id de localidad]" name="[nombre de localidad]"/> </localidades> </municipio> </municipios> </provincia>
</provincias> </pais> </paises></geograficos>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 89 de 125
Avanza LOCAL SIGEM
Fichero xml del gestor de organización
Si el sistema de organización se obtiene de un fichero xml, (situado en test/ sistema_gestor_organizacion.xml) tendrá que tener la siguiente estructura.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<sistema_organizacion> <organo> <id>[id]</id> <codigo>[codigo]</codigo> <nombre>[nombre]</nombre> <nivel>[nivel]</nivel> <id_padre>[id del organo padre]</id_padre> </organo>
……………………………………………………………………………………
<organo> <id>[id]</id> <codigo>[codigo]</codigo> <nombre>[nombre]</nombre> <nivel>[nivel]</nivel> <id_padre>[id del organo padre]</id_padre> </organo> <organo_usuario> <usuario>[id de usuario]</usuario> <organo>[id de organo] </organo> </organo_usuario>
…………………………………………………………………………………
<organo_usuario> <usuario>[id de usuario]</usuario> <organo>[id de organo] </organo> </organo_usuario>
</sistema_organizacion>
Fichero xml del gestor de procedimientos
Si el sistema de procedimientos se obtiene de un fichero xml, (situado en test/ sistema_gestor_procedimientos.xml) tendrá que tener la siguiente estructura.
<?xml version="1.0" encoding="ISO-8859-1" ?><catalogo_procedimientos> <procedimiento> <id>[id del procedimiento]</id> <codigo>[codigo]</codigo> <nombre>[nombre]</nombre> <sistema_productor> <id>[id del sistema productor]</id> <nombre>[nombre]</nombre> </sistema_productor> <titulo_corto>[titulo]</titulo_corto> <objeto>[descripción del objeto] </objeto> <tramites> <tramite>[descripción del tramite]</tramite> </tramites> <normativa>[descripción de la normativa]</normativa> <documentos>[documentos]</documentos> <productores> <productor> <id>[id del productor]</id>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 90 de 125
Avanza LOCAL SIGEM
<fecha_inicio>[fecha de inicio dd/mm/aaaa]</fecha_inicio> </productor> </productores> </procedimiento>
………………………………………………………………………
<procedimiento> <id>[id del procedimiento]</id> <codigo>[codigo]</codigo> <nombre>[nombre]</nombre> <sistema_productor> <id>[id del sistema productor]</id> <nombre>[nombre]</nombre> </sistema_productor> <titulo_corto>[titulo]</titulo_corto> <objeto>[descripción del objeto] </objeto> <tramites> <tramite>[descripción del tramite]</tramite> </tramites> <normativa>[descripción de la normativa]</normativa> <documentos>[documentos]</documentos> <productores> <productor> <id>[id del productor]</id> <fecha_inicio>[fecha de inicio dd/mm/aaaa]</fecha_inicio> </productor> </productores> </procedimiento>
</catalogo_procedimientos>
Fichero xml del gestor de terceros
Si el sistema de terceros se obtiene de un fichero xml, este tendrá que tener la siguiente estructura.
<?xml version="1.0" encoding="ISO-8859-1" ?><terceros> <tercero id=”[id del tercero]”> <identificacion>[identificación]</identificacion> <nombre>[nombre]</nombre> <apellido1>[apellido1]</apellido1> <apellido2>[apellido2]</apellido2> <direccion>[direccion]</direccion> <email>[email]</email> </tercero>
……………………………………………………………………………………………
<tercero id=”[id del tercero]”> <identificacion>[identificación]</identificacion> <nombre>[nombre]</nombre> <apellido1>[apellido1]</apellido1> <apellido2>[apellido2]</apellido2> <direccion>[direccion]</direccion> <email>[email]</email> </tercero> </terceros>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 91 de 125
Avanza LOCAL SIGEM
Fichero xml del gestor de trámites
Si el sistema de trámites se obtiene de un fichero xml, este tendrá que tener la siguiente estructura.
<?xml version="1.0" encoding="ISO-8859-1" ?><expedientes> <expediente> <procedimiento>[procedimiento]</procedimiento> <id>[id del procedimiento]</id> <numeroExpediente>[numero de expediente]</numeroExpediente> <asunto>[asunto]</asunto> <fechaInicio>[fecha de inicio dd/mm/aaaa]</fechaInicio> <fechaFinalizacion>[fecha de finalizacion dd/mm/aaaa]</fechaFinalizacion> <organo_productor> <id>[código del órgano del sistema de organización]</id> <nombre>[nombre del órgano del sistema de organización]</nombre> </organo_productor> <interesados> <interesado principal=”[S|N]”> <identificacion>[identificación]</identificacion> <nombre>[nombre]</nombre> <id_en_terceros>[id en terceros]</id_en_terceros> <rol>[rol]</rol> </interesado> </interesados>
<documentosFisicos> <documento> <nombre>[nombre del documento fisico]</nombre> <descripcion>[descripción del documento fisico]</descripcion> </documento>
…………………………………………………………………… <documento>
<nombre>[nombre del documento fisico]</nombre> <descripcion>[descripción del documento fisico]</descripcion> </documento>
</documentosFisicos>
<emplazamientos> <emplazamiento> <pais>[pais]</pais> <comunidad>[comunidad]</comunidad> <concejo>[concejo]</concejo> <poblacion>[población]</poblacion> <localizacion>[localización]</localizacion> </emplazamiento>
……………………………………………………………………………
<emplazamiento> <pais>[pais]</pais> <comunidad>[comunidad]</comunidad> <concejo>[concejo]</concejo> <poblacion>[población]</poblacion> <localizacion>[localización]</localizacion> </emplazamiento>
</emplazamientos> </expediente>
………………………………………………………………………………
<expediente> <procedimiento>[procedimiento]</procedimiento> <id>[id del procedimiento]</id> <numeroExpediente>[numero de expediente]</numeroExpediente> <asunto>[asunto]</asunto>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 92 de 125
Avanza LOCAL SIGEM
<fechaInicio>[fecha de inicio dd/mm/aaaa]</fechaInicio> <fechaFinalizacion>[fecha de finalizacion dd/mm/aaaa]</fechaFinalizacion> <organo_productor> <id>[código del órgano del sistema de organización]</id> <nombre>[nombre del órgano del sistema de organización]</nombre>
</organo_productor> <interesados> <interesado principal=”[S|N]”> <identificacion>[identificación]</identificacion> <nombre>[nombre]</nombre> <id_en_terceros>[id en terceros]</id_en_terceros> <rol>[rol]</rol> </interesado> </interesados>
<documentosFisicos> <documento> <nombre>[nombre del documento fisico]</nombre> <descripcion>[descripción del documento fisico]</descripcion> </documento>
…………………………………………………………………… <documento>
<nombre>[nombre del documento fisico]</nombre> <descripcion>[descripción del documento fisico]</descripcion> </documento>
</documentosFisicos>
<emplazamientos> <emplazamiento> <pais>[pais]</pais> <comunidad>[comunidad]</comunidad> <concejo>[concejo]</concejo> <poblacion>[población]</poblacion> <localizacion>[localización]</localizacion> </emplazamiento>
……………………………………………………………………………
<emplazamiento> <pais>[pais]</pais> <comunidad>[comunidad]</comunidad> <concejo>[concejo]</concejo> <poblacion>[población]</poblacion> <localizacion>[localización]</localizacion> </emplazamiento>
</emplazamientos> </expediente></expedientes>
Fichero xml del gestor de usuarios
Si el sistema de usuarios se obtiene de un fichero xml, este tendrá que tener la siguiente estructura.
<?xml version="1.0" encoding="ISO-8859-1" ?><sistema_gestor_usuarios> <usuario> <externalUserId>[id externo del usuario]</externalUserId> <organizationUserId>[id de la organización del usuario]</organizationUserId> <address>[dirección]</address> <email>[email]</email> <name>[nombre]</name>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 93 de 125
Avanza LOCAL SIGEM
<surname>[apellidos]</surname> </usuario>
……………………………………………………………………………………………
<usuario> <externalUserId>[id externo del usuario]</externalUserId> <organizationUserId>[id de la organización del usuario]</organizationUserId> <address>[dirección]</address> <email>[email]</email> <name>[nombre]</name> <surname>[apellidos]</surname> </usuario></sistema_gestor_usuarios>
SGM_2007_10_Manual de Implantación y Configuración v01 Página 94 de 125
Avanza LOCAL SIGEM
5.4Consulta Web de Expedientes
5.4.1 El fichero WAR
La aplicación vendrá empaquetada en el fichero consulta.war, (Web Application Resource) que cumple con las especificaciones Servlet 2.4 y JSP 2.0. Dicho fichero comprimido, es una estructura de directorios y archivos que se puede desplegar en un servidor de aplicaciones de forma sencilla y cuya configuración vendrá descrita en ciertos archivos con formato XML, situados dentro del propio fichero WAR.
5.4.2 El despliegue
Existen varias formas de despliegue de un fichero WAR para Tomcat, de las cuales se describen en este documento las dos formas más adecuadas:
1) De forma manual.
Consiste en depositar el archivo dentro de la estructura de carpetas de Tomcat en el servidor, en concreto dentro de
%TOMCAT_HOME%\webapps
El servidor Tomcat desplegará de forma automática la aplicación web para ser utilizada.
En el caso de que el servidor Tomcat no esté configurado para hacer despliegues automáticos en caliente, se deberá reiniciar el servicio.
2) A través de su utilidad Web.
Cualquier servidor Tomcat tiene una utilidad llamada ‘Tomcat Manager‘ que permite desplegar un fichero WAR al servidor desde nuestro equipo. Se llama vía Web accediendo a alguna de las siguientes URL’s:
http://%SERVIDOR% (picar opción de menú ‘Tomcat Manager’)http://%SERVIDOR%/manager/html
La última de las opciones, permite desplegar el fichero como se muestra en la siguiente imagen.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 95 de 125
Avanza LOCAL SIGEM
Para comprobar si la aplicación se ha instalado con éxito, habría que llamar desde el navegador a:
http://%SERVIDOR%/%nombre del fichero WAR%
SGM_2007_10_Manual de Implantación y Configuración v01 Página 96 de 125
Avanza LOCAL SIGEM
5.4.2 Software necesario
Relación de librerías de la Consulta Web de Expedientes
Las librerías necesarias para el proyecto son:
- activation.jar (versión 1.4.1 o superior)- FastInfoset.jar (versión 1.4.1 o superior)- jaxp-api.jar (versión 1.4.1 o superior)- jax-qname.jar (versión 1.4.1 o superior)- jaxrpc-api.jar (versión 1.4.2 o superior)- jaxrpc-impl.jar (versión 1.4.2 o superior)- jaxrpc-spi.jar (versión 1.4.1 o superior)- jsr173_api.jar (versión 1.4.2 o superior)- log4j-1.2.8.jar (versión 1.2.8 o superior)- mail.jar (versión 1.4.2 o superior)- postgresql-8.0-311.jdbc2.jar (versión 8.0-311 o superior)- relaxngDatatype.jar (versión 1.4.1 o superior)- saaj-api.jar (versión 1.4.2 o superior)- saaj-impl.jar (versión 1.4.2 o superior)- xerces-2.6.2.jar (versión 2.6. 2 o superior)- xsdlib.jar (versión 1.4.2 o superior)- rde.jar (aplicación de registro de documentos versión 1)- Notificacion.jar (aplicación de notificación versión 1)- oro-2.0.8.jar (versión 1)
Navegador Web
La interfaz de usuario, se presenta a través de páginas web, debido a que el usuario tipo puede ser cualquier persona con acceso a Internet. La aplicación, por tanto, debe ser capaz de presentar la información de forma fiable, óptima y con el aspecto propio de del proyecto SIGEM, independientemente del navegador que utilice el usuario.Teniendo esto en cuenta, se ha creado una interfaz que es perfectamente compatible con las últimas versiones de los navegadores que, de forma abrumadora, gozan de las preferencias de los usuarios de Internet.
La aplicación de Consulta Web de Expedientes es compatible con:
Internet Explorer 5 o superior Firefox/2.x o superior
SGM_2007_10_Manual de Implantación y Configuración v01 Página 97 de 125
Avanza LOCAL SIGEM
Servidor web
El software encargado de servir las páginas web debe ser Apache Tomcat en versión 5.5 o superior. Este software, de distribución libre, es además un ‘Servlet Container’ capaz de trabajar con j2EE y el framework struts (también de la fundación apache) con el que trabaja la aplicación de Consulta Web de Expedientes.
El servidor Tomcat, debe estar convenientemente configurado, de la forma descrita en los siguientes apartados.
Dimensionamiento de memoria
Mínimo de 50 MB de memoria física disponible, para poder desplegar la aplicación.
Puerto seguro
La aplicación de Consulta Web de Expedientes, necesita una conexión en modo seguro, por lo que el servidor debe soportar un protocolo de conexión https y habilitar un puerto TCP para tal fin. En TOMCAT, esto se consigue, añadiendo un nuevo elemento Conector en el archivo
%TOMCAT_HOME%/conf/server.xml.
Introduciendo en dicho fichero algo similar al siguiente fragmento de código:
<Connector port=[puerto] maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" disableUploadTimeout="true"
acceptCount="100" scheme="https" secure="true"
clientAuth="true" sslProtocol="TLS"
keystoreFile=[certificado en servidor] keystorePass=[clave certificado en servidor]
keystoreType=[protocolo del certificado del servidor]/>
Los elementos que se deben añadir son:
Puerto: identificador del puerto software que se desea habilitar para la conexión segura. Se ha de estar seguro de que no “choca” con otro puerto.
Certificado en servidor: path dentro del sistema de ficheros, donde esté instalado el servidor e indicar donde se encuentra el certificado a contrastar.
Clave certificado en servidor: clave del certificado a contrastar. Protocolo del certificado del servidor: formato del fichero donde se
encuentra el certificado del servidor.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 98 de 125
Avanza LOCAL SIGEM
Máquina virtual JAVA
La MVJ del servidor debe ser versión 1.4.2.
Base de datos
La aplicación de Consulta Web de Expedientes tiene sus propias tablas en la base de datos general de SIGEM (Postgres 8.2). Cada módulo de SIGEM se conecta de forma específica a la base de datos general.
El archivo ‘application.properties’
La configuración para el acceso a BBDD, se realiza a través de un fichero de configuración situado en:
%TOMCAT_HOME%\webapps\WEB-INF\classes\ieci\tecdoc\sgm\ct\ resources\application.properties
Este fichero contiene los parámetros de configuración necesarios, para el correcto funcionamiento de la aplicación. Los parámetros incluidos referentes a la conexión a BBDD son:
database: URL de conexión a la BBDD con el siguiente formato:
jdbc:postgresql://%SERVIDOR%/%NOMBRE DE LA BBDD%
user: usuario con permisos de acceso suficientes a las tablas de la aplicación password: contraseña del usuario driver: clase java que sirve de driver JDBC. A no ser que se modifique la
aplicación debe tener el siguiente valor: “org.postgresql.Driver”.
Tablas de la BBDD
La Consulta Web de Expedientes, se basa en un modelo de datos obtenido a partir del modelo de datos de la Gestión de Expedientes, en donde se configuran los valores que se incluirán en el modelo de datos de Publicación o de Consulta web del Expediente. Las tablas en donde ser recoge este modelo de datos, vienen descritas en el siguiente cuadro, especificándose el script SQL de creación.
Nombre de tabla Descripción Script de creación
SGM_CTFICHHITO
Ficheros de un hito
CREATE TABLE SGM_CTFICHHITO ( CGUIDHITO VARCHAR(32) NOT NULL, CGUIDFICH VARCHAR(32) NOT NULL, CTITULO VARCHAR(128) NOT NULL);
SGM_2007_10_Manual de Implantación y Configuración v01 Página 99 de 125
Avanza LOCAL SIGEM
Nombre de tabla Descripción Script de creación
SGM_CTHITOESTEXP
Hitos del estado de los expedientes
CREATE TABLE SGM_CTHITOESTEXP ( CNUMEXP VARCHAR(32) PRIMARY KEY NOT NULL, CGUID VARCHAR(32) NOT NULL, CCOD VARCHAR(32), CFECHA DATE NOT NULL, CDESCR VARCHAR(254) NOT NULL, CINFOAUX VARCHAR(4096) );
SGM_CTHITOHISTEXP
Histórico de hitos de un expediente
CREATE TABLE SGM_CTHITOHISTEXP ( CNUMEXP VARCHAR(32) NOT NULL, CGUID VARCHAR(32) NOT NULL, CCOD VARCHAR(32), CFECHA DATE NOT NULL, CDESCR VARCHAR(254) NOT NULL, CINFOAUX VARCHAR(4096) );
SGM_CTINFOEXP
Información de Expedientes
CREATE TABLE SGM_CTINFOEXP ( CNUMEXP VARCHAR(32) PRIMARY KEY NOT NULL, CPROC VARCHAR(254), CFHINICIO DATE NOT NULL, CNUMREGINI VARCHAR(32), CFHREGINI DATE, CINFOAUX VARCHAR(4096), CAPORTACION CHAR(1), CCODPRES VARCHAR(32) );
SGM_CTINTEXP
Interesados de los expedientes
CREATE TABLE SGM_CTINTEXP ( CNUMEXP VARCHAR(32) NOT NULL, CNIF VARCHAR(16) NOT NULL, CNOM VARCHAR(128), CPRINCIPAL CHAR(1) NOT NULL, CINFOAUX VARCHAR(4096),
UNIQUE(CNUMEXP, CNIF));
SGM_2007_10_Manual de Implantación y Configuración v01 Página 100 de 125
Avanza LOCAL SIGEM
Nombre de tabla Descripción Script de creación
SGM_NTINFONOTIF
Información de notificaciones
CREATE TABLE SGM_NTINFONOTIF ( CGUID VARCHAR(32) PRIMARY KEY NOT NULL, CNIFDEST VARCHAR(16) NOT NULL, CNUMREG VARCHAR(32) NOT NULL, CFHREG TIMESTAMP NOT NULL, CNUMEXP VARCHAR(32) NOT NULL, CPROC VARCHAR(254) NOT NULL, CINFOAUX VARCHAR(4096), CAVISADA INTEGER NOT NULL, CFHAVISO TIMESTAMP, CENTREGADA CHAR(1) NOT NULL, CFHENTREGA TIMESTAMP, CDIRCE VARCHAR(128) NOT NULL, CASUNTOMCE VARCHAR(254) NOT NULL, CTEXTOMCE VARCHAR(254) NOT NULL, CTITULO VARCHAR(128) NOT NULL, CTITULODE VARCHAR(128) NOT NULL, CTITULOAR VARCHAR(128) NOT NULL,
UNIQUE(CNUMEXP, CNIFDEST)
)
SGM_NTFICHNOTIF
Ficheros de notificaciones
CREATE TABLE SGM_NTFICHNOTIF ( CGUID VARCHAR(32) PRIMARY KEY NOT NULL, CGUIDNOTIF VARCHAR(32) NOT NULL, CCODIGO VARCHAR(32), CROL VARCHAR(32), CTITULO VARCHAR(128) NOT NULL)
También hay que generar una serie de índices, descritos en el siguiente cuadro
Nombre de índice
Tabla de referencia
Script de creación
SGM_CTFICHHITO1
SGM_CTFICHHITO
CREATE INDEX SGM_CTFICHHITO1 ON SGM_CTFICHHITO ( CGUIDHITO );
SGM_CTHITOESTEXP1
SGM_CTHITOESTEXP1
CREATE INDEX SGM_CTHITOESTEXP1 ON SGM_CTHITOESTEXP ( CNUMEXP );
CTHITOHISTEXP1
CTHITOHISTEXP CREATE INDEX SGM_CTHITOHISTEXP1 ON SGM_CTHITOHISTEXP ( CNUMEXP );
SGM_CTINFOEXP1
SGM_CTINFOEXP
CREATE INDEX SGM_CTINFOEXP1 ON SGM_CTINFOEXP ( CNUMEXP );
SGM_CTINTEXP1
SGM_CTINTEXP CREATE INDEX SGM_CTINTEXP1 ON SGM_CTINTEXP ( CNUMEXP );
SGM_CTINTEXP2
SGM_CTINTEXP CREATE INDEX SGM_CTINTEXP2 ON SGM_CTINTEXP ( CNIF );
SGM_CNXUSR1 SGM_CNXUSR CREATE INDEX SGM_CNXUSR1 ON SGM_CNXUSR ( CNIF );
SGM_2007_10_Manual de Implantación y Configuración v01 Página 101 de 125
Avanza LOCAL SIGEM
Nombre de índice
Tabla de referencia
Script de creación
SGM_NTFICHNOTIF1
SGM_NTFICHNOTIF
CREATE INDEX SGM_NTFICHNOTIF1 ON SGM_NTFICHNOTIF ( CGUIDNOTIF );
SGM_NTINFONOTIF2
SGM_NTINFONOTIF
CREATE INDEX SGM_NTINFONOTIF2 ON SGM_NTINFONOTIF ( CNIFDEST );
SGM_NTINFONOTIF3
SGM_NTINFONOTIF
CREATE INDEX SGM_NTINFONOTIF3 ON SGM_NTINFONOTIF ( CAVISADA );
SGM_NTINFONOTIF4
SGM_NTINFONOTIF
CREATE INDEX SGM_NTINFONOTIF4 ON SGM_NTINFONOTIF ( CENTREGADA );
SGM_NTFICHNOTIF1
SGM_NTFICHNOTIF
CREATE INDEX SGM_NTFICHNOTIF1 ON SGM_NTFICHNOTIF ( CGUIDNOTIF );
5.4.3 Dependencias
Aunque es transparente para su instalación, conviene tener en cuenta que Consulta de Expedientes puede tener dependencias con otras aplicaciones o módulos enclavadas dentro del marco de desarrollo de SIGEM.
1. Dependencia con Notificaciones.
Desde la Consulta web de Expedientes, cualquier ciudadano podría consultar si tiene Notificaciones, para alguno de los expedientes consultados. Esta dependencia no es obligatoria, en el sentido de que si el organismo no utiliza la Notificación de SIGEM, la consulta web del expediente, sigue funcionando, sin habilitar el acceso al Portal de Correos.
2. Dependencia con módulo de Repositorio documental electrónico.
Para que un ciudadano pueda consultar Documentos anexos a los expedientes en que figura como interesado, la Consulta web del Expediente, utiliza el módulo de SIGEM de gestión documental: Repositorio documental electrónico que se encarga de la creación y recuperación de documentos. El API que contiene la funcionalidad se encuentra en la librería rde.jar y se encuentra incluido en el paquete del Registro Telemático.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 102 de 125
Avanza LOCAL SIGEM
5.5Registro Telemático
5.5.2 Descripción del sistema de Registro Telemático
El organismo que utilice el Registro Telemático de SIGEM: Ayuntamiento o Diputación, pone a disposición del ciudadano un conjunto de trámites accesibles desde el Portal, que serán registrados de forma telemática, es decir el Registro Telemático se comportará como una oficina más de Registro: la oficina virtual.
El sistema general, sigue el siguiente esquema:
Después de la selección del trámite a realizar, por parte del ciudadano, el organismo le presentará a éste un formulario para que cumplimente. Una vez relleno, el organismo validará los datos y se los presentará al ciudadano para su aprobación. Si el ciudadano acepta los datos presentados por el organismo, y rellenados anteriormente por él, se firmará la solicitud y será registrada por el organismo. Para finalizar el proceso de registro, el ciudadano podrá descargar un justificante del proceso de registro.
El Registro Telemático de SIGEM cuenta con un configurador de Trámites. Este configurador, dispone de una herramienta gráfica, para realizar la parametrización de los siguientes componentes del mismo:
Trámites Asociación de documentos a un trámites Documentos Conectores Asociación de conectores a un trámite Órganos destinatarios
Con este configurador, para implementar un nuevo trámite, se daría de alta y configuraría, teniendo tan sólo que modificar alguno de los formularios que se entregan con SIGEM, para adaptarlo al nuevo trámite diseñado. Esta modificación, se realizaría sobre un formulario con un editor de XML.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 103 de 125
Avanza LOCAL SIGEM
Nota: habrá trámites en donde sea necesario la autenticación e identificación del ciudadano con certificado digital, en otras ocasiones, dependiendo del diseño del Trámite, bastará con un sistema de usuario y contraseña.
5.5.3 Instalación del software
Enumeración software del registro telemático en SIGEM
Para el correcto funcionamiento del Registro Telemático, se deben incluir las siguientes librerías en el classpath de la aplicación:
bcmail-jdk14-127.jar: Librerías de criptografía (v 1.27) bcprov-jdk14-127.jar: Librerías de criptografía (v1.27) commons-[].jar: Conjunto de librerías common de apache (versión
asociada a la librería struts.jar) itext-2.0.0.jar: Librerías para la creación de PDFs (v2.0.0) log4j-1.2.8.jar: Librería para la creación de Trazas o Logs (v1.2.8) struts.jar: Librería de struts (v1.3.8) xercesImpl.jar: Librería de XML (v2.6.2) xml-apis.jar: Librería de XML (v1.3.01) catalogo.jar: librería del catálogo de trámites rde.jar: librería del repositorio documental electrónico registro.jar: librería del registro telemático autenticacion.jar: librería de autenticación
Servidor web
La parte accesible por el usuario, se muestra a través de páginas, que forman una web, a parte del resto de módulos SIGEM. Es decir, se dispone del fichero “war”: REGISTRO_WEB, que ha ser desplegado en el servidor. Por lo que se debe tener disponibles:
Un servidor TOMCAT versión 5.5 o superior. Tener disponible el contexto “/REGISTRO_WEB” dentro del servidor. Tener disponible el contexto “/CATALOGO_TRAMITES_WEB” dentro del servidor. Tener 25 MB de memoria física disponible para poder desplegar la aplicación. El servidor debe de estar configurado para:
Puerto seguro
El módulo de Registro Telemático espera que se acceda a él, cuando así lo requiera el trámite, mediante una conexión segura y con un certificado valido, por lo que el servidor debe soportar un protocolo de conexión https y habilitar un puerto software para tal fin. En TOMCAT esto se consigue añadiendo un nuevo elemento Conector como por ejemplo:
<Connector port=[puerto] maxHttpHeaderSize="8192"
maxThreads="150"
SGM_2007_10_Manual de Implantación y Configuración v01 Página 104 de 125
Avanza LOCAL SIGEM
minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" disableUploadTimeout="true"
acceptCount="100" scheme="https" secure="true"
clientAuth="true" sslProtocol="TLS"
keystoreFile=[certificado en servidor] keystorePass=[clave certificado en servidor]
keystoreType=[protocolo del certificado del servidor]/>
Los elementos que se deben añadir son:
Puerto: identificador del puerto software que se desea habilitar para la conexión segura. Se ha de estar seguro de que no “choca” con otro puerto.
Certificado en servidor: path dentro del sistema de ficheros, donde esté instalado el servidor e indicar donde se encuentra el certificado a contrastar.
Clave certificado en servidor: clave del certificado a contrastar. Protocolo del certificado del servidor: formato del fichero donde se
encuentra el certificado del servidor.
Maquina virtual JAVA
La MVJ donde se lance el servidor TOMCAT. Versión 1.4 o superior.
Base de datos
El módulo de Registro Telemático tiene sus propias tablas, en la base de datos general de SIGEM (Postgres 8.2). Cada módulo de SIGEM se conecta de forma propia a la base de datos general. Lo único que se debe hacer, es decirle al módulo de Registro Telemático dónde esta la base de datos. La manera de comunicar este dato es mediante los siguientes ficheros de propiedades:
ieci\tecdoc\sgm\catalogo_tramites\resources\application.properties que se encuentra dentro de la librería catalogo.jar que se está utilizando.
ieci\tecdoc\sgm\rde\resources\application.properties que se encuentra dentro de la librería rde.jar que se está utilizando.
ieci\tecdoc\sgm\registro\resources\application.properties que se encuentra dentro de la librería registro.jar que se está utilizando.
ieci\tecdoc\sgm\autenticacion\resources\application.properties que se encuentra dentro de la librería autenticacion.jar que se está utilizando.
ieci\tecdoc\sgm\catalogo_tramites\resources\application.properties que se encuentra dentro de la librería catalogo.jar que se está utilizando.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 105 de 125
Avanza LOCAL SIGEM
Fuentes de datos
El módulo de Registro Telemático contiene un módulo adicional de iniciación de expedientes, para el caso en el que la definición del Trámite así lo requiera. Este módulo, necesita para su correcto funcionamiento la definición de dos fuentes de datos (DataSources). Las fuentes necesarias asociadas al contexto “REGISTRO_WEB” son:
1) jdbc/SIGEM_TRAMITADORDS:
URL de la fuente de datos: jdbc:postgresql://[IP BBDD]:[Puerto]/tramitadorClase de manejador: org.postgresql.DriverNombre de usuario: [usuario BBDD]Contraseña: [contraseña BBDD]
2) jdbc/INVESDOCDS:
URL de la fuente de datos: jdbc:postgresql://[IP BBDD]:[Puerto]/invesdocClase de manejador: org.postgresql.DriverNombre de usuario: [usuario BBDD]Contraseña: [contraseña BBDD]
Para el resto de parámetros de definición de la fuente de datos, se dejarán los parámetros por defecto.
Base de datos
Para el correcto funcionamiento del módulo del Registro Telemático, es necesario instalar una base de datos que sea accesible por la aplicación. La base de datos a usar será PostgreSQL en su versión 8.2.
Script de creación de tablas
1) Tabla de registros:
CREATE TABLE sgmrtregistro ( numero_registro character varying(16) NOT NULL, -- Número de registro fecha_registro timestamp without time zone, -- Fecha de registro emisor_id character varying(128) NOT NULL, -- Identificador del solicitante nombre character varying(14) NOT NULL, -- Nombre del solicitante apellidos character varying(45) NOT NULL, -- Apellidos del solicitante correo_electronico character varying(60), -- Correo electrónico del solicitante asunto character varying(200) NOT NULL, -- Identificador del trámite organo character varying(7) NOT NULL, -- Identificador del órgano destinatario tipo_emisor_id character varying(1) NOT NULL, -- Tipo de solicitante info_adicional bytea, -- Información adicional estado character varying(1) NOT NULL, -- Estado actual del registro oficina character varying(32), -- Oficina asociada al registro numero_expediente character varying(32), -- Número del expediente asociado al registro CONSTRAINT sgmrderegistry_pkey PRIMARY KEY (numero_registro)) WITHOUT OIDS;
SGM_2007_10_Manual de Implantación y Configuración v01 Página 106 de 125
Avanza LOCAL SIGEM
CREATE INDEX sgmrde_registry_ix1 ON sgmrtregistro USING btree (emisor_id);
CREATE INDEX sgmrde_registry_ix2 ON sgmrtregistro USING btree (fecha_registro);
CREATE INDEX sgmrde_registry_ix4 ON sgmrtregistro USING btree (estado);
CREATE INDEX sgmrde_registry_pk ON sgmrtregistro USING btree (numero_registro);
2) Tabla de asociación de registros y documentos:
CREATE TABLE sgmrtregistro_documentos( numero_registro character varying(16) NOT NULL, -- Número de registro codigo character varying(32) NOT NULL, -- Código del documento guid character varying(32) NOT NULL, -- Identificador del documento conector_firma character varying(32), -- Conector de validación de firma conector_documento character varying(32) -- Conector de validación de contenido) WITHOUT OIDS;
CREATE INDEX sgmrde_registry_ix ON sgmrtregistro_documentos USING btree (numero_registro);
3) Tabla de asociación temporal de registros y documentos:
CREATE TABLE sgmrttmp_documentos( sesionid character varying(64) NOT NULL, -- Identificador de sesión guid character varying(32) NOT NULL, -- Identificador del documento fecha timestamp without time zone NOT NULL -- Fecha de creación) WITHOUT OIDS;
4) Tabla para la generación del número de registro:
CREATE TABLE sgmrtregistro_secuencia( anyo character varying(4) NOT NULL, -- Año del registro etiqueta character varying(8) NOT NULL, -- Identificador de oficina secuencia numeric NOT NULL -- Secuencia de registro) WITHOUT OIDS;
5) Tabla de trámites:
CREATE TABLE sgmrtcatalogo_tramites
SGM_2007_10_Manual de Implantación y Configuración v01 Página 107 de 125
Avanza LOCAL SIGEM
( id character varying(32) NOT NULL, -- Identificador del trámite asunto character varying(32) NOT NULL, -- Asunto del trámite descripcion character varying(256) NOT NULL, -- Descripción del trámite organo character varying(32) NOT NULL, -- Órgano destinatario al que se remite limite_documentos character varying(1) NOT NULL, -- Limitar el núm. de documentos firma character varying(1) NOT NULL DEFAULT 1, -- Obligatoriedad de firmar oficina character varying(32), -- Oficina asociada al trámite CONSTRAINT sgmrdecat_procedure_pkey PRIMARY KEY (id)) WITHOUT OIDS;
CREATE INDEX sgmrdecat_procedure_index ON sgmrtcatalogo_tramites USING btree (id);
6) Tabla de asociación de trámites y tipos de documentos:
CREATE TABLE sgmrtcatalogo_documentostramite( tramite_id character varying(32) NOT NULL, -- Identificador del trámite documento_id character varying(32) NOT NULL, -- Identificador del tipo de documento codigo_documento character varying(32) NOT NULL, -- Código de documento documento_obligatorio character varying(1) NOT NULL, -- Obligatoriedad de asociar al trámite CONSTRAINT sgmrdecat_procedure_document_pkey
PRIMARY KEY (tramite_id, documento_id), CONSTRAINT sgmrdecat_procedure_document_document_id_fkey
FOREIGN KEY (documento_id) REFERENCES sgmrtcatalogo_documentos (id) MATCH SIMPLE ON UPDATE NO ACTION ON DELETE NO ACTION, CONSTRAINT sgmrdecat_procedure_document_procedure_id_fkey
FOREIGN KEY (tramite_id) REFERENCES sgmrtcatalogo_tramites (id) MATCH SIMPLE ON UPDATE NO ACTION ON DELETE NO ACTION) WITHOUT OIDS;
CREATE INDEX fki_ ON sgmrtcatalogo_documentostramite USING btree (documento_id);
7) Tabla de tipo de documentos:
CREATE TABLE sgmrtcatalogo_documentos( id character varying(32) NOT NULL, -- Identificador del tipo de documento descripcion character varying(256) NOT NULL, -- Descripción del tipo de documento extension character varying(8), -- Extensión válida conector_firma character varying(32), -- Conector de firma del tipo de documento conector_contenido character varying(32), -- Conector de contenido del tipo de documento CONSTRAINT sgmrdecat_document_pkey PRIMARY KEY (id)) WITHOUT OIDS;
CREATE INDEX sgmrdecat_document_index ON sgmrtcatalogo_documentos USING btree (id);
SGM_2007_10_Manual de Implantación y Configuración v01 Página 108 de 125
Avanza LOCAL SIGEM
8) Tabla de tipos de conectores:
CREATE TABLE sgmrtcatalogo_tipoconector( tipoid character varying(32) NOT NULL, -- Identificador del tipo de conector descripcion character varying(256) NOT NULL, -- Descripción del tipo de conector CONSTRAINT sgmrdecat_hooktype_pkey PRIMARY KEY (tipoid)) WITHOUT OIDS;
9) Tabla de conectores
CREATE TABLE sgmrtcatalogo_conectores( conectorid character varying(32) NOT NULL, -- Identificador del conector descripcion character varying(256) NOT NULL, -- Descripción del conector tipo character varying(32) NOT NULL, -- Tipo de conector CONSTRAINT sgmrdecat_hook_pkey PRIMARY KEY (conectorid))
CREATE INDEX fki_sgmrdecat_hook_type ON sgmrtcatalogo_conectores USING btree (tipo);
10)Tabla de órganos destinatarios
CREATE TABLE sgmrtcatalogo_organos( organo character varying(7) NOT NULL, -- Identificador del órgano destinatario descripcion character varying(256) NOT NULL, -- Descripción del órgano destinatario CONSTRAINT sgmrdecat_addressee_pkey PRIMARY KEY (organo)) WITHOUT OIDS;
11)Tabla de asociación de trámites y conectores de autenticación
CREATE TABLE sgmafconector_autenticacion( tramiteid character varying(32) NOT NULL, -- Identificador del trámite conectorid character varying(32) NOT NULL, -- Identificador del conector CONSTRAINT sgmafconector_autenticacion_pkey PRIMARY KEY (tramiteid, conectorid)) WITHOUT OIDS;
SGM_2007_10_Manual de Implantación y Configuración v01 Página 109 de 125
Avanza LOCAL SIGEM
5.4.3 Procedimiento de implantación
Fichero WAR
La aplicación vendrá empaquetada en el fichero: REGISTRO_WEB (Web Application Resource), que cumple con las especificaciones Servlet 2.4 y JSP 2.0. Dicho fichero comprimido, es una estructura de directorios y archivos que se puede desplegar en un servidor de aplicaciones de forma sencilla y cuya configuración vendrá descrita en ciertos archivos con formato XML situados dentro del propio fichero WAR.
Despliegue de la aplicación
Existen varias formas de despliegue de un fichero WAR para Tomcat, de las cuales se describen en este documento las dos formas más adecuadas:
De forma manual.
Consiste en depositar el archivo dentro de la estructura de carpetas de Tomcat en el servidor, en concreto dentro de
%TOMCAT_HOME%\webapps
El servidor Tomcat desplegará de forma automática la aplicación web para ser utilizada.
En el caso de que el servidor Tomcat no esté configurado para hacer despliegues automáticos en caliente, se deberá reiniciar el servicio.
A través de su utilidad Web.
Cualquier servidor Tomcat tiene una utilidad llamada “Tomcat Manager” que permite desplegar un fichero WAR al servidor desde nuestro equipo. Se llama vía WEB accediendo a alguna de las siguientes URL’s:
http://%SERVIDOR% (hacer clic sobre opción de menú “Tomcat Manager”)http://%SERVIDOR%/manager/html
La última de las opciones (“Archivo WAR a desplegar”) permite desplegar la aplicación.
Para comprobar si la aplicación se ha instalado con éxito habría que llamar desde el navegador a:
http://%SERVIDOR%/%nombre del fichero WAR%/solicitudesRegistro.do
SGM_2007_10_Manual de Implantación y Configuración v01 Página 110 de 125
Avanza LOCAL SIGEM
5.4.4 Módulos de la aplicación
El módulo de registro telemático depende de los siguientes módulos:
1) Repositorio documental electrónico: se encarga de la creación y recuperación de documentos. El API que contiene la funcionalidad se encuentra en la librería rde.jar.
2) Catálogo de trámites: se encarga de gestionar el acceso al módulo de trámites (recuperación de trámites, conectores y organismos destinatarios). El API que contiene la funcionalidad se encuentra en la librería catalogo.jar.
3) Registro: se encarga de gestionar el acceso al módulo de Registro de Entrada y Salida de SIGEM. Realizará la creación de registros y sus documentos anexos. El API que contiene la funcionalidad se encuentra en la librería registro.jar.
14) Autenticación: se encarga de gestionar el acceso al sistema mediante la
validación de credenciales y el mantenimiento de sesiones de usuario. El API que contiene la funcionalidad se encuentra en la librería autenticacion.jar.
5) Iniciación de expedientes: se encarga de gestionar el acceso al módulo de Gestión de Expedientes y realizar el inicio del expediente a partir de la solicitud. El API que contiene la funcionalidad se encuentra en las librerías invesDoc_92.jar, ispacapi.jar, ispacgendoc.jar, ispacinvesdoc.jar, ispaclib.jar, ispacmgr.jar y ispactx.jar.
6) Clases Base: se encargan de la capa inferior de operaciones (funcionalidad de manejo de xml, conexión a base de datos, etc...). El API que contiene la funcionalidad se encuentra en la librería clasesBase.jar.
7) SIGEM_core: se encarga de implementar diversas funcionalidades (conectores de firma, conectores de contenido, cifrado, etc.). El API que contiene la funcionalidad se encuentra en la librería SIGEM_core.jar.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 111 de 125
Avanza LOCAL SIGEM
5.5Notificación Telemática
5.5.1 Descripción del sistema de Notificación
Una notificación, es un par formado por un mensaje y un documento que están dirigidos a un usuario suscrito (ciudadano o empresa), identificado por en número de DNI, referente a un expediente, identificado por un número de expediente, en concreto.
La notificación se genera desde un organismo emisor (Diputación o Ayuntamiento) que cuente con SIGEM, y la envía al sistema SISNOT que gestiona el ciclo de vida de la notificación. SISNOT manda las notificaciones al sistema SNTS y será el organismo competente, Correos, quien se encargue de mostrársela al usuario, quien finalmente acepta o rechaza la notificación. El sistema general sigue el siguiente esquema:
Cada uno de los sistemas anteriores (SIGEM, SISNOT y SNTS) son independientes y su comunicación es asíncrona, por lo que una misma notificación puede tener un estado distinto en cada uno de los sistemas. Teniendo en cuanta esto, una notificación sigue el siguiente ciclo:
Darse de alta en SIGEM Darse de alta en SISNOT Darse de alta en SNTS Rechazar o firmar en SNTS Actualizar en SISNOT Actualiza en SIGEM
SGM_2007_10_Manual de Implantación y Configuración v01 Página 112 de 125
Avanza LOCAL SIGEM
5.5.2 Instalación del software
Enumeración software de la notificación en SIGEM
El módulo de notificación de SIGEM consiste en la librería java: notificacion.jar que debe incluirse en el “classpath” (conjunto de librerías que utiliza la aplicación) de la aplicación que desea utilizar la notificación. La librería de notificación utiliza además otras librerías externas que también deben de estar presentes en el “classpath” antes mencionado. Estas librerías (ficheros de extensión jar) son:
- activation.jar (versión 1.4.1 o superior)- FastInfoset.jar (versión 1.4.1 o superior)- jaxp-api.jar (versión 1.4.1 o superior)- jax-qname.jar (versión 1.4.1 o superior)- jaxrpc-api.jar (versión 1.4.2 o superior)- jaxrpc-impl.jar (versión 1.4.2 o superior)- jaxrpc-spi.jar (versión 1.4.1 o superior)- jsr173_api.jar (versión 1.4.2 o superior)- log4j-1.2.8.jar (versión 1.2.8 o superior)- mail.jar (versión 1.4.2 o superior)- postgresql-8.0-311.jdbc2.jar (versión 8.0-311 o superior)- relaxngDatatype.jar (versión 1.4.1 o superior)- saaj-api.jar (versión 1.4.2 o superior)- saaj-impl.jar (versión 1.4.2 o superior)- xerces-2.6.2.jar (versión 2.6. 2 o superior)- xsdlib.jar (versión 1.4.2 o superior)
Servidor web
La parte accesible por el usuario, se muestra a través de páginas, que forman una web, a parte del resto de módulos SIGEM. Es decir, se dispone de un fichero “war” que ha ser desplegado en el servidor. Por lo que se debe tener disponibles:
Un servidor TOMCAT versión 5.5 o superior. Tener disponible el contexto “/ notificación” dentro del servidor. Tener 50 MB de memoria física disponible para poder desplegar la aplicación. El servidor debe de estar configurado para:
Puerto seguro
El módulo de notificación espera que se acceda a él mediante una conexión segura y con un certificado valido, por lo que el servidor debe soportar un protocolo de conexión https y habilitar un puerto software para tal fin. En TOMCAT esto se consigue añadiendo un nuevo elemento Conector como por ejemplo:
<Connector port=[puerto] maxHttpHeaderSize="8192"
SGM_2007_10_Manual de Implantación y Configuración v01 Página 113 de 125
Avanza LOCAL SIGEM
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" disableUploadTimeout="true"
acceptCount="100" scheme="https" secure="true"
clientAuth="true" sslProtocol="TLS"
keystoreFile=[certificado en servidor] keystorePass=[clave certificado en servidor]
keystoreType=[protocolo del certificado del servidor]/>
Los elementos que se deben añadir son:
Puerto: identificador del puerto software que se desea habilitar para la conexión segura. Se ha de estar seguro de que no “choca” con otro puerto.
Certificado en servidor: path dentro del sistema de ficheros, donde esté instalado el servidor e indicar donde se encuentra el certificado a contrastar.
Clave certificado en servidor: clave del certificado a contrastar. Protocolo del certificado del servidor: formato del fichero donde se
encuentra el certificado del servidor.
Actualización automática
El servidor debe actualizar constantemente el estado de las notificaciones y mandar las notificaciones que aun estén pendientes de envío. Para ello se deben configurar los elementos Listener del servidor con el elemento:
<Listener className="ieci.timer.Reload"/>
Que requiere de la configuración propia de elementos listener:
<Listener className="org.apache.catalina.mbeans.ServerLifecycleListener"/><Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener"/><Listener className="org.apache.catalina.storeconfig.StoreConfigLifecycleListener"/>
Para que el servidor pueda acceder a “ieci.timer.Reload” se deben añadir las siguientes librerías a $TOMCAT_HOME/lib/common los siguientes jar (la versión de estos jar deben de ser compatibles con la versión 5.5 de TOMCAT):
- ant.jar- ant-launcher.jar- catalina.jar- catalina-ant.jar- catalina-cluster.jar- catalina-optional.jar- catalina-storeconfig.jar- commons-beanutils.jar- commons-collections-3.1.jar- commons-dbcp-1.2.1.jar- commons-digester.jar- commons-el.jar- commons-modeler.jar- commons-pool-1.2.jar
SGM_2007_10_Manual de Implantación y Configuración v01 Página 114 de 125
Avanza LOCAL SIGEM
- jasper-compiler.jar- jasper-runtime.jar- naming-common.jar- naming-factory.jar- naming-factory-dbcp.jar- naming-java.jar- naming-resources.jar- servlet-api.jar- servlets-default.jar- servlets-invoker.jar- servlets-webdav.jar- tomcat-ajp.jar- tomcat-coyote.jar- tomcat-http.jar- tomcat-util.jar- activation.jar (JAX-RPC 1.6)- FastInfoset.jar (JAX-RPC 1.6)- jax-qname.jar (JAX-RPC 1.6)- jaxp-api.jar (JAX-RPC 1.6)- jaxrpc-impl.jar (JAX-RPC 1.6)- jaxrpc-spi.jar (JAX-RPC 1.6)- jsr173_api.jar (JAX-RPC 1.6)- mail.jar (JAX-RPC 1.6)- relaxngDataType.jar (JAX-RPC 1.6)- saaj-api.jar (JAX-RPC 1.6)- saaj-impl.jar (JAX-RPC 1.6)- xsdlib.jar (JAX-RPC 1.6)- log4j-1.2.8.jar- postgresql-8.0.311.jdbc2.jar- xerces-2.6.2.far
Además de las librerías donde se encuentren los módulos de SIGEM de notificación y de documentos.
Maquina virtual JAVA
La MVJ donde se lance el servidor TOMCAT. Versión 1.4.2 o superior.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 115 de 125
Avanza LOCAL SIGEM
5.5.3 Base de datos. Entidades necesarias
El módulo de notificación, como en general todos los desarrollos de SIGEM, tiene sus propias tablas en la base de datos PostgreSQL 8.2. La información que necesita saber cada módulo, es dónde se encuentra dicha base de datos. Esta información se encuentra en el fichero de propiedades:
ieci\tecdoc\sgm\srv\notificacion\impl\resources\application.properties
Que a su vez se encuentra, dentro de la librería notificación.jar que se está utilizando.
A continuación se incluye el script de creación de tablas, índices e inserción de valores predeterminados, necesarios para la instalación de la notificación en SIGEM:
CREATE TABLE sgmntinfo_documento( cnotiexpe character(10) NOT NULL, cnotinifdest character(10) NOT NULL, ccodigo character varying(200), cguid character varying(32), chash character varying(100), CONSTRAINT sgmntinfo_documentos_noti_fk FOREIGN KEY (cnotiexpe, cnotinifdest) REFERENCES sgmntinfo_notificacion (cnumexp, cnifdest) MATCH SIMPLE ON UPDATE NO ACTION ON DELETE NO ACTION) WITHOUT OIDS;ALTER TABLE sgmntinfo_documento OWNER TO postgres;
-- Index: fki_sgmntinfo_documentos_noti_fk
-- DROP INDEX fki_sgmntinfo_documentos_noti_fk;
CREATE INDEX fki_sgmntinfo_documentos_noti_fk ON sgmntinfo_documento USING btree (cnotiexpe, cnotinifdest);
CREATE TABLE sgmntinfo_estado_noti( cguid integer NOT NULL, -- Indentificador interno del estado cuidsisnot character varying(100), -- Estado equivalente en sisnot cdescripcion character varying(100), -- Descripcion valida para mostrar al usuario CONSTRAINT sgmntinfo_estado_noti_pk PRIMARY KEY (cguid)) WITHOUT OIDS;ALTER TABLE sgmntinfo_estado_noti OWNER TO postgres;COMMENT ON COLUMN sgmntinfo_estado_noti.cguid IS 'Indentificador interno del estado';
SGM_2007_10_Manual de Implantación y Configuración v01 Página 116 de 125
Avanza LOCAL SIGEM
COMMENT ON COLUMN sgmntinfo_estado_noti.cuidsisnot IS 'Estado equivalente en sisnot';COMMENT ON COLUMN sgmntinfo_estado_noti.cdescripcion IS 'Descripcion valida para mostrar al usuario';
CREATE TABLE sgmntinfo_notificacion( cguid character varying(10), -- Identificador de la notificacion cnifdest character(10) NOT NULL, -- nif del destinatario de la notificacion cnumreg character varying(10), -- numero de registro cfhreg date, -- fecha de registro cnumexp character varying(10) NOT NULL, -- numero de expediente cproc character varying(50), -- procedimiento asociado a la notficacion cestado integer, -- estado de la notificacion en la ultima actualizacion cfhestado date, -- fecha de la ultima actualizacion del estado cfhentrega date, -- fecha de creacion de la notificacion en el sistema cusuario character varying(100), -- usuario asociado a la notificacion ctipocorrespondencia character varying(10), -- Tipo de correspondencia de la notifiacacoin corganismo character varying(100), -- organismo responsable de la notificacion. Es la entidad emisora con respecto al sisnot casunto character varying(100), -- asunto de la notificacion ctipo character varying(20), -- tipo de notificacion ctexto character varying(1000), -- texto de la notificacion cnombredest character varying(100), -- nombre del destinatario capellidosdest character varying(150), -- apellidos de la notifiaccion ccorreodest character varying(200), -- correo del destinatario cidioma character varying(20), -- idioma asociada a la notificacion ctipovia character varying(10), -- tipo de via de la direccion cvia character varying(200), -- Nombre de la via cnumerovia character varying(10), -- numero de la direccion cescaleravia character varying(10), -- escalera de la direccion cpisovia character varying(10), -- piso de la direccion cpuertavia character varying(10), -- puerta de la direccion ctelefono character varying(20), -- telefono de la direccion cmunicipio character varying(100), -- municipio de la direccion cprovincia character varying(100), -- provincia de la direccion ccp character varying(10), -- codigo postal de la direccion cerror character varying(100), CONSTRAINT sgmntinfo_notificacion_pk PRIMARY KEY (cnumexp, cnifdest), CONSTRAINT sgmnt_info_notificacion_estado_noti_fk FOREIGN KEY (cestado) REFERENCES sgmntinfo_estado_noti (cguid) MATCH SIMPLE ON UPDATE NO ACTION ON DELETE NO ACTION) WITHOUT OIDS;ALTER TABLE sgmntinfo_notificacion OWNER TO postgres;COMMENT ON COLUMN sgmntinfo_notificacion.cguid IS 'Identificador de la notificacion';COMMENT ON COLUMN sgmntinfo_notificacion.cnifdest IS 'nif del destinatario de la notificacion';COMMENT ON COLUMN sgmntinfo_notificacion.cnumreg IS 'numero de registro';COMMENT ON COLUMN sgmntinfo_notificacion.cfhreg IS 'fecha de registro';COMMENT ON COLUMN sgmntinfo_notificacion.cnumexp IS 'numero de expediente';
SGM_2007_10_Manual de Implantación y Configuración v01 Página 117 de 125
Avanza LOCAL SIGEM
COMMENT ON COLUMN sgmntinfo_notificacion.cproc IS 'procedimiento asociado a la notficacion';COMMENT ON COLUMN sgmntinfo_notificacion.cestado IS 'estado de la notificacion en la ultima actualizacion';COMMENT ON COLUMN sgmntinfo_notificacion.cfhestado IS 'fecha de la ultima actualizacion del estado';COMMENT ON COLUMN sgmntinfo_notificacion.cfhentrega IS 'fecha de creacion de la notificacion en el sistema';COMMENT ON COLUMN sgmntinfo_notificacion.cusuario IS 'usuario asociado a la notificacion';COMMENT ON COLUMN sgmntinfo_notificacion.ctipocorrespondencia IS 'Tipo de correspondencia de la notifiacacoin';COMMENT ON COLUMN sgmntinfo_notificacion.corganismo IS 'organismo responsable de la notificacion. Es la entidad emisora con respecto al sisnot';COMMENT ON COLUMN sgmntinfo_notificacion.casunto IS 'asunto de la notificacion';COMMENT ON COLUMN sgmntinfo_notificacion.ctipo IS 'tipo de notificacion';COMMENT ON COLUMN sgmntinfo_notificacion.ctexto IS 'texto de la notificacion';COMMENT ON COLUMN sgmntinfo_notificacion.cnombredest IS 'nombre del destinatario';COMMENT ON COLUMN sgmntinfo_notificacion.capellidosdest IS 'apellidos de la notifiaccion';COMMENT ON COLUMN sgmntinfo_notificacion.ccorreodest IS 'correo del destinatario';COMMENT ON COLUMN sgmntinfo_notificacion.cidioma IS 'idioma asociada a la notificacion';COMMENT ON COLUMN sgmntinfo_notificacion.ctipovia IS 'tipo de via de la direccion';COMMENT ON COLUMN sgmntinfo_notificacion.cvia IS 'Nombre de la via';COMMENT ON COLUMN sgmntinfo_notificacion.cnumerovia IS 'numero de la direccion';COMMENT ON COLUMN sgmntinfo_notificacion.cescaleravia IS 'escalera de la direccion';COMMENT ON COLUMN sgmntinfo_notificacion.cpisovia IS 'piso de la direccion';COMMENT ON COLUMN sgmntinfo_notificacion.cpuertavia IS 'puerta de la direccion';COMMENT ON COLUMN sgmntinfo_notificacion.ctelefono IS 'telefono de la direccion';COMMENT ON COLUMN sgmntinfo_notificacion.cmunicipio IS 'municipio de la direccion';COMMENT ON COLUMN sgmntinfo_notificacion.cprovincia IS 'provincia de la direccion';COMMENT ON COLUMN sgmntinfo_notificacion.ccp IS 'codigo postal de la direccion';
-- Index: fki_sgmnt_info_notificacion_estado_noti_fk
-- DROP INDEX fki_sgmnt_info_notificacion_estado_noti_fk;
CREATE INDEX fki_sgmnt_info_notificacion_estado_noti_fk ON sgmntinfo_notificacion USING btree (cestado);
insert into sgmntinfo_estado_noti values (-1,'Fallo', 'Fallo de envio');insert into sgmntinfo_estado_noti values (0,'Notificación creada', 'Notificación creada');insert into sgmntinfo_estado_noti values (1,'Notificación enviada', 'Notificación enviada');insert into sgmntinfo_estado_noti values (2,'Notificación puesta a disposición', 'Notificación puesta a disposición');
SGM_2007_10_Manual de Implantación y Configuración v01 Página 118 de 125
Avanza LOCAL SIGEM
insert into sgmntinfo_estado_noti values (3,'Notificación leída', 'Notificación leída');insert into sgmntinfo_estado_noti values (4,'Notificación expirada después de 10 días', 'Notificación expirada después de 10 días');insert into sgmntinfo_estado_noti values (5,'Notificación rechazada', 'Notificación rechazada');insert into sgmntinfo_estado_noti values (6,'Notificación finalizada (Cambio de estado comunicado al sistema emisor)', 'Notificación finalizada (Cambio de estado comunicado al sistema emisor)');insert into sgmntinfo_estado_noti values (7,'Usuario no suscrito', 'Usuario no suscrito');
5.5.4 Servidor de aplicaciones
El sistema SISNOT requiere un servidor de aplicaciones que sea WebSphere o JBoss. La maquina donde se instale el servidor de aplicaciones no tiene porque ser la misma donde se instale el servidor web, pero si que debe ser accesible por éste. Para los detalles técnicos y de configuración del servidor de aplicaciones se debe de consultar el documento SISNOT_Manual_Explotacion_V1.3.pdf de la documentación de SISNOT.
Una vez instalado el contexto SISNOT dentro del servidor de aplicaciones, este requiere de una estructura de directorios en la maquina donde este instalado el servidor. Esta estructura es fija, por lo que se debe permitir crear en el raíz del sistema de archivos un directorio llamado sisnot. Para su correcto funcionamiento se deben de dejar 30 MB de memoria física para este aspecto.
SISNOT debe de tener acceso para conectarse al sistema SNTS. El acceso se consigue conectándose a la siguiente dirección IP:
Desarrollo / Pruebas http://193.148.159.24Producción (Consultar al organismo SNTS)
Para configurar la dirección IP a la que conectarse, se puede utilizar el entorno web de administración de SISNOT (recomendado) o modificar el fichero /sisnot/config/sisnot.xml
Conexión con el módulo de notificaciones de SIGEM
Una vez instalado y lanzado el SISNOT, hay que informar al módulo de notificaciones donde están los servicios web que ofrece SISNOT. Es decir, hay que decirle donde está instalado el SISNOT. Esta información se comunica en el fichero de propiedades ieci\tecdoc\sgm\srv\notificacion\impl\cliente\config.properties que se encuentra dentro de la librería notificación.jar que se está utilizando.
Maquina virtual JAVA
La MVJ donde se lance el servidor JBoss o WebSphere. Versión 1.5 o superior.
Base de datos
SGM_2007_10_Manual de Implantación y Configuración v01 Página 119 de 125
Avanza LOCAL SIGEM
Complementando la información de SISNOT aportada por el documento: SISNOT_Manual_Explotacion_V1.3.pdf, donde se alude a las dos bases de datos que se deberán crear: DefaultDS y SisnotDS y referenciar en el fichero de configuración del contexto de sisnot server/postgres/deploy/postgres-ds.xml, informar que las bases de datos, se inicializarán automaticamente la primera vez que se lance la aplicación. Se hace un breve resumen de lo que deben contener:
Tabla: sn_doc_notificacion, sn_notificacion, sn_procedimiento, sn_remesa, sn_sistema_emisor, sn_suscripcion, sn_tipo_correspondencia y sn_usuario.
Secuencias: sn_doc_notificacion_cod_notificacion_seq, sn_notificacion_ncc_seq y sn_remesa_cod_remesa_seq
Valores: indicamos el estado inicial de las tablas que contienen algún registro:
sn_sistema_emisorcod_emisor dir_servicio descripcion
SIGEM (*) Sistema Integrado de Gestión Municipal
SISNOT es.map.sn.emisores.ConexionMAP Aplicación cliente SISNOT
(*) Este valor debe de coincidir con el del fichero sisnot/config/sisnot.properties en su campo Cod_Admon por lo que es muy probable que se tenga que cambiar el valor que exista en el fichero.
sn_tipo_correspondenciatipo_correspondencia descripcion encriptar
CENSO CENSO FALSECOMSIGEM SIN CIFRAR FALSENOTSIGEM CIFRADAS TRUE
SGM_2007_10_Manual de Implantación y Configuración v01 Página 120 de 125
Avanza LOCAL SIGEM
5.6Pago Electrónico
5.6.1 Descripción del sistema de Pago Electrónico
El sistema de Pago Electrónico incluido con la distribución de SIGEM, utiliza el interfaz de servicios de pago ofrecido por Red.es. El sistema mantiene un modelo de información propio, ubicado en la base de datos, donde se almacenan los datos necesarios para la gestión de los pagos realizados. Para la comunicación con las entidades colaboradoras, invoca de forma remota a Red.es.
En el siguiente diagrama se indica la arquitectura del módulo de Pago Telemático:
SGM_2007_10_Manual de Implantación y Configuración v01 Página 121 de 125
Avanza LOCAL SIGEM
5.6.2 Instalación del software
Enumeración software del módulo de Pago Telemático
SIGEM_PagoElectronicoWeb.war, Web Application Resource, que cumple con las especificaciones Servlet 2.4 y JSP 2.0
Truststoreredes: almacén de autoridades certificadores en las que se confía para establecer conexiones seguras de red. Incluye la autoridad certificadora del certificado del servidor de Red.es.
Es necesario tener accesible el certificado del servidor para los procesos de firma.
Modelo-Pago.sql: script de generación del modelo de datos.
Servidor J2EE
El módulo de Pago Telemático incluye una aplicación web, para acceso del ciudadano, desde el Portal del organismo o desde una URL especificada. Esta aplicación tiene los siguientes requisitos:
Esta aplicación web debe estar desplegada en un servidor de aplicaciones J2EE. El servidor por defecto de la distribución en Apache Tomcat 5.x.
Tener disponible el contexto “/SIGEM_PagoElectronicoWeb” dentro del servidor. El servidor debe tener habilitado un puerto, para conexión segura con
autenticación de cliente:
Puerto seguro
El módulo de notificación espera que se acceda a él mediante una conexión segura y con un certificado valido, por lo que el servidor debe soportar un protocolo de conexión https y habilitar un puerto software para tal fin. En TOMCAT esto se consigue añadiendo un nuevo elemento Conector como por ejemplo:
<Connector port=[puerto] maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" disableUploadTimeout="true"
acceptCount="100" scheme="https" secure="true"
clientAuth="true" sslProtocol="TLS"
keystoreFile=[certificado en servidor] keystorePass=[clave certificado en servidor]
keystoreType=[protocolo del certificado del servidor]/>
Los elementos que se deben añadir son:
SGM_2007_10_Manual de Implantación y Configuración v01 Página 122 de 125
Avanza LOCAL SIGEM
Puerto: identificador del puerto software que se desea habilitar para la conexión segura. Se ha de estar seguro de que no “choca” con otro puerto.
Certificado en servidor: path dentro del sistema de ficheros, donde esté instalado el servidor e indicar donde se encuentra el certificado a contrastar.
Clave certificado en servidor: clave del certificado a contrastar. Protocolo del certificado del servidor: formato del fichero donde se
encuentra el certificado del servidor.
Maquina virtual JAVA
Versión 1.4.2_X, preferiblemente la versión 1.4.2_14.
Base de datos
El módulo de Pago Telemático, se construye sobre un modelo de datos, que debe ser almacenado en un gestor de bases de datos relacional. Para SIGEM, el gestor que se utiliza es Postgres versión 8.2. El modelo de tablas se almacena en el esquema creado para SIGEM.
Instalación paso a paso
Los pasos a realizar para la instalación del módulo de pago son los siguientes:
Despliegue de la aplicación Web. Se puede hacer de dos formas:o Copiar el archivo SIGEM_PagoElectronicoWeb.war al directorio
<RAIZ_TOMCAT>/webapps. Una vez que el servidor sea arranque se encargará del despliegue automáticamente, creando el directorio <RAIZ_TOMCAT>/webapps/SIGEM_PagoElectronicoWeb.war. Dentro de este directorio tendremos accesibles todos los componentes de la aplicación.
o Utilizar la consola de administración de Tomcat para realizar el despligue. Un vez conectados a la consola seleccionamos de nuestro disco local el archivo .war y realizamos el despliegue. El resultado será el mismo que de la forma anterior, tendremos un directorio <RAIZ_TOMCAT>/webapps/SIGEM_PagoElectronicoWeb.war en el que tendremos accesibles todos los componentes de la aplicación.
Copia del trustore a un directorio accesible dentro de : <RAIZ_TOMCAT>. Copiaremos el archivo “trustoresredes” dentro de la carpeta: <RAIZ_TOMCAT>/conf. Como veremos más abajo, tendremos que indicar la ruta elegida en los archivos de configuración.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 123 de 125
Avanza LOCAL SIGEM
5.6.3 Configuración
Existen una serie de archivos de propiedades que deben ser configurados para el correcto funcionamiento del módulo de pago. Los archivos y la descripción de sus propiedades se detallan a continuación:
PagoElectronico.properties: Archivo de configuración del módulo de pago telemático. Esta situado en el directorio /<RAIZ_TOMCAT> / Webapps/SIGEM_PagoElectronico/WEB-INF/lib/SIGEM_PagoElectronico/ieci/ tecdoc/sgm/pe/resources/. En este archivo hay que configurar las siguientes entradas:
o Database: cadena de conexión jdbc a la base de datos. Por ejemplo: jdbc:postgresql://128.90.31.75/postgres
o User: usuario de conexión a la base de datos.o Password: contraseña del usuario de base de datos.
SPTRedes.properties: Archivo de configuración del servicio de pago de Red.es. Está situado en el directorio /<RAIZ_TOMCAT> / Webapps/SIGEM_PagoElectronico/WEB-INF/lib/SIGEM_PagoElectronico/ieci/ tecdoc/sgm/pe/impl/redes/resources. En este archivo hay que configurar:
o ieci.tecdoc.sgm.pe.impl.redes.RedesSistemaPagoElectronico.http.proxyHost: nombre de la máquina Proxy para el acceso a Internet desde la red local del ayuntamiento.
o ieci.tecdoc.sgm.pe.impl.redes.RedesSistemaPagoElectronico.http.proxyPort: puerto de la máquina Proxy por el que acceder.
o ieci.tecdoc.sgm.pe.impl.redes.RedesSistemaPagoElectronico.http.proxyUser: usuario de acceso al Proxy.
o ieci.tecdoc.sgm.pe.impl.redes.RedesSistemaPagoElectronico.http.proxyPassword: password de usuario del Proxy.
o ieci.tecdoc.sgm.pe.impl.redes.RedesSistemaPagoElectronico.javax.net.ssl.trustStore: ruta al almacén de autoridades certificadores de confianza (archivo truststoreredes ).
o ieci.tecdoc.sgm.pe.impl.redes.RedesSistemaPagoElectronico.javax.net.ssl.trustStorePassword: password de acceso al almacén de autoridades certificadoras de confianza.
o ieci.tecdoc.sgm.pe.impl.redes.RedesSistemaPagoElectronico.endpoint.url: URL del servicio web de Red.es
o ieci.tecdoc.sgm.pe.impl.redes.RedesSistemaPagoElectronico.param.firma.alias: alias dentro del almacén de certificados del servidor del certificado del ayuntamiento utilizado para realizar la firma de los mensajes de comunicación con el servidor de Red.es.
o ieci.tecdoc.sgm.pe.impl.redes.RedesSistemaPagoElectronico.param.firma.pass: clave del almacén de certificados.
o ieci.tecdoc.sgm.pe.impl.redes.RedesSistemaPagoElectronico.param.cryto.properties.file: nombre del archivo de propiedades para la implementación específica de firma electrónica ( Ver crypto.properties ).
Crypto.properties: archivo de configuración del conector de firma. Está situado en el directorio /<RAIZ_TOMCAT> / Webapps/SIGEM_PagoElectronico/WEB-INF/lib/SIGEM_PagoElectronico. En este archivo hay que configurar:
o org.apache.ws.security.crypto.merlin.file: ruta al archivo con el certificado del servidor.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 124 de 125
Avanza LOCAL SIGEM
o org.apache.ws.security.crypto.merlin.alias.user: usuario de acceso al certificado.
o org.apache.ws.security.crypto.merlin.alias.password: password de acceso al certificado.
o org.apache.ws.security.crypto.merlin.keystore.alias: alias del certificado dentro del almacén.
o org.apache.ws.security.crypto.merlin.keystore.password: password para acceder al almacén.
o org.apache.ws.security.crypto.merlin.keystore.type: tipo de almacén.
SGM_2007_10_Manual de Implantación y Configuración v01 Página 125 de 125