Write-Log
説明
実行するコンテキストに関連付けられたログにメッセージを書き込みます。たとえば、Webject が Info*Engine のタスクプロセッサ内で実行するタスクから呼び出される場合、メッセージはタスクプロセッサのログに書き込まれます。JSP ページから Webject が呼び出される場合は、JSP プロセッサログに書き込まれます。
|
|
Info*Engine タスクを作成するとき、Logging タグライブラリを使用してログステートメントを log4j に発行することをお勧めします。
|
構文
<ie:webject name="Write-Log" type="MGT">
<ie:param name="GROUP_IN" data="input_group"/>
<ie:param name="LOG" data="[DEBUG | INFO | ERROR | AUDIT |
TRANSACTION | STAT]"/>
<ie:param name="MESSAGE" data="message_text"/>
<ie:param name="TAG" data="author_supplied_tag"/>
</ie:webject>
パラメータ
|
必須
|
選択
|
オプション
|
|
|
GROUP_IN
|
|
|
LOG
|
|
|
MESSAGE
|
|
|
TAG
|
GROUP_IN
ログに使用する入力グループの名前を指定します。この入力グループは、XML としてレンダリングされ、LOG パラメータで指定されたログファイルに書き込まれます。このパラメータには複数の値を指定できます。すべての入力グループは、MESSAGE パラメータで指定された値の後にログが書き込まれます。
LOG
メッセージを書き込む必要があるログを指定します。このパラメータの有効な値は、DEBUG、INFO、ERROR、AUDIT、TRANSACTION、および STAT です。このパラメータのデフォルトは INFO です。このパラメータはオプションです。
MESSAGE
ログに書き込むメッセージの主要なテキストを指定します。
書き込まれる各ログメッセージのフォーマットは、
date-time#:#host#:#service#:#tag#:#user#:#messagevalue
です。
ここで、
date-time - メッセージが書き込まれた日付と時刻
host - メッセージが書き込まれたホストのインターネットドメイン名
service - メッセージを書き込んだ Info*Engine サービスの名前
tag - TAG パラメータによって指定される値
user - メッセージが書き込まれたときにサービスが動作していたユーザーの認証済みのユーザー名
messagevalue - MESSAGE パラメータによって指定される値
デフォルトは、空のメッセージ値を持つログメッセージの書き込みです。このパラメータはオプションです。
TAG
ログのサーチと並べ替えを容易にするために、ログエントリの一部として書き込まれるタグを指定します。TAG パラメータを使用すると、タスク著作者があるログメッセージをほかと区別するときに使用できる簡単な識別子を指定できます。たとえば、トラブルシューティングや、サイト定義した方法でメッセージを分類するために、特定のタグを使用できます。
このパラメータのデフォルトでは、Webject が呼び出されるタスクの名前を使用します。このパラメータはオプションです。
例
以下の Write-Log の例は、グループを作成し、メッセージを 2 つの異なるログに書き込んでから、出力を表示します。
<%@page language="java"
session="false"
errorPage="../IEError.jsp"%>
<%@ taglib uri="http://www.ptc.com/infoengine/taglib/core" prefix="ie" %>
<html>
<head>
<title>Write-Log Webject</title>
</head>
<body>
<!-- create a group -->
<ie:task uri="com/company/CreateGroup.xml"/>
<!-- Write a log message to the default log, "info" -->
<ie:webject name="Write-Log" type="MGT">
<ie:param name="TAG" data="-----Write-Log-----"/>
<ie:param name="MESSAGE" data="----Info log message----"/>
</ie:webject>
<!-- Write a log message to the "debug" log -->
<ie:webject name="Write-Log" type="MGT">
<ie:param name="TAG" data="-----Write-Log-----"/>
<ie:param name="MESSAGE"
data="----Debug log message----"/>
<ie:param name="LOG" data="DEBUG"/>
</ie:webject>
<!-- generate the output -->
<ie:webject name="Display-Table" type="DSP"/>
</body>
</html>
