Transform XML Action

Declaration

<AMXMLTRANSFORM XSLTFILE="text" HTMLFILE="text" OVERWRITEFILE="text [options]"><Parameter Name="text" Value="text" /></AMXMLTRANSFORM>

See Also

Sign XML File Action

Description

Transforms the XML file into HTML file using an XSLT file. You can also provide the XSLT parameter which will be replaced by its value dynamically.

Practical Usage

See description.

Parameters

General Tab

XSLT File

Text, Required
MARKUP: XSLTFILE="C:\Log\Auto.xsl"

Allows you to specify the location of XSLT file on your local system.

HTML File

Text, Required
MARKUP: HTMLFILE="C:\Log\Output.html"

Allows you to specify the location on your local system where you want to store the HTML file.

Overwrite if File Exists

Text [options], Optional - Default "No"
MARKUP: OVERWRITEFILE="YES"

If set to Yes, specifies that if the file already exists, it will be overwritten with the new document. If set to No, the step fails if the file already exists.

Session Name

Text, Optional - Default "XMLSession1"
MARKUP: SESSIONNAME="FirstXMLSession"

Specifies the session name to run the XML file in subsequent XML steps. This allows several connections to be active simultaneously.

XSLT Parameter Tab (optional)

If the XSLT file has parameters that can be dynamically replaced in the HTML file during transformation, you can specify them using this Tab.

It also adds a new node Parameter into AML Code. e.g. (<Parameter Name="Make" Value="BMW" />).

Parameter Name

Text, Optional
MARKUP: Name="Make"

Specifies the XSLT parameter name.

Parameter Value

Text, Optional
MARKUP: Value="BMW

Specifies the XSLT parameter value.

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMXMLTRANSFORM XSLTFILE="C:\Cars.xsl" HTMLFILE="C:\CarOutput.html" OVERWRITEFILE="YES" SESSIONNAME="XML1" />