Cómo reportar Fallos

Durante el uso de cualquier sistema informático puede producirse errores debidos a diversas causas. Los sistemas actuales son cada vez más complejos y en ellos interviene múltiples programas y máquinas.

Como ejemplo, un problema surgido al intentar visualizar un documento puede deberse, entre otros a los motivos siguientes:

• El ordenador utilizado no es capaz de manejar ese formato de imagen
• El navegador utilizado no es capaz de manejar ese formato de imagen
• Un problema de comunicaciones impide al ordenador comunicarse con el servidor
• El servidor tiene exceso de usuarios
• El programa utilizado (OPD en este caso) tiene un error en su construcción
• Un problema de comunicaciones impide al servidor comunicarse con el lugar donde se almacenó el archivo
• .....

Por todo ello, en caso de error debe recogerse toda la información posible y sobre todo intentar analizar e identificar las operaciones que provocan el error (Ej: "una operación concreta sobre un tipo documental dado", "Cualquier operación sobre una carpeta concreta", "La secuencia: añadir un documento e inmediatamente despues borrarlo", etc. )

Aportando la información recogida sobre secuencia de las operaciones y el entorno en que se produce el fallo, este puede diagnosticarse y, o bien mejorar la documentación o corregir el código erroneo.

Para recoger los errores se ha incluido un formulario Web. Este formulario permite informar de un error o fallo en el funcionamiento de OpenProdoc. Por favor incluya tanto detalle como sea posible, para facilitar reproducir el error y corregirlo.

Como se especifica en la licencia, el autor no se responsabiliza en ningun aspecto por el uso de OpenProdoc, pero nosotros intentaremos corregir todos los errores localizados. Se agradece su colaboración.

Cómo identificar Fallos

Cuando se produzcan errores, es necesario recoger información de las operaciones realizadas y los errores encontrados. Esta información puede recogerse automáticamente.

El fichero de configuración de OpenProdoc "Prodoc.properties" contiene dos parámetros relacionados con la traza:

• TRACELEVEL
• TRACECONF

TRACELEVEL hace referencia al nivel de traza deseado:

• LOGLEVELERROR=0: Solo se registrarán los errores.
• LOGLEVELINFO=1: Se registrará información adicional.
• LOGLEVELDEBUG=2: Se registrará información detallada de todas las operaciones.

Por defecto debería tenerse siempre el nivel a 0 (Ej. TRACELEVEL=0), activando temporalmente solo el nivel 2 cuando se desea detectar un error

TRACECONF indica el camino donde se encuentra el fichero de configuración de la traza (Ej.: TRACECONF=/home/OPD/log4j.properties).

Por defecto se suministra un fichero pero puede modificarse a voluntad según el formato de log4j, la herramienta utilizada. Para los conocedores de log4j debe indicarse que el nivel indicado en TRACELEVEL predomina sobre el indicado en el fichero de configuración log4j.properties