APIs Defined in ECX_STANDARD

perform_xslt_transformation

PL/SQL Syntax

procedure perform_xslt_transformation
(i_xml_file in out clob,
 i_xslt_file_name in varchar2,
 i_xslt_file_ver in number,
 i_xslt_application_code in varchar2,
 i_dtd_file_name in varchar2 default null,
 i_dtd_root_element in varchar2 default null,
 i_dtd_version in varchar2 default null,
 i_retcode out pls_integer,
 i_retmsg out varchar2);

Description

Used to apply a style sheet to an XML message and return the transformed XML messaged for further processing by the calling environment.

The DTD file name, version, and root element are required input parameters for this API, therefore the associated DTDs must be loaded into the XML Gateway repository. Refer to Loading and Deleting a DTD for details on loading a DTD.

This API is independent of the Message Designer: XSLT Transformation action. This API is not intended for use in a message map.

Note: The profile option ECX_XML_VALIDATE_FLAG must be set to"Y"for this action to be performed. For more information on this profile option, see Define System Profile Options.

Arguments (input)

i_xml_file The XML message to be transformed.
i_xslt_file_name The XSLT style sheet file to be used for the transformation.
i_xslt_file_ver The version of the XSLT style sheet file. The highest version with the same file name and application code is used if no version number is provided.
i_xslt_application_code The name of the subdirectory where the XSLT style sheet is source-controlled (for example: ar/xml/xslt).
i_dtd_file_name The name of the DTD used in the XML message.
i_dtd_root_element The root element of the DTD used in the XML message.
i_dtd_version Version of the DTD used in the XML message.

Arguments (output)

i_xml_file The transformed XML message.
i_retcode Return code for the procedure.
i_retmsg Return message for the procedure.