Home >	Contents >	Index >
Template Tag TOC  |   Alpha TOC  |   Tag Family TOC  |   Purpose TOC  |   Annotated TOC  |   Index

XMLUTILS.TRANSFORMANDPRINT

Reads XML data from an input file according to specified parameters, transforms it using an XSLT style sheet, and prints the transformed XML.

Syntax

<XMLUTILS.TRANSFORMANDPRINT 
      INPUTVALTYPE="input_value_type"
      INPUTVAL="xml_content" 
      STYLESHEET="stylesheet_location" /> 

Parameters

INPUTVALTYPE (required)

Description of the XML data to be passed to the INPUTVAL parameter and transformed. Data can be referenced as an XML string only. Specify the following valid type:

• stream

Indicates that the input data is actual XML content in string format.

INPUTVAL (required)

Specifies input data, which must correspond to the specified INPUTVALTYPE. Input data, which takes the following form:

• XML string

STYLESHEET (required for explicit style sheets)

Use this parameter to specify a style sheet that is external to the input XML. As a value, enter a URI that represents the style sheet. A URI is a string that conforms to URI syntax.

Note that this parameter does not apply to implicit style sheets, which are included in the input XML. When the STYLESHEET parameter is omitted, the style sheet is assumed to be included in the input XML by default.

Description

The XMLUTILS.TRANSFORMANDPRINT tag reads XML data according to the specified type of XML (string), transforms it using an XSLT style sheet, and prints the output.

During transformation, the input XML is also checked and validated against referenced DTDs, if any. The style sheet specified for the transformation can be implicit (included in the XML file) or explicit (included as a separate file). The parameters you specify determine how the input data is read. If the style sheet is included in a separate file, you must set the STYLESHEET parameter. If the style sheet is included in the XML file, the tag reads the style sheet from the input XML.

The output of the XMLUTILS.TRANSFORMANDPRINT tag can be directly viewed within the calling page.

errno

The possible values of errno include:

Value	Description
0	Success. The XML input was successfully transformed and returned for viewing in the calling page.
-100	General exception failure.

Example

Input XML file is a string, and an explicit style sheet is applied:

<XMLUTILS.TRANSFORMANDPRINT INPUTVALTYPE="stream" INPUTVAL="<?xml version . . . > . . . " STYLESHEET="file:///location/filename.xsl"/> 

This example accepts the input XML file in the form of a string. Note that the transformation is done using a separate style sheet, specified with the STYLESHEET parameter. The output, specified by the stream value, is a string. If the STYLESHEET parameter is omitted then the style sheet is assumed to be implicit and is read from the XML file by default. The output is returned so that it can be viewed in the calling XML.

		Home >	Contents >	Index >
	FatWire XML Tag Reference Copyright 2005 by FatWire Software All rights reserved.