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



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



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:

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

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 implicit by default.

Specification for the XML format that the output (transformed data) takes. Data can be returned as either an XML DOM or XML string. Depending on the XML format you want as output from your style sheet, specify either of the following valid types:

OUTPUTVAL (required)
Name of the variable that contains the resulting transformed output.


The XMLUTILS.TRANSFORM tag reads XML data according to specified type of XML (string), transforms it using an XSLT style sheet, and returns the transformed XML. 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 and how the output is returned. 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.TRANSFORM tag is a variable.

Error Numbers

The possible values of errno include:

Success. The XML input was successfully transformed.
General exception failure.


The following examples demonstrate syntax and parameters when the input file is is an XML string.

Input XML file is a string, an explicit style sheet is applied, and the output is specified as an XML string:

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.

  Home > Contents > Index >

Oracle XML Tag Reference
Copyright (c) 2013, 2019, Oracle and/or its affiliates. All rights reserved.