User Guide

XmlTransform 923

XmlTransform

Description

Applies an Extensible Stylesheet Language Transformation (XSLT) to XML. The XML can be in

string format or an XML document object.

Returns

A string containing the results of applying the XSLT to the XML.

See also

cfxml

, XmlFormat, XmlNew, XmlParse, XmlSearch, XmlValidate; Chapter 35, “Using XML and

WDDX” in ColdFusion MX Developer’s Guide

History

ColdFusion MX 7: Added the parameters parameter and the ability to use a file for the XSL.

ColdFusion MX: Added this function.

Parameters

Usage

An XSLT converts an XML document to another format or representation by applying an

Extensible Stylesheet Language (XSL) stylesheet to it. XSL, including XSLT syntax is specified by

the World Wide Web Consortium (W3C). For detailed information on XSL and XSLT, see the

W3C website at www.w3.org/Style/XSL/.

Parameter Description

xml An XML document in string format, or an XML document object

xsl XSLT transformation to apply; can be any of the following:

Any of the following:

• A string containing XSL text.

• The name of an XSTLT file. Relative paths start at the directory containing

the current CFML page.

• The URL of an XSLT file; valid protocol identifiers include http, https, ftp,

and file. Relative paths start at the directory containing the current CFML

page.

parameters A structure containing XSL template parameter name-value pairs to use in

transforming the document. The XSL transform defined in the

xslString

parameter uses these parameter values in processing the XML.