MANUAL INSTALACIÓN Archivo Documental DETALLE DOCUMENTO Creado: Junio 2006 Version: 1.1 Autor: Fujitsu España Services S.A.
CONTROL DE CAMBIOS Versión Fecha Comentarios 1.0 11/05/2006 Versión inicial del manual de instalación de gvadoc. 1.1 27/06/2006 Multiformato. Página 2 de 26
ÍNDICE 1. Objeto...4 2. Prerrequisitos. Software de plataforma....5 2.1 Instalación de libtiff...5 3. Instalación... 7 3.1 Creación de las Bases de datos... 7 3.2 Instalación de la aplicación Web... 10 3.2.1 Creación de un contexto para la aplicación... 10 3.2.2 Copia de la aplicación web... 11 3.2.3 Configuración de la aplicacion... 11 3.2.4 Ficheros de etiquetas de idioma... 20 3.3 Comprobación básica. Acceso a la aplicación... 23 4. Anexo: Configuración AXIS 7000... 25 Página 3 de 26
1. OBJETO En este documento se recoge el procedimiento a seguir para realizar la instalación de la aplicación de Archivo Documental (gvadoc). Para realizar la instalación se parte de software de plataforma gratuito, compuesto por Linux, PostgreSQL, Tomcat y J2SE, cuyo proceso de instalación no se incluye en este documento por estar disponible en la Web. A continuación se incluyen enlaces a los sitios Web de cada componente software: Linux Distribuciones más extendidas: RedHat (http://www.redhat.com) SuSe (http://www.suse.de) PostgreSQL http://www.postgresql.org Tomcat http://jakarta.apache.org/tomcat J2SE http://java.sun.com/j2se Las tareas a realizar para la instalación de la aplicación: 1. Verificación del software de plataforma 2. Instalación de la aplicación a. Creación de las Bases de Datos b. Instalación de la aplicación web i. Creación del contexto ii. Creación de la aplicación iii. Configuración de la aplicación 3. Comprobaciones básicas: acceso a la aplicación Página 4 de 26
2. PRERREQUISITOS. SOFTWARE DE PLATAFORMA. El software de plataforma necesario para instalar Adoc está formado por los siguientes componentes: SOFTWARE FUNCIONALIDAD Requisitos Linux Sistema Operativo Versión 2.4.xx del kernel PostgreSQL Servidor BBDD Versión 7.x ó superiores JDK Máquina virtual Java Versión 1.4 Tomcat Motor Servlets Versión 4.1.xx ó 5.x Libtiff Se usa la herramienta tiffsplit del paquete libtiff para separar las páginas de un fichero tipo tiff. Versión 3.6.1. Tiffsplit es necesario a partir de la versión 1.3 de la aplicación Las versiones del software anterior que aparece en la columna de Requisitos son las que están probadas convenientemente, de manera que se puede asegurar el correcto funcionamiento de la aplicación gvadoc. La instalación de versiones diferentes puede generar comportamientos no deseados de la aplicación. Antes de proseguir con el proceso de instalación es necesario cerciorarse de que todos estos componentes software estén correctamente instalados y en las versiones que aquí se indican. 2.1 Instalación de libtiff Libtiff es un conjunto de herramientas Open Source para proporcionar el tratamiento de las imágenes tiff. En Gestión Documental se utiliza la utilidad de libtiff llamada tiffsplit para separar los ficheros tiff multipágina y guardarlas en los ficheros separados. La última versión del proyecto y la descripción detallada se puede encontrar en: http://www.remotesensing.org/libtiff/ Libtiff está escrita en C, y por eso requiere una recompilación. En el CD en la carpeta TOOLS, se encuentra el directorio tiff-v3.6.1. Hay que copiar la carpeta a la máquina del servidor, y luego seguir los pasos del README que está allí para instalar la herramienta. En principio basta con seguir las siguientes instrucciones: 1. Ejecutar el comando configure para configurar el proceso de compilación: %./configure Página 5 de 26
2. Ejecutar el comando siguiente para limpiar las dependencias que puedan quedar después de otras compilaciones: % make clean (el readme indica únicamente realizar un make, pero es más seguro efectuar previamente un clean) 3. Compilar el proyecto con el comando make: % make 4. Cambiar la cuenta a la cuenta del root: % su 5. Instalar la librería compilada: % make install Si la herramienta se ha instalado con éxito tras ejecutar el comando tiffsplit se debería ver el output siguiente: usage: tiffsplit input.tif [prefix] Nota: El servidor de las aplicaciones WEB (tomcat por ejemplo) debe incluir en su variable de entorno PATH la ruta donde se instaló el tiffsplit. Si el servidor de las aplicaciones WEB se arranca como servicio hay que asegurarse de que realmente el contenido de su variable PATH contiene la ruta deseada. Página 6 de 26
3. INSTALACIÓN Una vez validado el software de plataforma sobre el que se ha de ejecutar la aplicación Adoc, se procede a realizar la instalación. El proceso de instalación consta de las siguientes partes fundamentales: creación de las bases de datos creación de la aplicación web o creación del contexto o creación de la aplicación o configuración comprobaciones básicas 3.1 Creación de las Bases de datos El primer paso de la instalación es la creación de las Bases de Datos. Existe una restricción en cuanto a la propiedad de los objetos de Base de Datos: El nombre del esquema que contendrá los objetos de Base de Datos (tablas, vistas, etc.) de la aplicación y el nombre de usuario de conexión a ese esquema deberán coincidir. Esta restricción viene impuesta por el funcionamiento de los drivers JDBC para PosgreSQL. La creación de la Base de Datos se realizará mediante la ejecución de scripts contenidos en ficheros de texto. Para hacerlo se recomienda el uso de pgadmin, una herramienta con una interfaz de usuario que permite lanzar los scripts de manera rápida y fácil contra motores de base de datos PostgreSQL. Este manual asume el uso de esta herramienta, aunque también es posible la creación de la Base de Datos desde la consola de PostgreSQL, lo que no se recomienda a no ser que el usuario posea un amplio nivel de conocimientos sobre PostgreSQL. Los scripts de creación de la Base de Datos y tablas se encuentran en el directorio gvadoc/resources/db (scriptspostgresql). Para lanzarlos es necesario establecer una conexión contra el motor de BD con el usuario correspondiente y abrir una ventana para ejecución de sentencias SQL. Página 7 de 26
Los pasos necesarios para la creación de la Base de Datos y las tablas son: 1. Conectarse al servidor postgres como un usuario con permiso de creación de bases de datos, abrir ventana para ejecución de sentencias SQL, y lanzar el script contenido en el fichero 01crear_db.txt este fichero crea la Base de Datos vacía, y además establece el formato europeo para la representación de los datos de tipo fecha. Antes de lanzarlo hay que sustituir el nombre de BD que viene por defecto en la instalación (adoc), si se desea cambiarlo, en las siguientes líneas: CREATE DATABASE adoc ENCODING='LATIN1'; ALTER DATABASE adoc SET DateStyle TO 'European'; ALTER DATABASE adoc SET DateStyle TO 'European'; 2. Conectarse a la base de datos creada. Si la ejecución se realiza desde pgadmin, basta con seleccionarla en el desplegable de Databases. Si se realiza desde la consola de psql, habrá que escribir: \c adoc; Página 8 de 26
3. Si el servidor PostgreSQL está instalado en un sistema Linux, será necesario crear el soporte para lenguaje de script. Lanzar para ello el contenido del fichero 02crear_lenguaje.txt. 4. Crear el esquema para el usuario que se va a usar para acceder desde la aplicación a la base de datos (el usuario debe estar ya creado; si no lo está, deberá crearse antes del esquema). Para ello, lanzar el contenido del fichero 03crear_esquema.txt, sustituyendo la cadena nombre_usuario por el nombre de usuario que se usará para la conexión desde la aplicación. Este comando crea un esquema con el mismo nombre que el usuario, tal y como se necesita. CREATE SCHEMA AUTHORIZATION nombre_usuario; 5. Conectarse a la base de datos creada con el usuario que se va a usar. Desde la consola de psql, y asumiendo que ya se está conectado a la base de datos, bastaría con escribir: \c nombre_usuario 6. Lanzar el contenido del fichero 04crear_tablas.txt este fichero contiene los scripts de creación de objetos de Base de Datos (tablas, vistas, etc.). Todas las operaciones que realiza este script se engloban dentro de una transacción, de manera que si ocurre algún problema durante la ejecución de los scripts, la Base de Datos permanecerá vacía. 7. Según el tipo de ordenación para las entidades que se va a definir, es decir, de acuerdo a lo que se vaya a especificar en el fichero de configuración cit.conf para las entidades (véase apartado ), habrá que definir una función en la base de datos distinta. Por tanto: o Si las entidades deben tener una ordenación numérica, lanzar el contenido del fichero 05funcion_entidad_numerica.txt. o En caso contrario, lanzar el contenido del fichero 05funcion_entidad_no_numerica.txt. 8. Lanzar el contenido del fichero 06datos_precargados.txt contiene los datos que son necesarios para la aplicación. 9. Lanzar el contenido del fichero 07_funcion_usuario.txt crea la secuencia de la tabla usuario. Página 9 de 26
10.Lanzar el contenido del fichero 08_macros_CIT.txt macros específicos de CIT. 11.Lanzar el contenido del fichero 09_indices.txt crea un índice en la tabla páginas. 3.2 Instalación de la aplicación Web La aplicación web es una aplicación Java que se ejecuta en el contenedor de servlets Tomcat, en alguna de sus versiones compatible con la versión 1.4 de Java Standard Edition (J2SE). Se deberá crear un contexto para la aplicación y posteriormente copiar el directorio correspondiente desde el CD o del archivo gvadocweb_src que se puede descargar de la web del proyecto. 3.2.1 Creación de un contexto para la aplicación Aunque no es necesario, se recomienda la creación de un contexto para la aplicación, donde se puedan especificar parámetros que sólo influirán a la aplicación en cuestión. Para ello, es necesario editar el fichero server.xml ubicado en el directorio conf del servidor Tomcat y pegar el siguiente fragmento de texto: <Context path="/nom_apli" docbase="nom_apli" debug="0" reloadable="true" crosscontext="true"> <Logger classname="org.apache.catalina.logger.filelogger" prefix=" nom_apli_log." suffix=".txt" timestamp="true"/> <Valve classname="org.apache.catalina.valves.accesslogvalve" directory="logs" prefix="lrosa_access_log" suffix=".txt" pattern="common" resolvehosts="false"/> </Context> En la parte de definición de contextos del fichero (a continuación de cualquier contexto existente, después de que se haya cerrado el tag Context). Se deberá cambiar el texto resaltado en negrita nom_apli por el nombre elegido para la aplicación. También será necesario crear un directorio llamado nom_apli, dentro del directorio webapps del Tomcat, ya que si dicho directorio no existe el servidor Tomcat no podrá arrancar. Página 10 de 26
3.2.2 Copia de la aplicación web El siguiente paso es la creación de la aplicación web mediante la copia del directorio contenido de gvadoc/resources/gvadocweb desde el CD de instalación o descargando y descomprimiendo el archivo gvadocweb_src. El contenido debe ser copiado al directorio que se ha creado para la aplicación, dentro del directorio de aplicaciones de Tomcat (webapps). Otra forma es descargar el fichero gvadocweb_bin*.war, entrar a http://máquina:puerto/ (puerto de tomcat) y acceder a tomcat manager, una vez dentro seleccionar el war y pulsar en desplegar. 3.2.3 Configuración de la aplicacion A continuación se listan los ficheros de configuración de la aplicación a modificar, su ruta y el significado de los parámetros a cambiar. Las rutas se toman a partir del directorio de instalación de la aplicación web. WEB-INF/properties/cit_access.properties Permite configurar los permisos de acceso a las páginas jsp y a los servlets de la aplicación. Es necesario editar este fichero y configurar la ruta relativa a la aplicación web (sustituir nom_apli por el nombre de la aplicación web que se haya elegido).... # A D M I N I S T R A C I O N # /nom_apli/admin/entidades/=h /nom_apli/admin/estructura/=e /nom_apli/admin/estructura/dialogos/=e /nom_apli/admin/estructura/avisos/=e /nom_apli/admin/volumenes/=i /nom_apli/principal.jsp=abcdefghi /nom_apli/admin/usuarios/perfiles.jsp=g /nom_apli/admin/usuarios/busqperfil.jsp=g /nom_apli/admin/usuarios/frmperfil.jsp=g /nom_apli/admin/usuarios/listaperfiles.jsp=g /nom_apli/admin/usuarios/perfilentidad.jsp=g Página 11 de 26
/nom_apli/admin/usuarios/perfilpermiso.jsp=g /nom_apli/admin/usuarios/perfilusuario.jsp=g /nom_apli/admin/usuarios/usuarios.jsp=f /nom_apli/admin/usuarios/busqusuario.jsp=f /nom_apli/admin/usuarios/frmusuario.jsp=f /nom_apli/admin/usuarios/listausuarios.jsp=f # # S E R V L E T S # /nom_apli/servlet/cit.admin.servlets.gestionentidadesservlet=h /nom_apli/servlet/cit.admin.servlets.gestionperfilesservlet=g /nom_apli/servlet/cit.admin.servlets.gestionusuariosservlet=f /nom_apli/servlet/cit.admin.servlets.perfilesentidadesservlet=g /nom_apli/servlet/cit.admin.servlets.perfilesusuariosservlet=g /nom_apli/servlet/cit.admin.servlets.permisosperfilesservlet=g /nom_apli/servlet/cit.admin.servlets.construirrutaservlet=e /nom_apli/servlet/cit.admin.servlets.gestionarnodo=e /nom_apli/servlet/cit.admin.servlets.propiedadareaservlet=e /nom_apli/servlet/cit.admin.servlets.propiedadexternoservlet=e /nom_apli/servlet/cit.admin.servlets.propiedadgenericservlet=e /nom_apli/servlet/cit.admin.servlets.propiedadlistaservlet=e /nom_apli/servlet/cit.admin.servlets.propiedadtextoservlet=e /nom_apli/servlet/cit.admin.servlets.propiedadtipodeservlet=e /nom_apli/servlet/cit.catalog.servlets.catalogoservlet=ab /nom_apli/servlet/cit.catalog.servlets.catalogoicoservlet=ab /nom_apli/servlet/cit.catalog.servlets.catbusqexpertaservlet=ab /nom_apli/servlet/cit.catalog.servlets.catalogimpresionservlet= j /nom_apli/servlet/cit.catalog.servlets.imagepagegeneratorservle t=j /nom_apli/servlet/cit.catalogo.servlets.paginasservlet=bk # # C A T A L O G A C I Ó N # /nom_apli/catalogo/=ab /nom_apli/catalogo/imprimiendo.jsp=j /nom_apli/catalogo/dialogos/enviarcorreo.jsp=c /nom_apli/catalogo/dialogos/enviarcorreo.jsp=c... Página 12 de 26
De esta forma se consigue evitar que los usuarios puedan acceder a las páginas de la aplicación introduciendo directamente la URL si no tienen permiso para ello. WEB-INF/properties/prop_Adquisicion.properties Este fichero contiene las propiedades de configuración del módulo de Adquisición. Se divide en dos partes: Configuración del servidor de documentos: En la primera línea se indica el número de servidores de documentos (caja AXIS) con los que trabajará la aplicación NUMERO_SERV_DOC = 2 Para cada servidor de documentos tendremos un bloque de configuración en el que se especificarán los siguientes parámetros: o o o o o o SERV_DOCx.class : Clase java que encapsula el acceso al dispositivo hardware. Se debe dejar el valor por defecto. SERV_DOCx.id : identificador del servidor de documentos. Deberá ser un número correlativo empezando desde cero. Así este número será 0 para el primer dispositivo, 1 para el segundo y así sucesivamente. Este número será el valor de x resaltada en negrita para cada nombre de parámetro. De esta forma no se duplican nombres de parámetros para distintos servidores de documentos. SERV_DOCx.ip : dirección IP del servidor de documentos. SERV_DOCx.nombre : nombre que se le da al servidor de documentos. Este será el nombre que aparecerá en los desplegables de la aplicación cuando se tenga que elegir desde que dispositivo adquirir documentos. SERV_DOCx.usuAdmin : nombre de usuario para acceder a las funcionalidades del servidor de documentos. El valor por defecto para los servidores AXIS es root, que es también lo que aparece en el fichero por defecto. SERV_DOCx.passAdmin : contraseña que junto al nombre de usuario anterior conforma la identificación de acceso al servidor de documentos. El valor por defecto para este parámetro es pass. Parámetros para la adquisición AXIS y File System: Página 13 de 26
o o o o DIR_IMG_TEMPORAL= ruta a partir del raíz de la aplicación donde se guardan temporalmente las imágenes escaneadas, antes de que la aplicación las incorpore al documento. IMPORTANTE: Su valor debe coincidir con el de la propiedad DIR_IMG_TEMPORAL de cit.conf. DIR_CONF_AXIS_TMP = directorio donde la aplicación almacena temporalmente el fichero de configuración de los servidores AXIS. Es necesario para el correcto funcionamiento de la adquisición mediante AXIS. EXTENSIONES_PERMITIDAS = extensiones permitidas para ficheros que sean adquiridos mediante File System y Lotes. PREFIJO_FICHERO_TEMPORAL = parámetro utilizado para la adquisición de páginas por lotes. Se recomienda dejar el valor por defecto. WEB-INF/properties/cwhtm.conf Fichero de configuración utilizado por la librería de componentes. Hay que editar este fichero y sustituir nom_apli por el nombre elegido para la aplicación web. Nota: Después de hacer cambios en los ficheros cit.conf y / o cwhtm.conf es imprescindible reiniciar la aplicación WEB. Las propiedades incluidas en este fichero indican las rutas donde se ubican: Los ficheros css (estilos) utilizados por los componentes. Los ficheros js (javascript) utilizados por los componentes. Los directorios donde se ubican los recursos (imágenes, ventanas auxiliares) usados en los componentes. CWHTM.RUTA_ESTILO=/nom_apli/css/cwhtm.css CWHTM.RUTA_JS=/nom_apli/js/cwhtm.js CWHTM.RUTA_JS_MASCARA=/nom_apli/js/mascara.js CWHTM.RUTA_JS_MENU=/nom_apli/js/menu.js CWHTM.RUTA_DIALOGOS= /nom_apli/dialogos/ CWHTM.IMAGEN_ESTANDAR=/nom_apli/images/details.gif Página 14 de 26
... Las propiedades CWHTM.USAR_STRUTS y CWHTM.COMPROBAR_ OBLIGATORIO_ONBLUR deben mantener sus valores por defecto. WEB-INF/classes/repository_database.xml Este fichero permite configurar la conexión a la base de datos. jcd-alias: alias para identificar la conexión a la base de datos. Debe coincidir con el parámetro esquema del fichero WEB-INF/properties/cit.conf. default-connection: su valor debe ser true (es la conexión por defecto). platform: Plataforma RDBMS tipo de la base de datos. En nuestro caso es Postgresql. jdbc-level: Versión de JDBC soportada por el driver. Mantener el valor por defecto. driver protocol: Protocolo de acceso a la BD. Mantener el valor por defecto (jdbc). subprotocol: Subprotocolo de acceso a la BD. Mantener el valor por defecto (postgresql). dbalias = url de conexión a la BD. La estructura es la siguiente: dbalias="//direccion_ip:puerto/nombre_bd" Las propiedades protocol, subprotocol y bdalias configuran la conexión JDBC (jdbc:postgresql://direccionip:puerto/nombrebd). username = nombre de usuario para usar en la conexión. Debe coincidir con el nombre de esquema de base de datos. password = contraseña para la conexión a la Base de Datos. WEB-INF\lib\Flogger.jar La aplicación crea ficheros de log durante su ejecución. La ubicación por defecto de estos ficheros es el directorio de trabajo del proceso, el cuál puede ser diferente en Página 15 de 26
cada momento, lo que significa tener ficheros de log en distintos directorios del sistema. Esto puede ser no deseable, por lo que es posible fijar el directorio de creación de estos ficheros temporales. Para hacerlo se han de seguir los siguientes pasos: Descomprimir el fichero Flogger.jar, ubicado en el directorio WEB-INF/lib de la aplicación web. Esto creará dos directorios, META-INF y flogger. Editar el fichero log4j.properties, ubicado en el directorio flogger generado, modificando en la segunda línea la ubicación del fichero defecto.log, estableciendo un ruta absoluta. log4j.appender.defaultappender.file = /ruta/defecto.log Generar de nuevo el fichero Flogger.jar mediante la compresión de los directorios META-INF y flogger, de manera que se obtenga un fichero como el Flogger.jar original (misma estructura y contenido) pero con el fichero log4j.properties modificado. No es imprescindible realizar este paso de configuración, será decisión del administrador del sistema en que se ejecutará la aplicación. WEB-INF\cit.conf Es el principal fichero de configuración de la aplicación. Cada parámetro está brevemente comentado en el propio fichero, por lo que resulta relativamente fácil de configurar. Las principales propiedades son: NOMBRE_APLICACIÓN: nombre de la aplicación web. MULTIENTIDAD: para indicar si la aplicación permite gestionar el archivo documental de diferentes entidades. esquema: identificador de la conexión a la base de datos. Debe coincidir con la propiedad jcd-alias de repository_database.xml. CLAVE: una de las claves utilizadas para desencriptar las contraseñas de los usuarios. Página 16 de 26
ORD_NUMERICA: true si las entidades se identifican por caracteres numéricos, para que en los listados se muestren ordenadas numéricamente. PERMISO_ENTIDAD: true para que dado un perfil se le puedan asignar permisos diferentes a cada entidad. A continuación se adjunta un ejemplo de fichero configurado: ########################################################### # FICHERO DE CONFIGURACION DE LA APLICACION # ########################################################### # El nombre de la aplicación en el contenedor de servlets NOMBRE_APLICACION=/nom_apli # fichero con el listado de páginas y permisos necesarios para accederlas ACCESS_PROPS=cit_access.properties # carpeta donde se encuentran los propiedades, debe terminar con / PROPS_RUTA=properties/ #Indica si la aplicación trabaja en el modo multientidad MULTIENTIDAD=true # codigo del idioma por defecto IDIOMA=es #nombre del esquema de BD esquema=coput CLAVE=5TI3sSKZaon0EV0GK4jlOA== # número de las filas por página en los listados FILAS=20 # número de las filas por página en los listados de páginas de objeto documental FILAS_PAGINASOBJDOC=9 Página 17 de 26
# true si las entidades deben tener una ordenación numérica ORD_NUMERICA=true # altura de los paneles PANEL_ALT=550 # nombre del paquete donde se encuentran las clases de macros PAQUETE_MACROS=macros # carpeta donde se guardan las imagenes escaneadas (debe coincidir con el valor que hay en prop_adquisicion.properties) DIR_IMG_TEMPORAL=adquisicion/imagenesEscaneadas # Fichero XSL utilizado para publicar documentos. Ruta a partir del contexto de aplicación FICHERO_XSL_PUB=WEB-INF/xsl/CIT_publicacion.xsl # Fichero XSL utilizado para publicar documentos. Ruta a partir del contexto de aplicacion FICHERO_XSL_IMP=WEB-INF/xsl/CIT_impresion.xsl # Directorio donde se guardan los PDFs generados en la publicación. Accesible vía Web. Ruta a partir del contexto de aplicacion. Su contenido no es eliminado automáticamente, por lo que debe ser revisado de forma periódica por el administrador y manualmente eliminar aquellos ficheros que se considere. DIR_PDF_GENERADOS=pdfs/ # Nombre del servidor de correo empleado para la utilidad del envío de páginas MAIL_SERVER=10.142.74.140 # Directorio adonde se descargan las imágenes para construir el PDF. El directorio debe tener permisos para control total, puesto que se va a guardar y borrar carpetas allí. DIR_TEMPORAL=WEB-INF/temp/ # Directorio adonde se descargan las imágenes para construir el HTML de impresión. El directorio debe tener permisos para control total, puesto que se va Página 18 de 26
a guardar y borrar carpetas allí. Esta carpeta se revisa a menudo para borrar las carpetas caducadas (vease el siguiente parametro (CADUCA_CARIMPR). La carpeta es visible vía Web. DIR_TEMP_IMPRIMIR=impresion/ # Directorio donde se descargan los ficheros para poder enviar el correo con las paginas del objdoc DIR_TEMP_ENVIARCORREO=email/ # Tiempo (en minutos) que debe transcurrir para que las carpetas temporales creadas durante las operaciones de usuario, caduquen y sean eliminadas automáticamente CADUCA_CARIMPR=120 # Altura para la ventana del visor de paginas en la integración con aplicaciones externas VISORPAGS_EXT_ALT=668 # Anchura para la ventana del visor de paginas en la integración con aplicaciones externas VISORPAGS_EXT_ANCH=999 #Ancho mínimo para las columnas del listado para la búsqueda experta ANCHOMINIMO_BUSQEXP=50 # Indica si se añaden los permisos específicos a entidades # en la gestión de perfiles PERMISO_ENTIDAD=true # Al catalogar un nuevo objeto documental copia los valores, de un documento base. Mediante este atributo se puede activar el atributo en el diseñador mediante el cual,#podemos decidir si el valor del documento base se mantiene o no. ACTIVAR_COPIAR_VALOR=true # Directorio donde se almacenan los ficheros de log detallados, enlazados desde el # enlace 'Más información' de las ventanas de alerta y error. Es Página 19 de 26
relativo a WEB-INF CATALOGO_LOG=log/ ########################################################### # PARAMETROS PARA LA GENERACION DE FORMULARIOS # ########################################################### # directorio donde se almacenaran los ficheros XML de los nodos generados, esto debe ser una ruta relativa y debe terminar con / Preferiblemente esta carpeta estará en un directorio NO accesible vía WEB ej. WEB-INF/ PATH_XML_FORMS=WEB-INF/xml_forms/ # directorio donde se almacenaran los ficheros.jsp de los xml transformados, esto debe ser una ruta relativa y debe terminar con / Preferiblemente esta carpeta estara en un directorio accesible vía WEB ej. mis_forms_generados/ PATH_JSP_FORMS_GEN=formulariosNodos/ # Ruta relativa al fichero XSL para transformar los XML de los formularios generados. este se debe encontrar en el Preferiblemente este fichero estará en un directorio NO accesible vía WEB ej. WEB-INF/xsl/miFichero.xsl PATH_FICH_FORMS_XSL=WEB-INF/xsl/CIT_FormConvert.xsl Nota: Más información en el apartado configuración del manual de Administrador. 3.2.4 Ficheros de etiquetas de idioma Se permite configurar el idioma en el que se muestra la aplicación, que será el mismo para todos los usuarios. Para ello, existe el parámetro IDIOMA en el fichero de configuración cit.conf, en el que se define el idioma en el que se mostrará la aplicación. El idioma se indica mediante su código ISO (p.e. es para el castellano), y la aplicación tomará las cadenas de texto a mostrar de los ficheros de propiedades adecuados, denominados de la forma nombrefichero_codigoidioma.properties. Estos ficheros de idiomas se encuentran en la carpeta WEB-INF\properties, y son los siguientes: cit_general_codigoidioma.properties Contiene las cadenas de uso general en la aplicación. cit_login_codigoidioma.properties Contiene los mensajes usados en la autenticación de usuarios. Página 20 de 26
CALENDARIO_codigoidioma.properties Contiene las cadenas de texto para los días de la semana y los meses. cit_catalogo_codigoidioma.properties Contiene las etiquetas para la gestión del catálogo. cit_adquisicion_codigoidioma.properties Contiene las etiquetas para la adquisición de páginas, y la gestión de lotes. cit_visualizacion_codigoidioma.properties Contiene las etiquetas usadas en la utilidad del visor TIFF. cit_estructura_codigoidioma.properties Contiene las etiquetas para la gestión de estructuras. cit_disenyador_codigoidioma.properties Contiene las cadenas empleadas en el diseñador. cit_usuarios_codigoidioma.properties Contiene las etiquetas para la gestión de usuarios. cit_volumenes_codigoidioma.properties Contiene las etiquetas para la gestión de volúmenes. cit_sino_codigoidioma.properties Contiene las etiquetas para los mensajes en los que se proporciona al usuario la posibilidad de continuar o cancelar una operación. cit_alertas_codigoidioma.properties Contiene las etiquetas para los mensajes de alerta. cit_avisos_codigoidioma.properties Contiene las etiquetas para los mensajes de aviso. cit_errores_codigoidioma.properties Contiene las etiquetas para los mensajes de error. cit_sugerencias_codigoidioma.properties Contiene las etiquetas para los mensajes de sugerencia. cit_tipos_codigoidioma.properties Contiene las etiquetas de la página de gestión de formatos. Página 21 de 26
cit_pconf_codigoidioma.properties Contiene las etiquetas de la página de configuración. Todos los ficheros anteriores contienen líneas de la forma siguiente: CodigoEtiqueta=Cadena literal a mostrar en la aplicación Con la aplicación, se proporcionan los ficheros con los mensajes correspondientes al castellano. Si se desea cambiar a otro idioma, será necesario crear los ficheros para el nuevo idioma, y escribir la traducción correspondiente al idioma para todos los códigos de etiquetas. En el caso de alertas, avisos, errores y sugerencias, cada mensaje se describe mediante cinco códigos de etiqueta: código del mensaje descripción breve de la alerta/aviso/error/sugerencia descripción larga de la alerta/aviso/error/sugerencia causa de la alerta/aviso/error/sugerencia posible solución Si se desea modificar el texto para alguno de los mensajes será necesario editar el fichero correspondiente al tipo de mensaje, y buscar el código que aparece como título en la ventana del mensaje en la aplicación. Junto a los ficheros listados anteriormente, en la misma carpeta se encuentran además dos ficheros de idiomas cuyo contenido no debe ser editado directamente, sino que es la propia aplicación la encargada de acceder a ellos: cit_etiquetaslistados_codigoidioma.properties Contiene las etiquetas introducidas por el usuario en la definición de listados, que aparecerán en el encabezado de las columnas en los listados del catálogo cit_etiquetas_codigoidioma.properties Contiene las cadenas introducidas por el usuario en la definición de búsquedas expertas Página 22 de 26
3.3 Comprobación básica. Acceso a la aplicación Llegados a este punto la aplicación deberá estar instalada y lista para ser accedida. La comprobación se realiza accediendo a la página de entrada desde un navegador web. La URL es de la forma: http://máquina:puerto/nom_apli Lo que deberá redirigir al usuario la página de identificación, en la que se autenticará con las credenciales del usuario administrador precargado (Usuario= Administrador,Contraseña = admini). Se deberán cambiar estas credenciales (al menos el password) por razones de seguridad. Cualquier persona con acceso a este manual podría acceder también como Administrador a la aplicación. Esto deberá llevarnos a la página de menú, desde donde iniciar el uso de la aplicación. Página 23 de 26
Página 24 de 26
4. ANEXO: CONFIGURACIÓN AXIS 7000 ADoc realiza la digitalización de documentos a través del servidor de documentos en red AXIS 7000. La caja AXIS se conecta al escáner a través del conector SCSI-2, y a la red. La caja AXIS toma una dirección IP válida por DHCP, RARP o BOOTP. Para configurarla con una IP fija es necesario acceder a las herramientas de administración desde el navegador. Introducir la dirección IP del servidor AXIS. Por ejemplo: http://172.16.253.80 La IP asignada se puede consultar directamente en el panel de la caja, pulsado simultáneamente los botones Menu y Select. Aparece el Menú Avanzado. Seleccionar Parámetros de red donde se muestra la IP. Seleccionar admin e introducir User name (root) y password (pass). Entrar en el menú Network Settings y seleccionar Detailed View: Página 25 de 26
Configurar IP, router y máscara manualmente y desmarcar los check de Automatically (DCHP, BOOTP y RARP). Página 26 de 26