Lectura de trazas
Las funciones de la aplicación susceptibles de durar un cierto tiempo y, en particular, todas aquellas que son susceptibles de funcionar en batch, generan un fichero de traza con un informe detallado que incluye los errores en caso de haberlos.
Estos ficheros de traza se crean en el subdirectorio TRA del directorio del dossier en el servidor. Estos ficheros tienen un nombre compuesto bajo la forma F#.tra, donde # es un número secuencial atribuido con la ayuda del contador [C]NUMIMP.
La primera línea de un fichero de traza se estructura del modo siguiente:
|
|
#<AdxVJ>@(#)%I% DD-MM-AA hh:mm:ss (código de usuario) Comentario explicativo |
La primera parte de la traza (presentada en negrita) es una cabecera estándar y, a continuación, aparecen la fecha y la hora, el código del usuario que ha ejecutado la función y, por último, un comentario explicativo.
A continuación, en la traza aparecen líneas creadas por la función ejecutada; estas líneas van precedidas de los caracteres > o <, seguidos de un número de error si la línea hace referencia a un error constatado en la función.
Requisitos previos
Consulta la documentación de Puesta en marcha
Gestión de pantalla
Cuando se entra en la función, se introduce el nombre del fichero de traza; se puede acceder a una ventana de selección para seleccionar los ficheros existentes.
Una vez hecha esta selección, se abre la pantalla de lectura de trazas.
Pestaña Pantalla de introducción de datos
Esta pantalla permite visualizar hasta 999 líneas de traza. Si en el fichero hay más líneas, los botones de radio se habilitan y el fichero se divide en «páginas» lógicas de 999 líneas. A continuación, es posible utilizar los botones de radio para ir a la página siguiente o anterior, o para desplazarse a la primera o la última página. El número de la página actual y el número total de páginas del fichero se muestran en el título de la tabla de líneas.
Tabla
| campo LIGNE |
|
Cada línea de la tabla corresponde a una línea de la traza. |
Botones específicos
|
Siguiente error |
Este botón permite navegar por la traza desplazándose sucesivamente a todas las líneas donde hay un error. |
|
Warning siguiente |
Barra de menú
|
Permite ir directamente a una página determinada. El número de página se introduce en una ventana que se abre. |
|
Permite buscar un texto en el fichero de traza. El texto se introduce en un cuadro de diálogo que se abre y, si el texto existe en la traza, un cuadro muestra el número de ocurrencias encontradas. Entonces, en la pantalla únicamente vuelven a mostrarse las líneas afectadas. |
|
Permite visualizar en la pantalla de traza únicamente las líneas de error. Esta visualización va precedida de la visualización, en un cuadro de información, del número total de errores que contiene el fichero de traza. |
|
Una vez que se ha pasado a la visualización parcial de la traza (mediante la función de búsqueda o al visualizar únicamente los errores), permite volver a la visualización completa del fichero de traza. |
|
Permite copiar el fichero de traza en otro fichero cuya ruta se indica de manera absoluta. Esta ruta se ubica por defecto en el servidor de aplicación. Sin embargo, mediante la expresión servidor@ruta, es posible indicar otro servidor. La expresión #@ruta permite indicar principalmente como destino el puesto cliente, siempre y cuando el puesto cliente sea de tipo Windows (en modo Web, las restricciones de seguridad asociadas al navegador Web impiden que esta operación funcione). |
|
Permite enviar el fichero de traza por correo electrónico a un conjunto cualquiera de usuarios. Se introduce la lista de usuarios a los que hay que realizar el envío así como un texto de acompañamiento (se propone un texto por defecto). La dirección de correo electrónico asociada al usuario se propone por defecto. |
Puesta en marcha técnica de las trazas
El desarrollador gestiona un fichero de traza mediante las siguientes funciones:
|
|
Call OUVRE_TRACE("COMMENTAIRE") From LECFIC |
: # Apertura de un fichero de traza |
|
|
Call ECR_TRACE("TEXTE",ERREUR) From LECFIC |
: # Escritura de un texto en la traza |
|
|
Call FERME_TRACE From LECFIC |
: # Cierre de la traza |
|
|
Call LEC_TRACE From LECFIC |
: # Lectura de la traza |