Gestion des traces (Administration)

Principe

La gestion des traces permet de définir des traces exécutées par le service.

Les traces peuvent être définis :

• Par l'interface utilisateur disponible dans le menu d'administration Web.
• Par la modification du fichier de définition de trace situé dans le répertoire cache du service.

Le résultat de l'exécution d'une trace peut être :

• Retrouvé dans le répertoire log du service
• Envoyé par email si celui-ci est défini dans la définition de la trace

Tip : A un instant donnée une seule exécution de trace par contexte est possible, les déclenchements à l'intérieur d'une exécution de trace sont ignorés.

Tip : Il n'est pas nécessaire de relancer le service pour prendre en compte les modifications du fichier de définition de trace

Interface de configuration

Identification

• Actif

Indique si cette définition de trace est active

• Type de trace

Mode de déclenchement de la trace (voir ci-dessous)

• Identifiant

Identifiant de la trace, utilisé pour définir le nom du fichier qui sera généré.

• Condition

Condition de déclenchement de la trace, dépend du type de trace (voir ci-dessous)

Type	Condition	Déclenchement
Session		Connexion de l'utilisateur
Ecran	Nom d'écran	Ouverture de l'écran
Méthode	Référence de méthode (className.methodName)	Exécution de la méthode

Critère de déclenchement

• Condition

Dépend du type de trace

• Utilisateur

Utilisateur pour lequel la trace est déclenchée.

• Base de données

Base de données pour laquelle la trace est déclenchée.

• Société

Société pour laquelle la trace est déclenchée.

Tip : Ces paramètres peuvent inclure des caractères jokers * et ?

Options

• Stocker en base de données

Les statistiques collectées par l'exécution seront stockées dans la table sysCodeStats de la base de données

• Nombre d'exécution

Nombre de déclenchement maximum de la trace, par défaut 1 seul déclenchement (-1:illimité). Lorsque le nombre de déclenchement est atteint la trace est désactivée et le fichier de définition de trace est mis à jour.

Envoyer à

• Adresse Email

Adresse du destinataire à qui envoyé le résultat de la trace

• Sujet EMail

Sujet du mail envoyé.

• Corps de mail

Corps du mail envoyé.

Fichier de définition de trace

Ce fichier appelé "tracedefs.json" se situe dans le répertoire parent du répertoire de log.

{   "defs":[
      {
         "id":"idDecTVA",
         "enable":false,
         "type":"method",
         "clearBeforeRun":true,
         "storeInDatabase":true,
         "memSnapShot":true,
         "maxRun":1,
         "user":"sage",
         "shareSociety":"",
         "databaseName":"",
         "reference":"TProcessusDeclarerTVA.executer",
         "email":"",
         "emailSubject":"id1-subject",
         "emailBody":"id1-boby",
      },
      {
         "id":"idSEcriture",
         "enable":true,
         "type":"form",
         "clearBeforeRun":true,
         "storeInDatabase":false,
         "memSnapShot":true,
         "maxRun":0,
         "user":"sage",
         "shareSociety":"",
         "databaseName":"",
         "reference":"fsaisieanalytique.dfm",
         "email":"",
         "emailSubject":"id1-subject",
         "emailBody":"id1-boby",
      }
      {
         "id":"idSage",
         "enable":false,
         "type":"session",
         "maxRun":0
      }
   ]
}

Tip : L'interface de configuration modifie le fichier de définition de trace