Impressions > Lecture traces 

Les fonctions du progiciel susceptibles de durer un certain temps, et en particulier toutes celles qui sont susceptibles de fonctionner en batch, créent un fichier trace avec un compte-rendu détaillé incluant les erreurs s'il y en a.

Ces fichiers de trace sont créés dans le sous-répertoire TRA du répertoire du dossier, sur le serveur. Ils ont un nom composé sous la forme F#.tra, où # est un numéro séquentiel attribué à l'aide du compteur [C]NUMIMP.

La première ligne d'un fichier trace est structurée comme suit :

 

#<AdxVJ>@(#)%I% JJ-MM-AA hh:mm:ss (code utilisateur) Commentaire explicatif

La première partie de la trace (présentée en gras) est un en-tête standard ; suivent ensuite la date et l'heure, le code de l'utilisateur ayant lancé la, fonction, et enfin un commentaire explicatif.

On trouve ensuite dans la trace des lignes créées par la fonction exécutée ; ces lignes sont préfixées par les caractères > ou <, suivies d'un numéro d'erreur, si la ligne fait référence à une erreur constatée dans la fonction.

    Pré-requis

    SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

    Gestion de l'écran

    Lorsqu'on entre dans la fonction, on saisit le nom du fichier de trace ; une fenêtre de sélection est accessible pour sélectionner les fichiers existants.
    Ce choix fait, l'écran de lecture de trace s'ouvre.

    Ecran de saisie

    Présentation

    Cet écran permet d'afficher jusqu'à 1000 lignes de trace. S'il y en a davantage dans le fichier, les boutons magnétophone sont dégrisés, le fichier étant découpé en « pages » logiques de 1000 lignes. Il est alors possible d'utiliser les boutons magnétophone pour aller à la page suivante, ou précédente, ou d'aller en première ou en dernière page. Le numéro de page courante et le nombre total de pages du fichier sont affichés dans le titre du tableau des lignes.

    Fermer

     

    Champs

    Les champs suivants sont présents dans cet onglet :

    Tableau

    • champ LIGNE

    Chaque ligne du tableau correspond à une ligne dans le fichier de trace.

    Fermer

     

    Boutons spécifiques

    Ce bouton permet de naviguer dans la trace, en se déplaçant successivement sur toutes les lignes où se trouve une erreur. Si l'erreur ne se trouve pas dans la page de 1000 lignes courante, ce bouton provoque l'affichage de la première page de 1000 lignes suivante où une erreur existe.

    Il est à noter qu'une série de lignes d'erreur consécutives est considérée comme une seule ligne d'erreur (on saute effectivment à la première erreur non consécutive suivante).

    Ce bouton permet de naviguer dans la trace, en se déplaçant successivement sur toutes les lignes où se trouve un avertissement. Si l'avertissement ne se trouve pas dans la page de 1000 lignes courante, ce bouton provoque l'affichage de la première page de 1000 lignes suivante où un avertissement existe.

    Il est à noter qu'une série de lignes d'avertissement consécutives est considérée comme une seule ligne d'avertissement (on saute effectivment à la première d'avertissement non consécutive suivante).

    Barre de menu

    Options / Page

    Permet directement à une page donnée. On saisit ce numéro dans une fenêtre qui s'ouvre.

    Options / Recherche

    Permet de rechercher un texte dans le fichier de trace. Le texte est saisi dans une boîte de dialogue qui s'ouvre, et si le texte existe dans la trace, une boîte affiche le nombre d'occurrences trouvées. L'écran ne réaffiche alors que les lignes concernées.

    Options / Erreurs

    Permet de n'afficher, dans l'écran de trace, que les lignes d'erreur et d'avertissement. Cet affichage est précédé de l'affichage, dans une boîte d'information, du nombre total d'erreurs et d'avertissement contenu dans le fichier de trace.

    La ligne d'erreur est suivie d'un numéro de lignes entre parenthèses : par exemple, (5304). Ceci signifie qu'en se positionnant sur la page 5, on trouvera l'erreur en ligne 304.

    Options / Détail

    Permet, lorsqu'on est passé en affichage partiel de la trace (par la fonction de recherche ou en n'affichant que les erreurs), de revenir à l'affichage complet du fichier de trace.

    Options / Copie

    Permet de copier le fichier de trace dans un autre fichier, dont le chemin est indiqué de façon absolue. Ce chemin est situé par défaut sur le serveur d'application. Mais, par la syntaxe serveur@chemin, il est possible de le déclarer sur un autre serveur. La syntaxe #@chemin permet notamment de le déclarer sur le poste client, à condition que le poste client soit de type Windows (en Web, les contraintes de sécurité liées au navigateur Web empêchent cette fonction d'opérer).

    Options / Envoi

    Permet d'envoyer le fichier trace par mail à un ensemble d'utilisateurs quelconques. On saisit la liste des utilisateurs à qui l'envoi doit être fait, ainsi que le texte d'accompagnement (un texte par défaut est proposé). L'adresse mail associée à l'utilisateur connecté est proposée par défaut.

    Messages d'erreur

    Il n'y a pas de message d'erreur autre que les messages d'erreur génériques.

    Tables mises en oeuvre

    SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

    Mise en oeuvre technique des traces

    Le développeur gère un fichier de trace par les fonctions suivantes :

     

    Call OUVRE_TRACE("COMMENTAIRE") From LECFIC

    : # Ouverture d'un fichier trace

     

    Call ECR_TRACE("TEXTE",ERREUR) From GESECRAN

    : # Ecriture d'un texte dans la trace
    : # si ERREUR=0 : Information
    : # si ERREUR>0 : Erreur affichée en rouge
     :# si ERREUR<0 : Information dans une couleur particulière

     

    Call FERME_TRACE From LECFIC

    : # Fermeture de la trace

     

    Call LEC_TRACE From LECFIC

    : # Lecture de la trace