LOG EVENT
LOG EVENT ( {outputType ;} message {; importance} )
| 引数 | 型 | 説明 | |
|---|---|---|---|
| outputType | Integer | → | メッセージの出力タイプ |
| message | Text | → | メッセージの内容 |
| importance | Integer | → | メッセージの重要度レベル |
説明
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 system standard outputs | 倍長整数 | 6 | この値は 4D に message を標準出力ストリームへ送るよう指示します。メッセージの送り先はimportanceの値により決まります: stdout : importance = Information message または Warning message の場合 stderr : importance = Error message の場合 |
| 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ログイベントに書き込まれます。