Personnalisation des fichiers journaux de base

Les problèmes que vous rencontrez lors de la génération de documents à partir de canevas et de spécifications de document sont répertoriés dans les fichiers journaux de base. Vous pouvez personnaliser l'emplacement du fichier rpe.log, par exemple.

Avant de commencer

Vous pouvez activer le mode débogage afin d'inclure des messages dans les fichiers journaux de base décrivant le traitement de chaque élément pendant la génération de documents. Par défaut, le mode débogage n'est pas activé. Pour plus d'informations sur l'activation du mode débogage, voir Définition des préférences du moteur.

Pourquoi et quand exécuter cette tâche

L'emplacement du fichier contenant les personnalisations de journalisation est le suivant :%RPE_HOME%\config\log4j.properties. Les propriétés qui contiennent le texte txtOutput s'appliquent aux fichiers journaux de base.
Tableau 1. Propriétés de journal
Propriété de journalisation Valeur par défaut Description
log4j.appender.txtOutput.File ${java.io.tmpdir}/RPE/rpe.log L'emplacement par défaut du fichier rpe.log correspond au répertoire principal de l'utilisateur dans les données d'application. Vous pouvez modifier cette valeur et indiquer un autre répertoire. Voir Exemple : modification de l'emplacement de sortie ci-après.
log4j.appender.txtOutput.MaxFileSize 1000 Ko Taille à laquelle un nouveau fichier journal est créé. Lorsque la taille du fichier rpe.log est égal ou supérieur à 1 Mo, le fichier est renommé rpe.log.1, rpe.log.2, etc et le rpe.log est généré. rpe.log représente systématiquement le fichier journal le plus récent.
log4j.appender.txtOutput.Threshold DEBUG Niveau minimal de gravité des messages, consigné dans le fichier journal. Vous pouvez entrer l'un des seuils suivants, répertoriés du niveau de gravité le plus faible au plus élevé :
  1. DEBUG
  2. INFO
  3. WARNING
  4. ERROR
Vous pouvez également affecter la valeur de seuil OFF pour désactiver la consignation.
log4j.appender.txtOutput.layout.ConversionPattern %d{dd-MM-yyyy}T%d{HH:mm:ss:SS} %m %n
  • %d{dd-MM-yyyy}T%d{HH:mm:ss:SS} : date et heure de survenue de l'événement du journal.
  • %m: message de journal
  • %n : entre un retour chariot

Exemple : modification de l'emplacement de sortie

Pourquoi et quand exécuter cette tâche

L'emplacement par défaut du fichier rpe.log correspond au répertoire principal de l'utilisateur :
Tableau 2. Chemins d'accès à rpe.log par système d'exploitation
Système d'exploitation Chemin d'accès à rpe.log
Windows XP C:\Documents and Settings\utilisateur\temp\RPE\rpe.log
Windows 7 C:\Users\utilisateur\AppData\Local\Temp\RPE\rpe.log

Procédure

  1. Ouvrez le fichier %RPE_HOME%\config\log4j.properties à l'aide d'un éditeur de texte.
  2. Recherchez la ligne :

    log4j.appender.txtOutput.File=${java.io.tmpdir}/RPE/rpe.log

    ${java.io.tmpdir} indique l'emplacement par défaut du dossier personnel de l'utilisateur.
  3. Modifiez le chemin après le signe égal en spécifiant un nouvel emplacement pour votre fichier journal. Exemple :

    log4j.appender.txtOutput.File=C:\rpe.log

  4. Sauvegardez vos modifications.

Retour d'informations