XSL Transform policy

What

The XSL Transform policy applies custom Extensible stylesheet language transformations (XSLT) to XML messages, letting you transform them from XML to another format, such as XML, HTML, or plain text. The policy is often used to integrate applications that support XML, but that require different XML-formats for the same data.

Where

This policy can be attached in the following locations, but see the notes following the table for specific guidance.

Element reference

Configure an XSL Transformation policy using the following elements.

<xsl:include> and <xsl:import> are not supported.

Field Name

Description

Name (Mandatory)

Name of the policy. Characters you can use in the name are restricted to: A-Z0-9._\-$ %. However, the Management UI enforces additional restrictions, such as automatically removing characters that are not alphanumeric.

Source (Optional)

Contains the message from which information needs to be extracted. Usually this value is set to request or response, depending on whether the message to be transformed is inbound or outbound.

If source is missing, it is treated as a simple message. For example, <Source>message</Source>

If the source variable cannot be resolved, or resolves to a non-message type, the transformation step fails.

OutputVariable (Optional)

A variable that stores the output of the transformation. The OutputVariable cannot be of Message type, that is, it cannot be 'message', 'request', or 'response'. You should set this element to be a custom variable, and then consume that variable.

To replace the message content with the output of the transformation, delete this element. For example, if you're transforming a message to HTML, don't include this element.

ResourceURL (Mandatory)

The XSLT file to be used for transforming the message.

Parameters (Optional)

ignoreUnresolvedVariables (Optional)

Ignores any unresolved variable errors in the XSLT script instructions.

Valid values: true/false

Default value: false

Parameter (Optional)

name (Mandatory)

Name of a custom parameter. Note that with name you can only use one of the optional parameters listed below.