4D Doc Center : LOG EVENT

4D v14.3

LOG EVENT


LOG EVENT ( {outputType ;} message {; importance} )

引数	型	説明
outputType	倍長整数	メッセージの出力タイプ
message	文字	メッセージの内容
importance	倍長整数	メッセージの重要度レベル

説明

LOG EVENTコマンドを使用して、アプリケーションの使用中に発生した内部イベントを記録するためのカスタマイズされたシステムを設定します。

イベントに応じて記録されるカスタム情報を messageに渡します。

オプションの引数outputTypeを使用して、messageによって取得された出力チャネルを指定します。Log Eventsテーマにある以下の定数の一つをこの引数に渡します。

定数	型	値	コメント
Into 4D commands log	倍長整数	3	この値は4Dのコマンドログファイルがアクティブである場合、このファイルにmessageの内容を記録するよう4Dに指示します。4DコマンドログファイルはSET DATABASE PARAMETERコマンド (セレクター34) を使用して有効にできます。注: 4Dのログファイルは、Logsフォルダに配置されます。このフォルダーはデータベースのストラクチャーファイルと同階層に作成されます(Get 4D folderコマンドを参照) 。
Into 4D debug message	倍長整数	1	この値は4Dにmessageをシステムデバッギング環境へ送るよう指示します。結果はプラットホームにより異なります。 Mac OSでは、コマンドはメッセージをコンソールへ送ります。 Windowsでは、コマンドはメッセージをデバッグメッセージとして送ります。このメッセージを読むには、Microsoft Visual StudioまたはDebugViewユーティリティが必要です。 (http://technet.microsoft.com/en-us/sysinternals/bb896647.aspx)
Into 4D diagnostic log	倍長整数	5	ログファイルが有効である場合に、メッセージを4Dのログファイルに記録するよう指示します。ログファイルはSET DATABASE PARAMETERコマンド (セレクター79) を使用して有効にできます。
Into 4D request log	倍長整数	2	この値は4Dリクエストログがアクティブである場合、このファイルにmessageを記録するよう4Dに指示します。
Into Windows log events	倍長整数	0	この値は、4Dにmessage をWindowsの"Log events" へ送るよう指示します。このログは起動しているアプリケーションから送られるメッセージを受け取り保存します。この場合オプションのimportance引数を使用してmessageの重要度を設定できます (後述)。 Notes: この特性を利用するには、Windows Log Eventsサービスが起動していなければなりません。 Mac OSでは、コマンドはこの出力タイプでは何もしません。

outputType引数を渡さない場合、デフォルトでInto Windows Log Events (0) が使用されます。

引数outputTypeにInto Windows Log Eventsを指定すると、オプションの引数importanceを通してmessageに重要度を付けることができます。ログイベントを読んだり理解する助けになります。重要度には情報、警告とエラーの3つのレベルがあります。
4Dには、前もって定義された以下のような定数があります。これらはLog Eventsカテゴリーに置かれています。

定数	型	値
Error message	倍長整数	2
Information message	倍長整数	0
Warning message	倍長整数	1

importance に何も渡さなかったり、正しくない値を渡すと、デフォルト値(0) が使用されます。

例題

Windowsでデータベースが開かれた時の情報をログしたい場合は、以下のコードをOn Startupデータベースメソッド内に記述します。

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

データベースが開かれるたびに、重要度レベルが0として、この情報がWindowsログイベントに書き込まれます。