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 ConsolaBajo 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.