<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>CFWDDX</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">CFWDDX</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>
CFML データ構造体の、XML ベースの WDDX 形式へのシリアル化およびシリアル化解除を行います。WDDX とは、標準の汎用的な方法で複雑なデータ構造体を記述するための XML の言語の一部です。WDDX を実装すると、アプリケーションサーバープラットフォーム、アプリケーションサーバー、およびブラウザなどの情報に対して HTTP プロトコルを使用できるようになります。 
</p>

<p>
このタグでは、JavaScript ステートメントを生成して、WDDX パケットや CFML データ構造体の内容に相当する JavaScript オブジェクトのインスタンスを作成します。これには Unicode が使用されます。 
</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;cfwddx
   action = &quot;action&quot; 
   input = &quot;inputdata&quot; 
   output = &quot;result variable name&quot; 
   topLevelVariable = &quot;top-level variable name for JavaScript&quot;
   useTimeZoneInfo = &quot;yes&quot;、&quot;no&quot;
   validate = &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>
cfcollection、cfdump、cfexecute、cfindex、cfobject、cfreport、cfsearch、ToScript、『ColdFusion MX 開発ガイド』の第35章の「XML および WDDX の使用」 
</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
</p>
<ul>

<li>列名の大文字と小文字の区別の動作が変更されました。列名の大文字と小文字の区別が JavaScript 内で保持されます。以前のリリースでは、クエリー列の名前は小文字に変換されていました。 </li>

<li>エンコーディング形式のサポートが変更されました。このタグでは、複数のエンコード形式がサポートされます。デフォルトのエンコード形式は、UTF-8 です。このタグには、Unicode が使用されます。</li>
</ul>

<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>
列名の大文字と小文字の区別は JavaScript 内で保持されます。
</p>

<p>
RecordSet java オブジェクトが検出されると、wddx2js および cfml2js アクションによって、WddxRecordset javascript オブジェクトが作成されます。シリアル化された JavaScript コードには、ﾓwddx.jsﾓ ファイルが必要です。
</p>

<p>
このタグで実行できる変換は、次のとおりです。
</p>

<p>
</p><div align="left">
<table border="1">
  <caption></caption>
  <tr align="center">    <th><strong>変換前</strong></th>
    <th><strong>変換後</strong></th>
</tr>
  <tr align="left">    <td>
<p>CFML</p></td>
    <td>
<p>WDDX</p></td>
</tr>
  <tr align="left">    <td>
<p>CFML</p></td>
    <td>
<p>JavaScript</p></td>
</tr>
  <tr align="left">    <td>
<p>WDDX</p></td>
    <td>
<p>CFML</p></td>
</tr>
  <tr align="left">    <td>
<p>WDDX</p></td>
    <td>
<p>JavaScript</p></td>
</tr>
</table>
</div>
<p>
</p>

<p>
詳細、および XML ドキュメントオブジェクトと関数の管理に使用できる ColdFusion の配列関数と構造体関数のリストについては、『ColdFusion MX 開発ガイド』の第35章の「XML および WDDX の使用」 を参照してください。 
</p>
<table>
  <tr valign="top">
    <td width="30"><strong>メモ: </strong></td>
    <td>CFC またはユーザー定義関数 (UDF) をシリアル化しようとすると、cfwddx タグで例外が発生します。</td>
  </tr>
</table>    </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><pre>&lt;!--- この例では、cfwddx タグの基本的な使用方法を示します。 ---&gt;
&lt;html&gt;
&lt;body&gt;
&lt;!--- 簡単なクエリーを作成します。 ---&gt;
&lt;cfquery name = &quot;q&quot; dataSource = &quot;cfdocexamples&quot;&gt;
   select Message_Id, Thread_id, Username from messages
&lt;/cfquery&gt;

レコードセットデータ: ...&lt;p&gt;
&lt;cfoutput query = q&gt;
   #Message_ID# #Thread_ID# #Username#&lt;br&gt;
&lt;/cfoutput&gt;&lt;p&gt;

&lt;!--- データをシリアル化して WDDX 形式にします。 ---&gt;
CFML データのシリアル化...&lt;p&gt;
&lt;cfwddx action = &quot;cfml2wddx&quot; input = #q# output = &quot;wddxText&quot;&gt;

&lt;!--- WDDX XML パケットを表示します。 ---&gt;
最終的な WDDX パケット:
&lt;xmp&gt;&lt;cfoutput&gt;#wddxText#&lt;/cfoutput&gt;&lt;/xmp&gt;

&lt;!--- シリアル化を解除して、wddxResult という名前の変数に返します。 ---&gt;
WDDX パケットのシリアル化の解除...&lt;p&gt;
&lt;cfwddx action = &quot;wddx2cfml&quot; input = #wddxText# output = &quot;qnew&quot;&gt;

レコードセットデータ: ...&lt;p&gt;
&lt;cfoutput query = qnew&gt;
   #Message_ID# #Thread_ID# #Username#&lt;br&gt;
&lt;/cfoutput&gt;&lt;p&gt;
</pre>
         </td>
      </tr>
   </table>
   </div>
<div id="ACTION">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">ACTION</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">


<ul>

<li>cfml2wddx: CFML をシリアル化して WDDX にします。</li>

<li>wddx2cfml: WDDX のシリアル化を解除して、CFML にします。</li>

<li>cfml2js: CFML をシリアル化して JavaScript にします。</li>

<li>wddx2js: WDDX のシリアル化を解除して、JavaScript にします。</li>
</ul>


  </td>
  </tr>
  </table>
</div>
<div id="INPUT">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">INPUT</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="OUTPUT">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">OUTPUT</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">action = &quot;wddx2cfml&quot; の場合は必須</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>出力する変数の名前です。action = &quot;WDDX2JS&quot; または &quot;CFML2JS&quot; の場合、この属性を省略すると、結果は HTML ストリーム内に出力されます。 </p>

  </td>
  </tr>
  </table>
</div>
<div id="TOPLEVELVARIABLE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">TOPLEVELVARIABLE</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">action = &quot;wddx2js&quot; または &quot;cfml2js&quot; の場合は必須</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>シリアル化解除で作成したトップレベルの JavaScript オブジェクトの名前です。このオブジェクトは、WddxRecordset オブジェクトのインスタンスです。</p>

  </td>
  </tr>
  </table>
</div>
<div id="USETIMEZONEINFO">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">USETIMEZONEINFO</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"


<p>CFML を WDDX にシリアル化する場合に、タイムゾーン情報を出力するかどうかを示します。 </p><ul>

<li>Yes: 時 - 分オフセットが ISO8601 形式で出力されます。 </li>

<li>No: ローカルな時刻が出力されます。</li>
</ul>


  </td>
  </tr>
  </table>
</div>
<div id="VALIDATE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">VALIDATE</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> "No"


<p>action = &quot;wddx2cfml&quot; または &quot;wddx2js&quot; の場合に適用されます。 </p><ul>

<li>yes: WDDX DTD を使用して、WDDX 入力を XML パーサで検証します。パーサでエラーが発生することなく入力が処理されると、パケットのシリアル化は解除されます。そうでない場合は、エラーが発生します。 </li>

<li>no: 入力検証は行われません。</li>
</ul>


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

  </body>
</html>
