LOG EVENT

4D v19

LOG EVENT


LOG EVENT ( {tipoSaida ;} mensagem {; importancia} )

Parâmetro	Tipo	Descrição
tipoSaida	Inteiro longo	Message output type
mensagem	String	Contents of the message
importancia	Inteiro longo	Message’s importance level

Descrição

O comando LOG EVENT permite configurar um sistema personalizado de registro de eventos internos que ocorrem durante o uso de sua aplicação.

Passe no parâmetro mensagem a informação personalizada a notar em função do evento.

O parâmetro opcional tipoSaida permite precisar o canal de saida tomado pela mensagem. Pode passar neste parâmetro uma das constantes abaixo ubicadas no tema Historial de eventos:

Constante	Tipo	Valor	Comentário
Into 4D commands log	Inteiro longo	3	Indica a 4D gravar a mensagem no arquivo de histórico dos comandos de 4D, se este arquivo foi ativado. O arquivo de histórico de comandos de 4D pode ser ativado utilizando o comando SET DATABASE PARAMETER (seletor 34). Nota: os arquivos de histórico de 4D se juntam na pasta Logs, criada junto ao arquivo de estrutura da base (ver o comando).
Into 4D debug message	Inteiro longo	1	Indica a 4D enviar a mensagem ao entorno de depuração do sistema. O resultado depende da plataforma: Baixo Mac OS: o comando envia a mensagem à Consola Baixo Windows: o comando envia a mensagem como uma mensagem de depuração. Para poder ler este mensagem, deve ter Microsoft Visual Studio ou DebugView para Windows (http://technet.microsoft.com/en-us/sysinternals/bb896647.aspx)
Into 4D diagnostic log	Inteiro longo	5	Lhe indica a 4D colocar a mensagem no arquivo de diagnóstico de 4D, se este arquivo está ativo. O arquivo de diagnóstico pode ser ativado com ajuda do comando SET DATABASE PARAMETER (seletor 79).
Into 4D request log	Inteiro longo	2	Indica a 4D gravar a mensagem no arquivo de histórico de petições de 4D, se este arquivo foi ativado
Into system standard outputs	Inteiro longo	6	Indica a 4D que deve enviar a mensagem a um fluxo de saída padrão. A mensagem é enviada a: stdout se importance = Information message ou Warning message stderr se importance = Error message
Into Windows log events	Inteiro longo	0	Indica a 4D enviar o mensagem “Log events” de Windows. Este histórico recebe e armazena as mensagens que vem das aplicações em execução. Neste caso, pode definir o nível de importância da mensagem via o parâmetro opcional importância (ver a continuação). Notas: Para que esta funcionalidade esteja disponível, o serviço Log Events de Windows deve estar em execução. Baixo Mac OS, o comando não faz nada com este tipo de saída

Se omitir o parâmetro tipoSaida, o valor 0 se utiliza como padrão (Into Windows Log Events).

Se tiver definido tipoSaida de tipo Into Windows Log Events, pode atribuir à mensagem um nível de importância vía o parâmetro opcional importancia com o fim de facilitar a leitura de histórico de eventos. Há três níveis de importância: Informação, Advertência e Erro. 4D oferece as constantes abaixo predefinidas, localizadas no tema Historial de eventos:

Constante	Tipo	Valor
Error message	Inteiro longo	2
Information message	Inteiro longo	0
Warning message	Inteiro longo	1

Se não passar nada no parâmetro importancia ou se passar um valor inválido, se utiliza o valor como padrão (0).

Exemplo

Caso queiras realizar um seguimento das aberturas de sua base baixo Windows, pode escrever a seguinte linha de código no Método banco de dados On Startup:

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

Cada vez que se abre o banco de dados, esta informação será escrita no visor de eventos de Windows e seu nível de importância será 0.

Ver também

SET DATABASE PARAMETER