4D Doc Center : LOG EVENT

4D v12.4

LOG EVENT


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

Parâmetro	Tipo	Descrição
tipoSaida	Inteiro longo	Tipo de saída da mensagem
mensagem	cadeia	Conteúdo da mensagem
importancia	Inteiro longo	Nivel de importância da mensagem (só para Windows)

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 saída tomado pela mensagem. Pode passar neste parâmetro uma das seguintes constantes, localizadas no tema Historial de eventos :

Constante	Tipo	Valor	Comentário
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
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 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 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).

Se omitido o parâmetro tipoSaida, o valor 0 se utiliza por defeito (Into Windows Log Events).

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

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

Se não passa o parâmetro importancia ou se passa um valor invalido, se utiliza o valor por defeito (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 de base On Startup:

LOG EVENT(Into Windows Log Events;"Abertura da base Fatoração.")

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.