<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link href="mmres://user_interface_reference.css" rel="stylesheet" type="text/css">
<title>CFLOG</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
   <div id="説明">
   <table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
      <tr> 
         <td valign="top" class="name">CFLOG</td>
         <td valign="top" nowrap class="compatibility">&nbsp;</td>
      </tr>
      <tr>
         <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
      </tr>


    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">説明</span>
<p>
メッセージをログファイルに書き込みます。
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">カテゴリ</span>
<p>
データ出力タグ
</p>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="syntax"><span class="title">シンタックス</span><pre>&lt;cflog
   text = &quot;text&quot;
   log = &quot;log type&quot;
   file = &quot;filename&quot;
   type = &quot;message type&quot;
   application = &quot;yes&quot;、&quot;no&quot;&gt;
</pre>    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">関連項目</span>
<p>
cfcol、cfcontent、cfoutput、cftable
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">ヒストリ</span>
<p>
ColdFusion&#160;MX: thread、date、および time 属性は使用禁止になりました。これらの属性は今後のリリースでは機能せず、エラーが発生する可能性があります。以前のリリースでは、これらの属性によって、それぞれのデータ項目がログに出力されるかどうかが決まっていました。ColdFusion&#160;MX では、常にこのデータが出力されます。 
</p>

<p>

</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">使用方法</span>
<p>
cflog タグでは、カスタムメッセージを標準ログファイルまたはカスタムログファイルにロギングします。ログメッセージ用のファイルを指定することも、デフォルトのアプリケーションログやスケジューラログにメッセージを送信することもできます。ログメッセージには ColdFusion の式を含めることができます。ログファイルは拡張子 &quot;.log&quot; を持ち、ColdFusion のログディレクトリに格納される必要があります。 
</p>

<p>
ログエントリは、次のフィールドから成るカンマ区切りリストとして記述されます。
</p>
<ul>

<li>type</li>

<li>coio</li>

<li>date</li>

<li>time</li>

<li>application</li>

<li>text</li>
</ul>

<p>
値は二重引用符 (&quot;) で囲まれます。application 属性に no を指定すると、リスト内の対応するエントリは空になります。
</p>

<p>
cflog タグの実行を無効にすることができます。詳細については、ColdFusion Administrator の [基本セキュリティ] ページを参照してください。 
</p>

<p>
次の例では、アプリケーションにログオンするユーザーの名前をロギングします。このメッセージは ColdFusion ログディレクトリの &quot;myAppLog.log&quot; ファイルにロギングされます。このログには、日付、時刻、およびスレッド ID が含まれますが、アプリケーション名は含まれません。 
</p>
<pre>&lt;cflog file=&quot;myAppLog&quot; application=&quot;no&quot;
   text=&quot;User #Form.username# logged on.&quot;&gt;
</pre>
<p>
たとえば、ユーザーがフォームのユーザー名フィールドに「Sang Thornfield」と入力した場合は、次のエントリが &quot;myApplog.log&quot; ファイルエントリに追加されます。
</p>

<p>
&quot;Information&quot;,&quot;153&quot;,&quot;02/28/01&quot;,&quot;14:53:40&quot;,,&quot;User Sang Thornfield logged on.&quot; 
</p>

         </td>
      </tr>
   </table>
   </div>
<div id="TEXT">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">TEXT</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">必須</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>ロギングするメッセージテキストです。 </p>

  </td>
  </tr>
  </table>
</div>
<div id="LOG">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">LOG</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>file 属性を省略した場合は、メッセージは標準ログファイルに書き込まれます。file 属性を指定した場合は、この属性が無視されます。 </p><ul>

<li>Application: Application.log に記録します。通常は、アプリケーション固有のメッセージに対して使用されます。</li>

<li>Scheduler: Scheduler.log に記録します。通常は、スケジューリングされたタスクの実行をロギングするときに使用されます。</li>
</ul>


  </td>
  </tr>
  </table>
</div>
<div id="FILE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">FILE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>メッセージファイルです。ファイル名の拡張子以外の部分だけを指定します。たとえば、&quot;Testing.log&quot; ファイルにロギングするときは、&quot;Testing&quot; と指定します。 </p>
<p>このファイルは、デフォルトのログディレクトリに格納されます。ディレクトリパスは指定できません。指定したファイルが存在しない場合は、自動的にそのファイルが作成されて .log という接尾辞が付けられます。</p>

  </td>
  </tr>
  </table>
</div>
<div id="TYPE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">TYPE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "Information"


<p>メッセージのタイプ (厳格度) です。 </p><ul>

<li>Information</li>

<li>Warning</li>

<li>Error </li>

<li>Fatal</li>
</ul>


  </td>
  </tr>
  </table>
</div>
<div id="APPLICATION">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">APPLICATION</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "yes"

<ul>

<li>yes: cfapplication タグまたは &quot;Application.cfc&quot; ファイルでアプリケーション名が指定されている場合は、アプリケーション名を記録します。</li>

<li>no</li>
</ul>


  </td>
  </tr>
  </table>
</div>

  </body>
</html>
