Transform XML

Transform XML is a synchronous activity that invokes the built-in XSLT processor to apply an XSLT stylesheet to an XML source document and produce a result document.

General

Normally, transformation of data occurs by mapping process variables to an activity's input and applying XPath expression to perform any transformation. If you have an XSLT file that you are using for transformation, or if an outside source supplies an XSLT file, this activity helps you to use the XSLT file instead of manually creating the mappings.

For more information about creating and editing XSLT files, see the XSLT specifications at http://www.w3.org/TR/xslt.

The General tab has the following fields.

Field Literal Value/Process Property/Module Property Description
Name No The name to be displayed as the label for the activity in the process.
Stylesheet Yes The XSLT file shared configuration resource to use when transforming the XML. You can also specify an XSLT stylesheet in the stylesheet input element, if desired. Stylesheets specified in the activity input override the stylesheet specified in this field.
Disable Pretty Print No Returns output data in the form of non formatted XML.

By default, the check box is clear.

Input and Output Style No Specifies whether the input and output is Text or Binary.

Description

Provide a short description for the activity.

Input

The following is the input for the activity.

Input Item Datatype Description
xmlString text or binary The XML to transform. If the Input and Output Style is set to binary, this element is named xmlBytesIn. If the Input and Output Style is set to text, this element is named xmlString.
styleSheet string This optional element contains the XSLT stylesheet to use to transform the XML input. This stylesheet overrides the stylesheet specified in the styleSheet field in the General tab.
parameter complex This repeating element contains the input parameters for the stylesheet.

Each input parameter is specified as name/value pairs. The name is a string that corresponds to the name of the parameter specified in the XSLT stylesheet parameter list.

name string The name of the stylesheet input parameters.
value string The value to supply for the specified stylesheet input parameters.
isXMLDocument boolean Specifies whether the parameter is an XML document.

Output

The following is the output for the activity.

Output Item Datatype Description
xmlString text or binary A binary or text value.

The element is named xmlString and is of type Text when you select Text for the Input and Output Style on the General tab. The element is named xmlOutput and is of type binary when you select Binary for the Input and Output Style on the General tab.

Fault

The Fault tab lists the possible exceptions generated by this activity. For more information about error codes and the corrective action to take, see the TIBCO ActiveMatrix BusinessWorks™ Error Codes guide.

Fault Generated When..
XMLTransformException An exception occurred when transforming the data.
UnsupportedEncodingException Data was supplied that is encoded in an unsupported encoding.
MissingByteCountException An exception occurred while transforming the data with an invalid or missing byte count.