Personalización de archivos de registro

Los problemas que se detenten durante la generación de documentos a partir de plantillas y de especificaciones de documentos se listarán en los archivos de registro principales. Puede personalizar la ubicación del archivo rpe.log, por ejemplo.

Antes de empezar

Puede habilitar la modalidad de depuración para incluir mensajes en los archivos de registro principales que describan cómo se procesa cada elementos durante la generación de documentos. De forma predeterminada, la modalidad de depuración no está habilitada. Consulte Establecimiento de las preferencias del motor para obtener información sobre la habilitación de la modalidad de depuración.

Acerca de esta tarea

La ubicación del archivo que contiene personalizaciones de registro es RPE_HOME\config\log4j.properties. Las propiedades que incluyen el texto txtOutput se aplican a los archivos de registro principales.
Tabla 1. Propiedades del registro
Propiedad del registro Valor predeterminado Descripción
log4j.appender.txtOutput.File ${java.io.tmpdir}/RPE/rpe.log La ubicación predeterminada del archivo rpe.log es el directorio de inicio del usuario a los datos de aplicación. Puede editar este valor en otra ubicación de directorios. Consulte más abajo Ejemplo: Cambio de la ubicación de salida.
log4j.appender.txtOutput.MaxFileSize 1000KB El tamaño con el que se ha creado un archivo de registro nuevo. Cuando el tamaño del archivo rpe.log es igual o superior a 1 MB, se cambia el nombre del archivo por rpe.log.1, rpe.log.2, etc. y el rpe.log se genera de nuevo. rpe.log siempre es el archivo de registro más reciente.

Cuando el tamaño del archivo rpe.log es igual o superior a 10 MB, se cambia el nombre del archivo.

log4j.appender.txtOutput.Threshold DEBUG (depuración) El nivel de severidad de mensajes mínimo en el archivo de registro. Puede especificar cualquiera de los umbrales siguientes, que se enumeran en orden de menor a mayor nivel de gravedad:
  1. DEBUG (depuración)
  2. INFO (información)
  3. WARNING (aviso)
  4. ERROR
También puede establecer el valor de umbral en OFF (desactivado) para inhabilitar el registro.
log4j.appender.txtOutput.layout.ConversionPattern %d{dd-MM-aaaa}T%d{HH:mm:ss:SS} [%t] %m %n

%d{dd-MM-aaaa}T%d{HH:mm:ss:SSS} [%t] %m %n

  • %d{dd-MM-aaaa}T%d{HH:mm:ss:SS}: La fecha y la hora del suceso de registro
  • [%t]: ID de hebra
  • %m: mensaje de registro
  • %n: introduce un retorno de carro

Ejemplo: Cambio de la ubicación de salida

Acerca de esta tarea

La ubicación predeterminada del archivo rpe.log es la carpeta de inicio del usuario:
Tabla 2. Vías de acceso a rpe.log del sistema operativo
Sistema operativo Vía de acceso a rpe.log
Windows 7 C:\Usuarios\usuario\AppData\Local\Temp\RPE\rpe.log

Procedimiento

  1. Abra el archivo RPE_HOME\config\log4j.properties con un editor de texto.
  2. Localice la línea:

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

    ${java.io.tmpdir} indica la ubicación predeterminada de la carpeta de inicio del usuario.
  3. Edite la vía de acceso del archivo después del signo igual en una ubicación nueva para el archivo de registro. Ejemplo:

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

  4. Guarde los cambios.