XMLTRANSFORM |
説明 XSLT (Extensible Stylesheet Language Transformation) を XML に適用します。XML は、文字列形式ドキュメントの場合と XML ドキュメントオブジェクトの場合があります。
戻り値 XSLT を XML に適用した結果を含む文字列
カテゴリ 変換関数、XML 関数
関数のシンタックス
    XmlTransform(xml, xsl[, parameters])
関連項目 cfxml、XmlFormat、XmlNew、XmlParse、XmlSearch、XmlValidate、『ColdFusion MX 開発ガイド』の第35章の「XML および WDDX の使用」
ヒストリ ColdFusion MX 7: parameters パラメータが追加され、XSL のファイルを使用できるようになりました。 ColdFusion MX: この関数が追加されました。
パラメータ
使用方法 XSLT では、Extensible Stylesheet Language (XSL) スタイルシートを適用することにより、XML ドキュメントを別の形式や表現に変換します。XSLT シンタックスを含む XSL は、W3C (World Wide Web Consortium) によって仕様が定められています。XSL および XSLT の詳細については、W3C の Web サイト www.w3.org/Style/XSL/ を参照してください。 インクルードステートメントが相対パスと共に XSLT コードに含まれている場合、ColdFusion は XSLT ファイルの場所に相対してパスを解決します。XSL 文字列の場合は、現在の ColdFusion ページの場所に相対してパスを解決します。
例 次の例では、顧客注文を示す XML ドキュメントを、顧客名および注文品と数量の表を含む HTML ドキュメントに変換します。 顧客注文を示す "custorder.xml" ファイルには、次の行があります。
    <?xml version="1.0" encoding="UTF-8"?>
    <order id="4323251">
       <customer firstname="Philip" lastname="Cramer" accountNum="21"/>
       <items>
          <item id="43">
             <name>高級大工用ハンマー</name>
             <quantity>1</quantity>
             <unitprice>15.95</unitprice>
          </item>
          <item id="54">
             <name>36 インチのプラスチック製熊手</name>
             <quantity>2</quantity>
             <unitprice>6.95</unitprice>
          </item>
          <item id="68">
             <name>標準の塗料用シンナー</name>
             <quantity>3</quantity>
             <unitprice>8.95</unitprice>
          </item>
       </items>
    </order>
XML を HTML に変換して、顧客名および発注された商品と数量を表示する XSLT ファイル "custorder.xsd" には、次の行があります。
    <?xml version="1.0" ?>
    <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <xsl:output method="html" doctype-public="-//W3C//DTD HTML 4.0 Transitional//EN" />
       <xsl:template match="/">
          <html>
             <body>
                <table border="2" bgcolor="yellow">
                   <tr>
                      <th>名前</th>
                      <th>価格</th>
                   </tr>
                   <xsl:for-each select="breakfast_menu/food">
                      <tr>
                         <td>
                            <xsl:value-of select="name"/>
                         </td>
                         <td>
                            <xsl:value-of select="price"/>
                         </td>
                      </tr>
                   </xsl:for-each>
                </table>
             </body>
          </html>
       </xsl:template>
    </xsl:stylesheet>
この CFML ファイルには次の行が含まれています。
    <cffile action="read" file="C:CFusionMX7wwwrootexamplescustorder.xsl"
    variable="xmltrans">
    <cfset xmldoc = XmlParse("C:CFusionMX7wwwrootexamplescustorder.xml")>
    <cfoutput>#XmlTransform(xmldoc, xmltrans)#</cfoutput>

XML |
文字列形式または XML ドキュメントまたは XML ドキュメントオブジェクトです。

XSL |
適用する XSLT 変換であり、次のいずれかに相当します。
次のいずれかです。 XSL テキストを含む文字列 XSTLT ファイルの名前。現在の CFML ページを含むディレクトリで始まる相対パスです。 XSLT ファイルの URL。http、https、ftp、ファイルなど、有効なプロトコル識別子です。現在の CFML ページを含むディレクトリで始まる相対パスです。

ケラメータ |
ドキュメントの変換に使用する XSL テンプレートパラメータの名前/値のペアを含む構造 体です。xslString パラメータで定義される XSL 変換では、XML を処理するときにこれ らのパラメータ値を使用します。