Home > Contents > 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.Error Numbers
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 thestream
value, is a string. If theSTYLESHEET
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 > ![]()
Oracle XML Tag Reference
Copyright (c) 2013, 2015, Oracle and/or its affiliates. All rights reserved.