Task XML - Transform
The XML - Transform Task transforms the XML files that its File filter selects with an XSLT (Extensible Stylesheet Language Transformations) style sheet, and saves each result as a file. The result can be HTML, XML or text, as the output method of the style sheet sets. XSLT parameters can pass values, including Variables, to the style sheet at run time.
The Main settings, Flow, On error, Conditions and TimeOut tabs are the same for every Task; see Job - Tasks.
With the default Save to.. option Same folder but use file mask and the default File mask *, the result gets the name of the source file in the same folder, so it replaces the source file. Same file also replaces the source file. When the result replaces the source file and the transformation fails, the source file can be left empty or incomplete. To keep the source files, set a File mask such as *.html, or save to a different folder.
When the File filter finds no file, no error is raised, and the Task reports success. To have it fail the Task, select "All errors" on the On error tab; see Task - On Error.
Transform: File filter tab

The File filter selects the XML files to transform; see File Filter. The Credential of the File filter is used to read and save the files.
Transform: Destination tab

XML transform parameters
- XSLT file: The path and file name of the XSLT style sheet. Click the icon next to the field to browse for the file
- Enable document function: When selected, the style sheet can use the XSLT
document()function to read other XML documents. Cleared by default - Enable script: When selected, the style sheet can run embedded script blocks. Cleared by default. Select it only for style sheets you trust, because the script runs on the VisualCron Server
- Parse DTD: When selected, a DTD in the source document is processed and the document is validated against it. Cleared by default. A source document that contains a DTD can only be transformed with this option selected
XSLT parameters
Enter a Name and a Value in the empty row of the grid to add a parameter. The parameters are passed to the style sheet, which reads them with xsl:param. To delete a parameter, select its row and press the Delete key.
Save to..
- Same file: The result replaces the source file
- Same folder but use file mask: The default. The result is saved in the folder of the File filter, with the name that File mask gives
- Different folder and use file mask: The result is saved in Folder, with the name that File mask gives
- Folder: The destination folder. Available with Different folder and use file mask
- File mask: The name of the result file.
*keeps the name of the source file. Available with both file mask options
Variables can be used in XSLT file, the parameter names and values, Folder and File mask.
Output and errors
- The output of the Task contains the path of each saved file. When several files are transformed, the paths follow each other without a separator
- The files are transformed one by one. When a file cannot be transformed, the Task fails, and the remaining files are not transformed