LOG EVENT

4D v20 R7

LOG EVENT


LOG EVENT ( {tipoSalida ;} mensaje {; importancia} )

Parámetro	Tipo	Descripción
tipoSalida	Entero largo	Tipo de salida del mensaje
mensaje	Cadena	Contenido del mensaje
importancia	Entero largo	Nivel de importancia del mensaje (sólo para Windows)

Descripción

El comando LOG EVENT permite configurar un sistema personalizado de registro de eventos internos que ocurren durante el uso de su aplicación.

Pase en el parámetro mensaje la información personalizada a notar en función del evento.

El parámetro opcional tipoSalida permite precisar el canal de salida tomado por el mensaje. Puede pasar en este parámetro una de las siguientes constantes, ubicadas en el tema Historial de eventos:

Constante	Tipo	Valor	Comentario
Into 4D commands log	Entero largo	3	Indica a 4D grabar el mensaje en el archivo de historial de los comandos de 4D, si este archivo se ha activado. El archivo de historial de comandos de 4D puede activarse utilizando el comando SET DATABASE PARAMETER (selector 34). Nota: los archivos de historial de 4D se agrupan en la carpeta Logs (ver el comando Get 4D folder).
Into 4D debug message	Entero largo	1	Indica a 4D enviar el mensaje al entorno de depuración del sistema. El resultado depende de la plataforma: Bajo Mac OS: el comando envía el mensaje a la Consola Bajo Windows: el comando envía el mensaje como un mensaje de depuración. Para poder leer este mensaje, debe tener Microsoft Visual Studio o DebugView para Windows (http://technet.microsoft.com/en-us/sysinternals/bb896647.aspx)
Into 4D diagnostic log	Entero largo	5	Le indica a 4D poner el mensaje en el archivo de diagnóstico de 4D, si este archivo está activo. El archivo de diagnóstico puede activarse con ayuda del comando SET DATABASE PARAMETER (selector 79).
Into 4D request log	Entero largo	2	Indica a 4D grabar el mensaje en el archivo de historial de peticiones de 4D, si este archivo ha sido activado
Into system standard outputs	Entero largo	6	Indica a 4D enviar el mensaje a un flujo de salida estándar. El mensaje se envía a: stdout si importance = Information message o Warning message stderr si importance = Error message
Into Windows log events	Entero largo	0	Indica a 4D enviar el mensaje “Log events” de Windows. Este historial recibe y almacena los mensajes que vienen de las aplicaciones en ejecución. En este caso, puede definir el nivel de importancia del mensaje vía el parámetro opcional importancia (ver a continuación). Notas: Para que esta funcionalidad esté disponible, el servicio Log Events de Windows debe estar en ejecución. Bajo Mac OS, el comando no hace nada con este tipo de salida

Si omite el parámetro tipoSalida, el valor 0 se utiliza por defecto (Into Windows Log Events).

Si ha definido un tipoSalida de tipo Into Windows Log Events, puede atribuir al mensaje un nivel de importancia vía el parámetro opcional importancia con el fin de facilitar la lectura del historial de eventos. Hay tres niveles de importancia: Información, Advertencia y Error. 4D ofrece las siguientes constantes predefinidas, ubicadas en el tema Historial de eventos:

Constante	Tipo	Valor
Error message	Entero largo	2
Information message	Entero largo	0
Warning message	Entero largo	1

Si no pasa nada en el el parámetro importancia o si pasa un valor invalido, se utiliza el valor por defecto (0).

Ejemplo

Si quiere realizar un seguimiento de las aperturas de su base bajo Windows, puede escribir la siguiente línea de código en el Método base On Startup:

LOG EVENT(Into Windows log events;"The Invoice database was opened.")

Cada vez que se abre la base, esta información se escribirá en el visor de eventos de Windows y su nivel de importancia será 0.

Ver también

SET DATABASE PARAMETER